Taxicode API

Welcome to the Taxicode API

The Taxicode API is a collction of HTTP interfaces to Taxicode services we are opening up to the wider developer platform so that other business can benefit from our vast national taxi company directory and pricing engine.

The main elements of our API are the ability to get quotes, book journeys and perform actions related to the booking made by your application or by authenticated Taxicode users.

Our API is in active developement so if you have any problems or want to suggest a new feature we're always willing to discus with you the options and we'll always endevour to meet your needs if possible. If you wish to contact us, Click Here.

By using the Taxicode API, you are agreeing to the Terms and Conditions.

Overview

This section will provide a brief overview of our API and how it works.

Global Parameters

Any API call can specify the following parameters:

Parameter	Type	Description	Value	Default
`format` optional	`GET`	The format parameter specifies the format that the data response will be sent back in.	`json`, `xml`, `pre`, `vardump` or `serialized`	`json`
`callback` optional	`GET`	If you are requesting `json` as the data type and wish the data to be sent as jsonp, please specify a callback function and we will wrap the json in that function.	String	-
`encrypted` optional	`GET`	An encrypted JSON string containing data you wish to send to us as `POST` data. It will be treated as POST data once decrypted on our server. Data should be encrypted using RSA encryption with the public key you can obtain with the Auth API.	String	-
`key` required	`GET/POST`	Your API key. This is used to verify the source of the API call. All API calls require the API key and some have additional functionality when it it provided. The max length of this should be 32 characters. Please contact us if you need to discuss this.	String	-
`sub_affiliate` optional	`GET/POST`	A sub affiliate ID that you provide to your customers if you are repackaging our API to your affiliates.	String	-

Auth API

The Auth API is used to retrieve a public key that can be used to encrypt post data to other API services.

It's primary use is to send encrypted data that you'd normally be able to send via a POST request to our server, but can't because of a limitation on sending POST data such as using jsonp. Once a public key is required you will need to have the ability to do RSA encryption using your public key.

Here are some libraries we're aware of. If you know of any others for different languages please let us know.

Language	Library / Function
PHP	openssl_public_encrypt
JavaScript	https://github.com/ziyan/javascript-rsa

The next step is to convert the data you wish to POST to us via jsonp. Convert the object/array to a json string. Run your encrypt function on the json string. Send a GET variable to the API call you are making with the parameter encrypted=YOUR_ENCRYPTED_JSON_STRING. Our server will decrypt the string with our private key and then treat the json object as POST data.

Request

https://api.taxicode.com/auth/

Example Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"public_key":"-----BEGIN PUBLIC KEY-----\nMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+RqNh\\\/5Zde9mRAGw2Yse\nbvIhvLI\\\/5YFsuTcRdVkaXNFBz15tFLSCNY6ZZ94QoxLUjpfnHzYB4PPVSrQ0DGBq\nqGSfAjQzteljurEZIVHq2EoOoEZFOoieegdYzO07gvxBbew5GtCiR5d3k+Kn6KyV\nEcwknQsDf2VSKZ0zI+oqCQly0ERWcJCIXvcHois9uCtF0CbF3z4\\\/frKoNQIUZuZo\nVmzTjW6UqvMYCFGH4hSGvJ\\\/SdO+3fSCggYQnjD89URe3plLswkllqDjlMl8FBlk2\nRmXoEfdrwekUHHvrMdcHFMtFV9Y355Ky8wbQCXvQT2LJKJr9Xe0L5vt\\\/F\\\/XKAKHF\nrOF5Eazt3ORsd2MNrKzmG6u56Ax+y7hVXZrOM9nST+eMsb+A5rV4Z1sQLmADfX4q\nwoLRwANneh7CRIiJ3NokSfxNIa0T6UskuGiO8qBbX4sMlV5NUIHupfnpwC3Z2YKj\ncuDOkt3ezGq\\\/tf2pNzi86tBMLVjU4pGhKKZidvNLnoLbYZNpyHUiFn7e74AIl7jx\nBS2na8NW2mMP3d2PlVc47tOaGdSW+o0gjnA1jpF3J4tybvi49mN4Muc5yvM75WHX\nLenT6MxeNPG58+VstOv7Lt5+aez6cCogqi4Wh8o5PpQWkUJyn1VhoeM7BxMkOs\\\/h\n+gBW+G\\\/9D0vRRfJdw7OfLLcCAwEAAQ==\n-----END PUBLIC KEY-----\n"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<public_key>-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+RqNh\/5Zde9mRAGw2Yse
bvIhvLI\/5YFsuTcRdVkaXNFBz15tFLSCNY6ZZ94QoxLUjpfnHzYB4PPVSrQ0DGBq
qGSfAjQzteljurEZIVHq2EoOoEZFOoieegdYzO07gvxBbew5GtCiR5d3k+Kn6KyV
EcwknQsDf2VSKZ0zI+oqCQly0ERWcJCIXvcHois9uCtF0CbF3z4\/frKoNQIUZuZo
VmzTjW6UqvMYCFGH4hSGvJ\/SdO+3fSCggYQnjD89URe3plLswkllqDjlMl8FBlk2
RmXoEfdrwekUHHvrMdcHFMtFV9Y355Ky8wbQCXvQT2LJKJr9Xe0L5vt\/F\/XKAKHF
rOF5Eazt3ORsd2MNrKzmG6u56Ax+y7hVXZrOM9nST+eMsb+A5rV4Z1sQLmADfX4q
woLRwANneh7CRIiJ3NokSfxNIa0T6UskuGiO8qBbX4sMlV5NUIHupfnpwC3Z2YKj
cuDOkt3ezGq\/tf2pNzi86tBMLVjU4pGhKKZidvNLnoLbYZNpyHUiFn7e74AIl7jx
BS2na8NW2mMP3d2PlVc47tOaGdSW+o0gjnA1jpF3J4tybvi49mN4Muc5yvM75WHX
LenT6MxeNPG58+VstOv7Lt5+aez6cCogqi4Wh8o5PpQWkUJyn1VhoeM7BxMkOs\/h
+gBW+G\/9D0vRRfJdw7OfLLcCAwEAAQ==
-----END PUBLIC KEY-----
</public_key>
</TaxicodeResponse>

Array
(
    [status] => OK
    [public_key] => -----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+RqNh\/5Zde9mRAGw2Yse
bvIhvLI\/5YFsuTcRdVkaXNFBz15tFLSCNY6ZZ94QoxLUjpfnHzYB4PPVSrQ0DGBq
qGSfAjQzteljurEZIVHq2EoOoEZFOoieegdYzO07gvxBbew5GtCiR5d3k+Kn6KyV
EcwknQsDf2VSKZ0zI+oqCQly0ERWcJCIXvcHois9uCtF0CbF3z4\/frKoNQIUZuZo
VmzTjW6UqvMYCFGH4hSGvJ\/SdO+3fSCggYQnjD89URe3plLswkllqDjlMl8FBlk2
RmXoEfdrwekUHHvrMdcHFMtFV9Y355Ky8wbQCXvQT2LJKJr9Xe0L5vt\/F\/XKAKHF
rOF5Eazt3ORsd2MNrKzmG6u56Ax+y7hVXZrOM9nST+eMsb+A5rV4Z1sQLmADfX4q
woLRwANneh7CRIiJ3NokSfxNIa0T6UskuGiO8qBbX4sMlV5NUIHupfnpwC3Z2YKj
cuDOkt3ezGq\/tf2pNzi86tBMLVjU4pGhKKZidvNLnoLbYZNpyHUiFn7e74AIl7jx
BS2na8NW2mMP3d2PlVc47tOaGdSW+o0gjnA1jpF3J4tybvi49mN4Muc5yvM75WHX
LenT6MxeNPG58+VstOv7Lt5+aez6cCogqi4Wh8o5PpQWkUJyn1VhoeM7BxMkOs\/h
+gBW+G\/9D0vRRfJdw7OfLLcCAwEAAQ==
-----END PUBLIC KEY-----

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["public_key"]=>
  string(809) "-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+RqNh\/5Zde9mRAGw2Yse
bvIhvLI\/5YFsuTcRdVkaXNFBz15tFLSCNY6ZZ94QoxLUjpfnHzYB4PPVSrQ0DGBq
qGSfAjQzteljurEZIVHq2EoOoEZFOoieegdYzO07gvxBbew5GtCiR5d3k+Kn6KyV
EcwknQsDf2VSKZ0zI+oqCQly0ERWcJCIXvcHois9uCtF0CbF3z4\/frKoNQIUZuZo
VmzTjW6UqvMYCFGH4hSGvJ\/SdO+3fSCggYQnjD89URe3plLswkllqDjlMl8FBlk2
RmXoEfdrwekUHHvrMdcHFMtFV9Y355Ky8wbQCXvQT2LJKJr9Xe0L5vt\/F\/XKAKHF
rOF5Eazt3ORsd2MNrKzmG6u56Ax+y7hVXZrOM9nST+eMsb+A5rV4Z1sQLmADfX4q
woLRwANneh7CRIiJ3NokSfxNIa0T6UskuGiO8qBbX4sMlV5NUIHupfnpwC3Z2YKj
cuDOkt3ezGq\/tf2pNzi86tBMLVjU4pGhKKZidvNLnoLbYZNpyHUiFn7e74AIl7jx
BS2na8NW2mMP3d2PlVc47tOaGdSW+o0gjnA1jpF3J4tybvi49mN4Muc5yvM75WHX
LenT6MxeNPG58+VstOv7Lt5+aez6cCogqi4Wh8o5PpQWkUJyn1VhoeM7BxMkOs\/h
+gBW+G\/9D0vRRfJdw7OfLLcCAwEAAQ==
-----END PUBLIC KEY-----
"
}

a:2:{s:6:"status";s:2:"OK";s:10:"public_key";s:809:"-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA+RqNh\/5Zde9mRAGw2Yse
bvIhvLI\/5YFsuTcRdVkaXNFBz15tFLSCNY6ZZ94QoxLUjpfnHzYB4PPVSrQ0DGBq
qGSfAjQzteljurEZIVHq2EoOoEZFOoieegdYzO07gvxBbew5GtCiR5d3k+Kn6KyV
EcwknQsDf2VSKZ0zI+oqCQly0ERWcJCIXvcHois9uCtF0CbF3z4\/frKoNQIUZuZo
VmzTjW6UqvMYCFGH4hSGvJ\/SdO+3fSCggYQnjD89URe3plLswkllqDjlMl8FBlk2
RmXoEfdrwekUHHvrMdcHFMtFV9Y355Ky8wbQCXvQT2LJKJr9Xe0L5vt\/F\/XKAKHF
rOF5Eazt3ORsd2MNrKzmG6u56Ax+y7hVXZrOM9nST+eMsb+A5rV4Z1sQLmADfX4q
woLRwANneh7CRIiJ3NokSfxNIa0T6UskuGiO8qBbX4sMlV5NUIHupfnpwC3Z2YKj
cuDOkt3ezGq\/tf2pNzi86tBMLVjU4pGhKKZidvNLnoLbYZNpyHUiFn7e74AIl7jx
BS2na8NW2mMP3d2PlVc47tOaGdSW+o0gjnA1jpF3J4tybvi49mN4Muc5yvM75WHX
LenT6MxeNPG58+VstOv7Lt5+aez6cCogqi4Wh8o5PpQWkUJyn1VhoeM7BxMkOs\/h
+gBW+G\/9D0vRRfJdw7OfLLcCAwEAAQ==
-----END PUBLIC KEY-----
";}

Booking API

The Booking API allows you to request a quote for a journey and then pay for that journey.

Booking Quote

Quote Request

https://api.taxicode.com/booking/quote/

Parameter	Type	Description	Values	Default
`pickup`	`GET/POST`	The pickup location. An address string that can be identified by Google Places API. Taxicode API also accepts the use of latitude and longitude as a value but should only be used as a fallback in the case the pickup address string fails to return results. Latitude and longitude need to be separated by a comma.	String	-
`vias` optional	`GET/POST`	The vias location. An address string that can be identified by Google Places API. Taxicode API also accepts the use of latitude and longitude as a value but should only be used as a fallback in the case the vias address string fails to return results. Latitude and longitude need to be separated by a comma.	String	-
`destination`	`GET/POST`	The destination location. An address string that can be identified by Google Places API. Taxicode API also accepts the use of latitude and longitude as a value but should only be used as a fallback in the case the destination address string fails to return results. Latitude and longitude need to be separated by a comma.	String	-
`date`	`GET/POST`	The date and time of the journey as a UNIX timestamp.	UNIX Timestamp	-
`return` optional	`GET/POST`	The date and time of the return journey as a UNIX timestamp. False if no return journey. If `quote_type` is set as `hourly`, `return` parameter should be omitted from the request.	UNIX Timestamp	`false`
`people` optional	`GET/POST`	The number of people the journey is being booked for.	Integer (1-30)	`1`
`key` required	`GET/POST`	Your API key. This is used to apply any uplift you have attached to your API account.	String	-
`quote_type` optional	`GET/POST`	The type of quote you are requesting. It can be either `mileage` or `hourly`. The default value is `mileage`. If you set it to `hourly`, you also have to set a value for the `hours` parameter in your request.	String	`mileage`
`split` optional	`GET/POST`	Should companies be split into multiple results for different vehicle types. Vehicle types are standard, executive and minibuses.	Boolean	`false`
`hours` optional	`GET/POST`	The number of hours you want to book the service for. In order to get hourly rates, `quote_type` parameter needs to be set in your request as `hourly`.	Integer (1-24)	-
`other_rates` optional	`GET/POST`	Other rates from other services to include as a comma separated list. Example: `other_rates=blackcab,uber` Currently we only support `blackcab` and `uber`, but we will look to add more in the future. They will only be returned if they apply. In the case of Uber and Black Cabs, this means they only apply for journeys that take place in London.	String	`false`
`company` optional	`GET/POST`	This will limit results to only show results for a certain company ID. This will return a price for this company even if they wouldn't normally do this job so be careful when using this as jobs that aren't near the company specified are likely to be cancelled. To make sure one result is returned please also use `split=0`. This specifies that we're not splitting the price into different vehicle types.	Integer	`null`
`instances` optional	`GET/POST`	This will limit results to only show results for a certain instance IDs. This will return a price for this instance even if they wouldn't normally do this job so be careful when using this as jobs that aren't near the instance specified are likely to be cancelled. Results from the same company (that has multiple instances) will only show the best price for that company. Please be aware of the use of the `split` parameter.	String	Comma separated list of instances IDs to get a price from.
`ratings` optional	`GET/POST`	Include company rating details with the quotes. Turn off to improve response time.	String	`on`

Quote Response

Once you've made your request you will recieve back two objects:

A Journey object which confirms the details that were entered in the request.

A quotes object that contains quotes containing information about the company, price and different options availale. The quotes object is keyed with quote IDs which will be stored by our servers for 24-48 hours before being deleted. You will use this quote ID if you wish to book the quoted journey.

The Response

status OK Everything is okay.

WARNING If quotes can be returned but they can't be booked.

ERROR If there was an error and no quotes returned.

warning String If status is WARNING this will contain the warning message.

error String If status is ERROR this will contain the error message.

journey_id String The ID of the journey. Can be used to look up journey after it's been booked (stored for 1 month after booking made). This is mainly used to with the booking/journey API function to refill a users form if you don't have it stored.

payment_url

String

The URL to send the user to if you are not handling the payment yourself. This url needs the quote being booked appened to it followed by any other variable.

Example: https://secure.taxicode.com/api/QUOTE_ID/?callback=http://www.example.com&v=1&key=YOUR_API_KEY

Payment URL Vars

callback
optional String An URL we send the customer back to. We will add ?edit=JOURNEY_ID or ?success=BOOKING_REF once the customer completes. It's possible for a customer to abandon the process at this point so we won't always return to your domain.

key
required String Your public API key, to identify you.

v
optional Integer The ID of the vehicle the user wants to book with. IDs are the array index from the vehicles returns by booking/quote

mag
optional 1 or 0 If the quote had an optional meet and greet, setting mag=1 sets the customer as having elected for the meet and greet service.

onbehalf
optional 1 or 0 If the is set onbehalf=1, the page auto selects that the booking is being made on behalf of someone else. This would be used for example by a application targetting travel agents who are booking on behalf of there customers.

currency
optional

String

The 3 letter currency code (ISO 4217) that will be displayed underneight the GBP price. The price is an approximation of the GBP price based and customers will still be charged in GBP. We currently only support the following currencies. If you'd like us to add more currencies please contact us.

Currencies
`AUD`	Australian Dollar	$
`BRL`	Brazilian Real	R$
`CAD`	Canadian Dollar	$
`CHF`	Swiss Franc	Fr
`CLP`	Chilean Peso	$
`CNY`	Chinese Yuan Renmin	¥
`CZK`	Czech Koruna	Kč
`DKK`	Danish Krone	kr
`EUR`	Euro	€
`FJD`	Fiji Dollar	$
`GBP`	Pound Sterling	£
`HKD`	Hong Kong Dollar	$
`HNL`	Honduran Lempira	L
`HUF`	Hungarian Forint	Ft
`IDR`	Indonesian Rupiah	Rp
`ILS`	Israeli New Shekel	₪
`INR`	Indian Rupee	₹
`ISK`	Iceland Krona	kr
`JPY`	Japanese Yen	¥
`KRW`	Korean Won	₩
`MXN`	Mexican Peso	$
`MYR`	Malaysian Ringgit	RM
`NGN`	Nigerian Naira	₦
`NOK`	Norwegian Krone	kr
`NZD`	New Zealand Dollar	$
`PHP`	Philippine Peso	₱
`PKR`	Pakistan Rupee	₨
`PLN`	Polish Zloty	zł
`RUB`	Russian Ruble	₽
`SEK`	Swedish Kroná	kr
`SGD`	Singapore Dollar	$
`THB`	Thai Baht	฿
`TRY`	Turkish Lira	₺
`TWD`	Taiwan Dollar	$
`USD`	US Dollar	$
`ZAR`	South African Rand	R

test
optional 1 or 0 Whether this is a test booking or not. test=1 means the booking will not be sent to the actual company and will be stored on a special testing company once it's been paid for. test=0 or not setting it processes the booking a live booking that goes to a taxi company. When setting test=1 the payment uses SagePay's testing servers so you may enter any test card details for sagepay.

journey

Object

Journey Object

pickup

Object

Location Object
`position`	Array	An array with the latitude and longitude.
`postcode`	String	Any matched postcode.
`string`	String	The location as a string.

vias

Object

Location Object
`position`	Array	An array with the latitude and longitude.
`postcode`	String	Any matched postcode.
`string`	String	The location as a string.

false No via points.

destination

Object

Location Object
`position`	Array	An array with the latitude and longitude.
`postcode`	String	Any matched postcode.
`string`	String	The location as a string.

date UNIX Timestamp The date and time of the journey.

return UNIX Timestamp The date and time of the return journey.

false No return journey

people Integer (1-30) The number of passengers.

distance Integer The estimated number miles the journey will be.

duration Integer The estimated number of seconds the journey should take.

duration_text String Human readable version of the duration.

quote_type String Either hourly or mileage.

quotes false No quotes found

Object

Object containing Quote IDs as the keys and Quote Objects as values.

Example Quote Object

active Boolean Whether the company is an active result. Companies are inactive if they need more booking notice.

notification Integer The number of hours notice this company needs.

cutoff String The date/time that the quote is able to be booked until. Due to the notice period companies need to accept the booking. (Format YYYY-MM-DD HH:MM:SS)

class String The class of vehicles by the company standard, executive or minibuses.

highlight String If the company has a the best price, most reliable or any other notable result, we specify that here.

company_name String The ID of the company.

company_id Integer The ID of the company in our system.

instance_id Integer The ID of the instance, companies can have multiple instances.

company_location String The location the company is based on (some companies are based in multiple branches, this returns the location of the branch that produced the quoted price)

company_phone Float The phone number of the company.

false If the company doesn't have a phone number listed.

price Float The standard price of the journey in GBP.

payment_options Array List of payment options. Example ["CARD", "BALANCE", "CASH"]. For options other than card, the customer needs to be logged in.

performance Float The score out of 10 that the company scores for performance. If a company falls below 8 they won't be displayed unless there are no other companies available.

meetandgreet

Object

Meet And Greet Object
`location`	String	The name of the location the meet and greet will be at.
`price`	Float	The additional price of the meet and greet option.
`waiting_time`	String	The number of minutes waiting time included.
`waiting_time_extra`	String	Addition charge cost for every additional 15 minutes waiting.

false No meet and greet option available.

rating

Object

(Optional)

Rating Object
`ratings`	Integer	The number of ratings the company has received.
`score`	Float	The average score of the ratings our of 5.
`score`	`false`	If no ratings exist.

vehicles

Array

Array containing vehicle objects which contain prices for specific vehicles.

Vehicle Object
`class`	String	The vehicle class.
`count`	Integer	The number of vehicles of this type required to fulfil the passenger requirement.
`price`	Float	The price of the journey with the specific vehicle.
`meetandgreet_price`	Float	The price of the journey with the specific vehicle when meet and greet is applied.
`name`	String	The name of the vehicle.
`image`	String	A URL to an image on the vehicle.
`passengers`	Integer	The number of passengers the vehicle takes.
`luggage_big`	Integer	The amount of large luggage the vehicle can take.
`luggage_small`	Integer	The amount of small luggage the vehicle can take.

other_rates

Array

An array of Objects if other_rates is set, this will include the rates we were able to calculate with the rate type as the key and the details inside an object. Example rate:

Other Rate Object
`count`	Integer	The number of black cabs needed.
`lower_price`	Float	The lower estimate price of the journey in GBP.
`upper_price`	Float (Optional)	The upper estimate price of the journey in GBP.
`about`	String	Text about the rate.

card

Array

An array of card objects that are supported for payment and what the card fee is if applicable. This is used to show customers what they will be paying if they select to pay by card. (Logged in users can pay by cash or balance if they have an account balance AND the booking doesn't have an affiliate uplift applied to it.)

Card Object
`code`	String	The code for the card type.
`name`	String	The name of the card type.
`uplift`	Float	The percentage uplift that will be charged on the card.

numbers

Array

An array of taxi numbers for nearby taxi companies that aren't part of Taxicode.

Numbers Object
`area`	String	The town/city of the company is based in.
`company`	String	The company name.
`phone`	String	The phone number of the company.

Quote Example Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"card":[
		{
			"code":"VISA",
			"name":"Visa Credit",
			"uplift":0
		},
		{
			"code":"..."
		}
	],
	"journey":{
		"pickup":{
			"position":[
				51.4700223,
				-0.4542955
			],
			"postcode":"TW6 1BP",
			"string":"Heathrow Airport, London Borough of Hillingdon, United Kingdom"
		},
		"vias":[
			
		],
		"destination":{
			"position":[
				51.501737,
				-0.108588
			],
			"postcode":"SE1",
			"string":"Waterloo, London, United Kingdom"
		},
		"date":1390827533,
		"return":false,
		"people":3,
		"hourly":false,
		"quote_type":"mileage",
		"distance":19,
		"duration":2931,
		"duration_text":"48 mins"
	},
	"journey_id":"34965DF900982F2E48FE31A146E18710",
	"quotes":{
		"QUOTE_8DA3D4C97E":{
			"company_name":"Web3r",
			"company_id":1,
			"company_location":"Waterloo",
			"company_phone":"01234 567 890",
			"price":24.6,
			"meetandgreet":{
				"location":"London Heathrow Airport",
				"price":7,
				"waiting_time":"60",
				"waiting_time_extra":"5"
			},
			"rating":{
				"ratings":7,
				"score":4.6
			},
			"vehicles":[
				{
					"class":"standard",
					"count":1,
					"price":64,
					"meetandgreet_price":64,
					"name":"VW Sharan",
					"image":"https:\/\/0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com\/garage_img_96_1478158873.png",
					"passengers":6,
					"big_luggage":2,
					"small_luggage":2,
					"type":{
						"class":"standard",
						"type":"mpv"
					}
				},
				{
					"class":"Vip",
					"count":1,
					"price":97,
					"meetandgreet_price":97,
					"waiting_time":15,
					"name":"BMW 7 Series VIP",
					"image":"https:\/\/0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com\/garage_img_18_1478160158.png",
					"passengers":4,
					"big_luggage":3,
					"small_luggage":2,
					"type":{
						"class":"vip",
						"type":"minicab"
					}
				}
			]
		},
		"QUOTE_93760FA8FD":"..."
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<card>
		<element value='0'>
			<code>VISA</code>
			<name>Visa Credit</name>
			<uplift>0</uplift>
		</element>
		<element value='1'>
			<code>...</code>
		</element>
	</card>
	<journey>
		<pickup>
			<position>
				<element value='0'>51.4700223</element>
				<element value='1'>-0.4542955</element>
			</position>
			<postcode>TW6 1BP</postcode>
			<string>Heathrow Airport, London Borough of Hillingdon, United Kingdom</string>
		</pickup>
		<vias>
		</vias>
		<destination>
			<position>
				<element value='0'>51.501737</element>
				<element value='1'>-0.108588</element>
			</position>
			<postcode>SE1</postcode>
			<string>Waterloo, London, United Kingdom</string>
		</destination>
		<date>1390827533</date>
		<return></return>
		<people>3</people>
		<hourly></hourly>
		<quote_type>mileage</quote_type>
		<distance>19</distance>
		<duration>2931</duration>
		<duration_text>48 mins</duration_text>
	</journey>
	<journey_id>34965DF900982F2E48FE31A146E18710</journey_id>
	<quotes>
		<QUOTE_8DA3D4C97E>
			<company_name>Web3r</company_name>
			<company_id>1</company_id>
			<company_location>Waterloo</company_location>
			<company_phone>01234 567 890</company_phone>
			<price>24.6</price>
			<meetandgreet>
				<location>London Heathrow Airport</location>
				<price>7</price>
				<waiting_time>60</waiting_time>
				<waiting_time_extra>5</waiting_time_extra>
			</meetandgreet>
			<rating>
				<ratings>7</ratings>
				<score>4.6</score>
			</rating>
			<vehicles>
				<element value='0'>
					<class>standard</class>
					<count>1</count>
					<price>64</price>
					<meetandgreet_price>64</meetandgreet_price>
					<name>VW Sharan</name>
					<image>https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_96_1478158873.png</image>
					<passengers>6</passengers>
					<big_luggage>2</big_luggage>
					<small_luggage>2</small_luggage>
					<type>
						<class>standard</class>
						<type>mpv</type>
					</type>
				</element>
				<element value='1'>
					<class>Vip</class>
					<count>1</count>
					<price>97</price>
					<meetandgreet_price>97</meetandgreet_price>
					<waiting_time>15</waiting_time>
					<name>BMW 7 Series VIP</name>
					<image>https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_18_1478160158.png</image>
					<passengers>4</passengers>
					<big_luggage>3</big_luggage>
					<small_luggage>2</small_luggage>
					<type>
						<class>vip</class>
						<type>minicab</type>
					</type>
				</element>
			</vehicles>
		</QUOTE_8DA3D4C97E>
		<QUOTE_93760FA8FD>...</QUOTE_93760FA8FD>
	</quotes>
</TaxicodeResponse>

array(5) {
  ["status"]=>
  string(2) "OK"
  ["card"]=>
  array(2) {
    [0]=>
    array(3) {
      ["code"]=>
      string(4) "VISA"
      ["name"]=>
      string(11) "Visa Credit"
      ["uplift"]=>
      int(0)
    }
    [1]=>
    array(1) {
      ["code"]=>
      string(3) "..."
    }
  }
  ["journey"]=>
  array(11) {
    ["pickup"]=>
    array(3) {
      ["position"]=>
      array(2) {
        [0]=>
        float(51.4700223)
        [1]=>
        float(-0.4542955)
      }
      ["postcode"]=>
      string(7) "TW6 1BP"
      ["string"]=>
      string(62) "Heathrow Airport, London Borough of Hillingdon, United Kingdom"
    }
    ["vias"]=>
    array(0) {
    }
    ["destination"]=>
    array(3) {
      ["position"]=>
      array(2) {
        [0]=>
        float(51.501737)
        [1]=>
        float(-0.108588)
      }
      ["postcode"]=>
      string(3) "SE1"
      ["string"]=>
      string(32) "Waterloo, London, United Kingdom"
    }
    ["date"]=>
    int(1390827533)
    ["return"]=>
    bool(false)
    ["people"]=>
    int(3)
    ["hourly"]=>
    bool(false)
    ["quote_type"]=>
    string(7) "mileage"
    ["distance"]=>
    int(19)
    ["duration"]=>
    int(2931)
    ["duration_text"]=>
    string(7) "48 mins"
  }
  ["journey_id"]=>
  string(32) "34965DF900982F2E48FE31A146E18710"
  ["quotes"]=>
  array(2) {
    ["QUOTE_8DA3D4C97E"]=>
    array(8) {
      ["company_name"]=>
      string(5) "Web3r"
      ["company_id"]=>
      int(1)
      ["company_location"]=>
      string(8) "Waterloo"
      ["company_phone"]=>
      string(13) "01234 567 890"
      ["price"]=>
      float(24.6)
      ["meetandgreet"]=>
      array(4) {
        ["location"]=>
        string(23) "London Heathrow Airport"
        ["price"]=>
        int(7)
        ["waiting_time"]=>
        string(2) "60"
        ["waiting_time_extra"]=>
        string(1) "5"
      }
      ["rating"]=>
      array(2) {
        ["ratings"]=>
        int(7)
        ["score"]=>
        float(4.6)
      }
      ["vehicles"]=>
      array(2) {
        [0]=>
        array(10) {
          ["class"]=>
          string(8) "standard"
          ["count"]=>
          int(1)
          ["price"]=>
          int(64)
          ["meetandgreet_price"]=>
          int(64)
          ["name"]=>
          string(9) "VW Sharan"
          ["image"]=>
          string(110) "https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_96_1478158873.png"
          ["passengers"]=>
          int(6)
          ["big_luggage"]=>
          int(2)
          ["small_luggage"]=>
          int(2)
          ["type"]=>
          array(2) {
            ["class"]=>
            string(8) "standard"
            ["type"]=>
            string(3) "mpv"
          }
        }
        [1]=>
        array(11) {
          ["class"]=>
          string(3) "Vip"
          ["count"]=>
          int(1)
          ["price"]=>
          int(97)
          ["meetandgreet_price"]=>
          int(97)
          ["waiting_time"]=>
          int(15)
          ["name"]=>
          string(16) "BMW 7 Series VIP"
          ["image"]=>
          string(110) "https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_18_1478160158.png"
          ["passengers"]=>
          int(4)
          ["big_luggage"]=>
          int(3)
          ["small_luggage"]=>
          int(2)
          ["type"]=>
          array(2) {
            ["class"]=>
            string(3) "vip"
            ["type"]=>
            string(7) "minicab"
          }
        }
      }
    }
    ["QUOTE_93760FA8FD"]=>
    string(3) "..."
  }
}

a:5:{s:6:"status";s:2:"OK";s:4:"card";a:2:{i:0;a:3:{s:4:"code";s:4:"VISA";s:4:"name";s:11:"Visa Credit";s:6:"uplift";i:0;}i:1;a:1:{s:4:"code";s:3:"...";}}s:7:"journey";a:11:{s:6:"pickup";a:3:{s:8:"position";a:2:{i:0;d:51.470022299999997;i:1;d:-0.45429550000000002;}s:8:"postcode";s:7:"TW6 1BP";s:6:"string";s:62:"Heathrow Airport, London Borough of Hillingdon, United Kingdom";}s:4:"vias";a:0:{}s:11:"destination";a:3:{s:8:"position";a:2:{i:0;d:51.501736999999999;i:1;d:-0.108588;}s:8:"postcode";s:3:"SE1";s:6:"string";s:32:"Waterloo, London, United Kingdom";}s:4:"date";i:1390827533;s:6:"return";b:0;s:6:"people";i:3;s:6:"hourly";b:0;s:10:"quote_type";s:7:"mileage";s:8:"distance";i:19;s:8:"duration";i:2931;s:13:"duration_text";s:7:"48 mins";}s:10:"journey_id";s:32:"34965DF900982F2E48FE31A146E18710";s:6:"quotes";a:2:{s:16:"QUOTE_8DA3D4C97E";a:8:{s:12:"company_name";s:5:"Web3r";s:10:"company_id";i:1;s:16:"company_location";s:8:"Waterloo";s:13:"company_phone";s:13:"01234 567 890";s:5:"price";d:24.600000000000001;s:12:"meetandgreet";a:4:{s:8:"location";s:23:"London Heathrow Airport";s:5:"price";i:7;s:12:"waiting_time";s:2:"60";s:18:"waiting_time_extra";s:1:"5";}s:6:"rating";a:2:{s:7:"ratings";i:7;s:5:"score";d:4.5999999999999996;}s:8:"vehicles";a:2:{i:0;a:10:{s:5:"class";s:8:"standard";s:5:"count";i:1;s:5:"price";i:64;s:18:"meetandgreet_price";i:64;s:4:"name";s:9:"VW Sharan";s:5:"image";s:110:"https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_96_1478158873.png";s:10:"passengers";i:6;s:11:"big_luggage";i:2;s:13:"small_luggage";i:2;s:4:"type";a:2:{s:5:"class";s:8:"standard";s:4:"type";s:3:"mpv";}}i:1;a:11:{s:5:"class";s:3:"Vip";s:5:"count";i:1;s:5:"price";i:97;s:18:"meetandgreet_price";i:97;s:12:"waiting_time";i:15;s:4:"name";s:16:"BMW 7 Series VIP";s:5:"image";s:110:"https://0a253f0154a285c4c39d-737055c08ccf7a0c920fa07422559c6f.ssl.cf1.rackcdn.com/garage_img_18_1478160158.png";s:10:"passengers";i:4;s:11:"big_luggage";i:3;s:13:"small_luggage";i:2;s:4:"type";a:2:{s:5:"class";s:3:"vip";s:4:"type";s:7:"minicab";}}}}s:16:"QUOTE_93760FA8FD";s:3:"...";}}

Booking Voucher Validation

The booking/validate_voucher will validate a voucher can be used by the customer with the specified quote.

Validation Request

https://api.taxicode.com/booking/validate_voucher/

Parameter	Type	Description	Values	Default
`quote`	`GET / POST`	The quote ID the voucher will be used with.	String	-
`vehicle` optional	`GET / POST`	The index of the selected vehicle as provided in the vehicles array response by the quotes request. `N.B.` Not the ID of the vehicle, but the index of the vehicle in the array response.	Integer	`0`
`customer_email`	`GET / POST`	The customer using the voucher code.	String	-
`voucher`	`GET / POST`	The voucher code to validate.	String	-

Validation Response

The Response

voucher

Object

Voucher Object
`code`	String	The validated voucher code.
`value`	Integer	The amount the voucher is worth.
`type`	String	The voucher type.
`message`	String	A brief voucher message.

Will be FALSE if the voucher code is invalid.

message String If voucher is FALSE this will contain the validation failure reason message.

Valid Voucher Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"voucher":{
		"code":"SORRY2",
		"value":2,
		"type":"NORMAL",
		"message":"£2 off"
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<voucher>
		<code>SORRY2</code>
		<value>2</value>
		<type>NORMAL</type>
		<message>&pound;2 off</message>
	</voucher>
</TaxicodeResponse>

Array
(
    [voucher] => Array
        (
            [code] => SORRY2
            [value] => 2
            [type] => NORMAL
            [message] => £2 off
        )

)

array(1) {
  ["voucher"]=>
  array(4) {
    ["code"]=>
    string(6) "SORRY2"
    ["value"]=>
    int(2)
    ["type"]=>
    string(6) "NORMAL"
    ["message"]=>
    string(12) "£2 off"
  }
}

a:1:{s:7:"voucher";a:4:{s:4:"code";s:6:"SORRY2";s:5:"value";i:2;s:4:"type";s:6:"NORMAL";s:7:"message";s:12:"£2 off";}}

Invalid Voucher Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"voucher":false,
	"message":"Voucher code does not exist."
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<voucher></voucher>
	<message>Voucher code does not exist.</message>
</TaxicodeResponse>

Array
(
    [voucher] => 
    [message] => Voucher code does not exist.
)

array(2) {
  ["voucher"]=>
  bool(false)
  ["message"]=>
  string(28) "Voucher code does not exist."
}

a:2:{s:7:"voucher";b:0;s:7:"message";s:28:"Voucher code does not exist.";}

Create Booking Quote Checkout Session

The secure/checkout_session/create will generate a checkout session for the specified quote.

Validation Request

https://api.taxicode.com/secure/checkout_session/create/{QUOTE}

{QUOTE} should be replaced by the quote ID being booked in the checkout process.

Parameter	Type	Description	Values	Default
`key` required	`GET/POST`	Your API key so we can charge any affiliate uplift and attribute the booking to you.	String	-
`refererType` optional	`GET/POST`	The API referer type.	String	`main`
`callback` required	`GET`	A quote callback URL to link back to edit booking details.	String	`-`
`source_domain_hostname` optional	`GET`	The domain hostname making the request to create a new quote booking checkout session.	String	`-`
`vehicle` optional	`GET`	The index of the selected vehicle as provided in the vehicles array response by the quotes request. `N.B.` Not the ID of the vehicle, but the index of the vehicle in the array response.	Integer	`0`
`auth_token` optional	`POST`	The logged in booking user auth token.	String	-
`test` optional	`POST`	Whether this is a test booking or not. `test=1` means the booking will not be sent to the actual company and will be stored on a special testing company once it's been paid for. `test=0` or not setting it processes the booking as a live booking that goes to a taxi company. When setting `test=1` the payment uses SagePay's and Stripe's testing servers so you should enter any test card details for SagePay or Stripe.	`1` or `0`	`0`

Booking Quote Checkout Session Response

The Response

status OK Booking quote checkout session was successfully created.

ERROR Something went wrong creating the booking quote checkout session. An error message will be provided.

session

Object

Session Object
`state_hash`	String	The quote booking session ID.
`gateway_public_key`	String	The payment gateway handler public / client secret key.
`device_wallet_payment_enabled`	Boolean	Flag to indicate the use of the device wallet payment option is enabled.
`booking_ref`	String	The booking reference that will be used when the booking is eventually created.
`checkout`	String	A URL to process the booking quote checkout.

message String If status is ERROR this will contain the error message.

Booking Quote Checkout Session Created Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"session":{
		"state_hash":"v2_5e84d65a8b4045.42888441",
		"gateway_public_key":"pk_HY77889yhi9HH88H95e84d65a8b4045",
		"device_wallet_payment_enabled":true,
		"booking_ref":"TCC9ACCA213C1",
		"api_checkout_url":"https:\/\/{SECURE_HOST}\/\/api\/checkout_session\/v2_5e84d65a8b4045.42888441"
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<session>
		<state_hash>v2_5e84d65a8b4045.42888441</state_hash>
		<gateway_public_key>pk_HY77889yhi9HH88H95e84d65a8b4045</gateway_public_key>
		<device_wallet_payment_enabled>1</device_wallet_payment_enabled>
		<booking_ref>TCC9ACCA213C1</booking_ref>
		<api_checkout_url>https://{SECURE_HOST}//api/checkout_session/v2_5e84d65a8b4045.42888441</api_checkout_url>
	</session>
</TaxicodeResponse>

Array
(
    [status] => OK
    [session] => Array
        (
            [state_hash] => v2_5e84d65a8b4045.42888441
            [gateway_public_key] => pk_HY77889yhi9HH88H95e84d65a8b4045
            [device_wallet_payment_enabled] => 1
            [booking_ref] => TCC9ACCA213C1
            [api_checkout_url] => https://{SECURE_HOST}//api/checkout_session/v2_5e84d65a8b4045.42888441
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["session"]=>
  array(5) {
    ["state_hash"]=>
    string(26) "v2_5e84d65a8b4045.42888441"
    ["gateway_public_key"]=>
    string(34) "pk_HY77889yhi9HH88H95e84d65a8b4045"
    ["device_wallet_payment_enabled"]=>
    bool(true)
    ["booking_ref"]=>
    string(13) "TCC9ACCA213C1"
    ["api_checkout_url"]=>
    string(70) "https://{SECURE_HOST}//api/checkout_session/v2_5e84d65a8b4045.42888441"
  }
}

a:2:{s:6:"status";s:2:"OK";s:7:"session";a:5:{s:10:"state_hash";s:26:"v2_5e84d65a8b4045.42888441";s:18:"gateway_public_key";s:34:"pk_HY77889yhi9HH88H95e84d65a8b4045";s:29:"device_wallet_payment_enabled";b:1;s:11:"booking_ref";s:13:"TCC9ACCA213C1";s:16:"api_checkout_url";s:70:"https://{SECURE_HOST}//api/checkout_session/v2_5e84d65a8b4045.42888441";}}

Booking Quote Checkout Session Creation Error Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"ERROR",
	"message":"Specific Error Message"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>ERROR</status>
	<message>Specific Error Message</message>
</TaxicodeResponse>

Array
(
    [status] => ERROR
    [message] => Specific Error Message
)

array(2) {
  ["status"]=>
  string(5) "ERROR"
  ["message"]=>
  string(22) "Specific Error Message"
}

a:2:{s:6:"status";s:5:"ERROR";s:7:"message";s:22:"Specific Error Message";}

Booking Payment Intent Client Gateway Secret

Generate a payment intent secret for the clientside to continue the transaction for the specified quote.

Payment Intent Client Gateway Secret Request

https://api.taxicode.com/booking/client_gateway_secret/

Parameter	Type	Description	Values	Default
`key` required	`GET/POST`	Your API key so we can apply any affiliate uplift you may have.	String	-
`handler` required	`POST`	The intended payment method handler name.	String `jstoken_stripe`	-
`quote` required	`GET / POST`	The quote ID of the journey being booked.	String	-
`vehicle` optional	`GET / POST`	The index of the selected vehicle as provided in the vehicles array response by the quotes request. `N.B.` Not the ID of the vehicle, but the index of the vehicle in the array response.	Integer	`0`
`region` optional e.g europe	`GET / POST`	Client region to use for the payment intent transaction. Use `europe` for European clients.	String	`''`
`eur_conversion_rate` required if region = europe	`GET / POST`	The conversion rate to use for the payment intent transaction for european region. example `1.19`.	Integer	`-`

Payment Intent Client Gateway Secret Response

The Response

status OK The payment intent was successfully created.

ERROR Something went wrong creating the booking payment intent. An error message will be provided.

response

Object

Response Object

intent

Object

Intent Object
`status`	String	The payment intent transaction status.
`client_secret`	String	The payment intent client secret key to use clientside with the payment intent transaction.
`gateway`	String	The payment gateway handler name.
`vendor`	String	Gateway sub account (if any).

amount Float The payment intent transaction amount.

message String If status is ERROR this will contain the error message.

Payment Intent Client Gateway Secret Created Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"response":{
		"intent":{
			"status":"requires_source",
			"client_secret":"pi_1IEVXkJvCXWdJrbxZ7jgAh0p_secret_ADNMppTKOhzih6usXKcKfSBlv",
			"gateway":"stripe",
			"vendor":"taxicode"
		},
		"amount":26.5
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<response>
		<intent>
			<status>requires_source</status>
			<client_secret>pi_1IEVXkJvCXWdJrbxZ7jgAh0p_secret_ADNMppTKOhzih6usXKcKfSBlv</client_secret>
			<gateway>stripe</gateway>
			<vendor>taxicode</vendor>
		</intent>
		<amount>26.5</amount>
	</response>
</TaxicodeResponse>

Array
(
    [status] => OK
    [response] => Array
        (
            [intent] => Array
                (
                    [status] => requires_source
                    [client_secret] => pi_1IEVXkJvCXWdJrbxZ7jgAh0p_secret_ADNMppTKOhzih6usXKcKfSBlv
                    [gateway] => stripe
                    [vendor] => taxicode
                )

            [amount] => 26.5
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["response"]=>
  array(2) {
    ["intent"]=>
    array(4) {
      ["status"]=>
      string(15) "requires_source"
      ["client_secret"]=>
      string(60) "pi_1IEVXkJvCXWdJrbxZ7jgAh0p_secret_ADNMppTKOhzih6usXKcKfSBlv"
      ["gateway"]=>
      string(6) "stripe"
      ["vendor"]=>
      string(8) "taxicode"
    }
    ["amount"]=>
    float(26.5)
  }
}

a:2:{s:6:"status";s:2:"OK";s:8:"response";a:2:{s:6:"intent";a:4:{s:6:"status";s:15:"requires_source";s:13:"client_secret";s:60:"pi_1IEVXkJvCXWdJrbxZ7jgAh0p_secret_ADNMppTKOhzih6usXKcKfSBlv";s:7:"gateway";s:6:"stripe";s:6:"vendor";s:8:"taxicode";}s:6:"amount";d:26.5;}}

Payment Intent Client Gateway Secret Error Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"ERROR",
	"message":"Specific Error Message"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>ERROR</status>
	<message>Specific Error Message</message>
</TaxicodeResponse>

Array
(
    [status] => ERROR
    [message] => Specific Error Message
)

array(2) {
  ["status"]=>
  string(5) "ERROR"
  ["message"]=>
  string(22) "Specific Error Message"
}

a:2:{s:6:"status";s:5:"ERROR";s:7:"message";s:22:"Specific Error Message";}

Booking Pay

Pay Request

https://api.taxicode.com/booking/pay/

Parameter	Type	Description	Values	Default
`quote`	`POST`	The Quote ID that was provided by the Booking Quote Request.	String	-
`vehicle` optional	`POST`	The index of the selected vehicle as provided in the vehicles array response by the quotes request. `N.B.` Not the ID of the vehicle, but the index of the vehicle in the array response.	Integer	`0`
`flight_number` optional	`POST`	If the pickup is from an airport a flight number can be added to the booking details.	String	`-`
`business_name` optional	`POST`	Business name (for business bookings).	String	`-`
`voucher_code` optional	`POST`	Discount voucher code to be applied to the payment price.	String	`-`
`business_ref` optional	`POST`	Optional business reference to associate with the booking.	String `max length 32 characters`	`-`
`notes` optional	`POST`	Any additional booking notes.	String	`-`
`method` optional	`POST`	The payment option selected. Possible payment options sent through quote response as array. Please note that all quotes can be paid for by card, some quotes can be made as a cash booking if a user is authenticated, other payment options may be made available in the future.	`authorised_payment_handler`, `card`, `googlepay`, `applepay` or `cash`	`card`
`key` required	`POST`	Your API key so we can charge any affiliate uplift and attribute the booking to you.	String	-
`test` optional	`GET/POST`	Whether this is a test booking or not. `test=1` means the booking will not be sent to the actual company and will be stored on a special testing company once it's been paid for. `test=0` or not setting it processes the booking as a live booking that goes to a taxi company. When setting `test=1` the payment uses SagePay's and Stripe's testing servers so you should enter any test card details for SagePay or Stripe.	`1` or `0`	`0`
Customer Details - Required if user is not currently logged in.
`name`	`POST`	The name of the customer.	String	-
`email`	`POST`	The email address of the customer for notifications about the booking progress.	String	-
`telephone`	`POST`	Customers telephone number. Used to allow taxi company to contact customer if needed and notify them when they are nearby.	String	-
Card Payment Details - Following all required if 'card' (or no) payment option selected.
`card_cardholder`	`POST`	The card holders name. Must be the same as the	String	-
`card_type`	`POST`	The card type.	`VISA` (Visa Credit), `DELTA` (Visa Debit), `UKE` (Visa Electron), `MC` (MasterCard), `MAESTRO` (Maestro) or `AMEX` (American Express)	-
`card_number`	`POST`	The number printed on the front of the card.		-
`card_start` optional	`POST`	The start date of the card. `Only for Maestro cards`	Month year as: `MMYY`	-
`card_expiry`	`POST`	The expiry date of the card..	Month year as: `MMYY`	-
`issue_number` optional	`POST`	The issue number of the card. Only for Maestro cards.	Integer	-
`card_cv2`	`POST`	The last 3 digits on the back of the signature strip on the card.	String	-
`card_address1`	`POST`	The first line of the billing address.	String	-
`card_address2` optional	`POST`	The second line of the billing address.	String	-
`city`	`POST`	The town or city of the billing address.	String	-
`postcode`	`POST`	The postcode or zipcode of the billing address.	String	-
`country` optional	`POST`	The 2 letter ISO 3166-1 country code of the billing address.	String	`GB`
`state` optional	`POST`	The 2 letter state code for each as defined by ISO 3166-2:US. Only needed is country is US.	String	-
Card Payment Details - Following all required if 'googlepay' or 'applepay' payment option selected.
`payment_token`	`POST`	The tokenized details for the card transaction	String	-
`card_address1`	`POST`	The first line of the billing address.	String	-
`card_address2` optional	`POST`	The second line of the billing address.	String	-
`city`	`POST`	The town or city of the billing address.	String	-
`postcode`	`POST`	The postcode or zipcode of the billing address.	String	-
`country` optional	`POST`	The 2 letter ISO 3166-1 country code of the billing address.	String	`GB`
`state` optional	`POST`	The 2 letter state code for each as defined by ISO 3166-2:US. Only needed is country is US.	String	-

Pay Response

The Response
`status`	`OK`	Booking was successfully created.
	`3DAUTH`	Status indicates that payment requires 3D authentication. A `url` is provided to redirect the customer to a 3D secure authentication environment.
	`ERROR`	The payment could not be taken. An error message will be provided.
	`FAILED`	The payment could not be taken. An error message will be provided.
`error`	String	If status is `ERROR` or `FAILED` this will contain an error message.
`reference`	String	If status is `OK` this will contain the booking reference. This means the bookings has been made.
`url`	String	If status is `3DAUTH` this will contain a redirect URL to forward the customer.

Pay Example Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"reference":"TC22E97643"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<reference>TC22E97643</reference>
</TaxicodeResponse>

Array
(
    [status] => OK
    [reference] => TC22E97643
)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["reference"]=>
  string(10) "TC22E97643"
}

a:2:{s:6:"status";s:2:"OK";s:9:"reference";s:10:"TC22E97643";}

Leave Customer Tip

Leave Customer Tip Request

https://api.taxicode.com/booking/leave_customer_tip/

Parameter	Type	Description	Values	Default
`booking`	`POST`	The booking reference (Example: TC12312312) of a booking.	String	-
`tip_amount`	`POST`	The The monetary amount to leave as the tip.	Float	-

Leave Customer Tip Response

The Response

status OK Everything is okay.

ERROR If there was an error and no quotes returned.

error String If status is ERROR this will contain the error message.

booking

Object

The tip charge details for the booking.

Booking Object
`ref`	String	The booking ref the customer left the tip for
`amount`	Float	The amount that was tipped.
`transaction`	String	The payment gateway transaction code.
`status`	String	The status of the tip transaction.
`added_on`	String	When the tip was left.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"booking":{
		"ref":"TC12312312",
		"amount":1,
		"transaction":"ch_xui9...",
		"status":"PAID",
		"added_on":"05:01 21-11-2024"
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<booking>
		<ref>TC12312312</ref>
		<amount>1</amount>
		<transaction>ch_xui9...</transaction>
		<status>PAID</status>
		<added_on>05:01 21-11-2024</added_on>
	</booking>
</TaxicodeResponse>

Array
(
    [status] => OK
    [booking] => Array
        (
            [ref] => TC12312312
            [amount] => 1
            [transaction] => ch_xui9...
            [status] => PAID
            [added_on] => 05:01 21-11-2024
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["booking"]=>
  array(5) {
    ["ref"]=>
    string(10) "TC12312312"
    ["amount"]=>
    float(1)
    ["transaction"]=>
    string(10) "ch_xui9..."
    ["status"]=>
    string(4) "PAID"
    ["added_on"]=>
    string(16) "05:01 21-11-2024"
  }
}

a:2:{s:6:"status";s:2:"OK";s:7:"booking";a:5:{s:3:"ref";s:10:"TC12312312";s:6:"amount";d:1;s:11:"transaction";s:10:"ch_xui9...";s:6:"status";s:4:"PAID";s:8:"added_on";s:16:"05:01 21-11-2024";}}

Booking Journey

Journey Request

https://api.taxicode.com/booking/journey/

Parameter	Type	Description	Values	Default
`id`	`POST`	The ID of the journey as provided by `booking/quote`.	String	-

Journey Response

The Response

status OK Everything is okay.

ERROR If there was an error and no quotes returned.

error String If status is ERROR this will contain the error message.

journey

Object

Journey Object
`quote_type`	String	`mileage` or `hourly`
`pickup`	String	The human readable journey pickup location.
`via`	String	Comma separated list of human readable journey locations to call via or `false`.
`vias`	Array	List of human readable journey locations to call via or an empty `array`.
`destination`	String	The human readable journey destination location.
`date`	String	The date of the journey in `d/m/Y` format.
`hour`	String	The hour portion of the journey time in 24 hour format with leading zero.
`mins`	String	The minute portion of the journey time with leading zero.
`time`	String	The full journey time in `H:i:s` format.
`return`	String	The return date of the journey in `d/m/Y` format or `false`.
`return_hour`	String	The hour portion of the journey time in 24 hour format with leading zero or `false`.
`return_mins`	String	The minute portion of the journey time with leading zero or `false`.
`return_time`	String	The full journey time in `H:i:s` format or `false`.
`passengers`	Integer	The number of passengers the journey is for.
`hourly`	Float	Duration in hours or `false`.
`asap`	Boolean	Indicates if the journey was/is ASAP.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"journey":{
		"quote_type":"mileage",
		"pickup":"York",
		"via":false,
		"vias":[
			
		],
		"destination":"York Station",
		"date":"31\/12\/2024",
		"return":false,
		"hour":"22",
		"mins":"30",
		"time":"22:30:00",
		"return_hour":false,
		"return_mins":false,
		"return_time":false,
		"passengers":3,
		"hourly":false,
		"asap":false
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<journey>
		<quote_type>mileage</quote_type>
		<pickup>York</pickup>
		<via></via>
		<vias>
		</vias>
		<destination>York Station</destination>
		<date>31/12/2024</date>
		<return></return>
		<hour>22</hour>
		<mins>30</mins>
		<time>22:30:00</time>
		<return_hour></return_hour>
		<return_mins></return_mins>
		<return_time></return_time>
		<passengers>3</passengers>
		<hourly></hourly>
		<asap></asap>
	</journey>
</TaxicodeResponse>

Array
(
    [status] => OK
    [journey] => Array
        (
            [quote_type] => mileage
            [pickup] => York
            [via] => 
            [vias] => Array
                (
                )

            [destination] => York Station
            [date] => 31/12/2024
            [return] => 
            [hour] => 22
            [mins] => 30
            [time] => 22:30:00
            [return_hour] => 
            [return_mins] => 
            [return_time] => 
            [passengers] => 3
            [hourly] => 
            [asap] => 
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["journey"]=>
  array(16) {
    ["quote_type"]=>
    string(7) "mileage"
    ["pickup"]=>
    string(4) "York"
    ["via"]=>
    bool(false)
    ["vias"]=>
    array(0) {
    }
    ["destination"]=>
    string(12) "York Station"
    ["date"]=>
    string(10) "31/12/2024"
    ["return"]=>
    bool(false)
    ["hour"]=>
    string(2) "22"
    ["mins"]=>
    string(2) "30"
    ["time"]=>
    string(8) "22:30:00"
    ["return_hour"]=>
    bool(false)
    ["return_mins"]=>
    bool(false)
    ["return_time"]=>
    bool(false)
    ["passengers"]=>
    int(3)
    ["hourly"]=>
    bool(false)
    ["asap"]=>
    bool(false)
  }
}

a:2:{s:6:"status";s:2:"OK";s:7:"journey";a:16:{s:10:"quote_type";s:7:"mileage";s:6:"pickup";s:4:"York";s:3:"via";b:0;s:4:"vias";a:0:{}s:11:"destination";s:12:"York Station";s:4:"date";s:10:"31/12/2024";s:6:"return";b:0;s:4:"hour";s:2:"22";s:4:"mins";s:2:"30";s:4:"time";s:8:"22:30:00";s:11:"return_hour";b:0;s:11:"return_mins";b:0;s:11:"return_time";b:0;s:10:"passengers";i:3;s:6:"hourly";b:0;s:4:"asap";b:0;}}

Booking State

The booking/state API gets the current status of a booking or list of bookings. If you need more information on a booking you can use the booking/details which is part of the affiliate API.

State Request

https://api.taxicode.com/booking/state/

Parameter	Type	Description	Values	Default
`booking`	`GET / POST`	The booking reference (Example: TC12312312) of a booking.	String	-
`booking`	`GET / POST`	A comma separated list of booking references.	String	-

State Response

The Response

status OK Everything is okay.

ERROR If there was an error and no quotes returned.

error String If status is ERROR this will contain the error message.

bookings

Object

List of bookings statues with booking reference as key and booking object as value.

Booking Object
`status`	String	The status of the booking. Will be either `Unconfirmed`, `Confirmed` or `Cancelled` or `ERROR` if the booking reference is not found.
`company_name`	String	The company name that is dealing with the booking.
`company_telephone`	String	The telephone number of the company.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"bookings":{
		"TC12312312":{
			"status":"Unconfirmed",
			"company_name":"ABC Taxis",
			"company_telephone":"01234 567890"
		},
		"...":"..."
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<bookings>
		<TC12312312>
			<status>Unconfirmed</status>
			<company_name>ABC Taxis</company_name>
			<company_telephone>01234 567890</company_telephone>
		</TC12312312>
		<...>...</...>
	</bookings>
</TaxicodeResponse>

Array
(
    [status] => OK
    [bookings] => Array
        (
            [TC12312312] => Array
                (
                    [status] => Unconfirmed
                    [company_name] => ABC Taxis
                    [company_telephone] => 01234 567890
                )

            [...] => ...
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["bookings"]=>
  array(2) {
    ["TC12312312"]=>
    array(3) {
      ["status"]=>
      string(11) "Unconfirmed"
      ["company_name"]=>
      string(9) "ABC Taxis"
      ["company_telephone"]=>
      string(12) "01234 567890"
    }
    ["..."]=>
    string(3) "..."
  }
}

a:2:{s:6:"status";s:2:"OK";s:8:"bookings";a:2:{s:10:"TC12312312";a:3:{s:6:"status";s:11:"Unconfirmed";s:12:"company_name";s:9:"ABC Taxis";s:17:"company_telephone";s:12:"01234 567890";}s:3:"...";s:3:"...";}}

Booking Resend

The booking/resend allows you to request for a booking confirmation email to be resent to the customer.

Resend Request

https://api.taxicode.com/booking/resend/

Parameter	Type	Description	Values	Default
`booking`	`POST`	The booking reference (Example: TC12312312) of a booking.	String	-

Resend Response

The Response
`status`	`OK`	Everything is okay and the resend request was successful.
`status`	`ERROR`	If there was an error and no quotes returned.
`error`	String	If status is `ERROR` this will contain the error message.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
</TaxicodeResponse>

Array
(
    [status] => OK
)

array(1) {
  ["status"]=>
  string(2) "OK"
}

a:1:{s:6:"status";s:2:"OK";}

Booking Cancel

The booking/cancel allows you to request for a booking to be cancelled on behalf of the customer. This must be done 24 hours before the outward journey is due to take place otherwise it is recommened you get the customer to contact the provider directly.

Resend Request

https://api.taxicode.com/booking/cancel/

Parameter	Type	Description	Values	Default
`booking`	`GET/POST`	The booking reference (Example: TC12312312) of a booking.	String	-
`key`	`GET/POST`	Your API key. Must be the API key the booking was made with.	String	-
`secret`	`GET/POST`	Your secret API key. Must match the API key the booking was made with. Warning This must be sent by your server, not by a client side API request for example through an APP or via javascript on a webpage. If this is how your application works please make your application make this request to your server where you can then add the secret key to the request to our API so your secret key is not exposed.	String	-

Resend Response

The Response
`status`	`OK`	Everything is okay and the resend request was successful.
`status`	`ERROR`	If there was an error and no quotes returned.
`error`	String	If status is `ERROR` this will contain the error message.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK"
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
</TaxicodeResponse>

Array
(
    [status] => OK
)

array(1) {
  ["status"]=>
  string(2) "OK"
}

a:1:{s:6:"status";s:2:"OK";}

FAQ API

The FAQ API allows the retrieval of frequently asked questions for categories.

Hints and Tips

Hints and Tips Request

https://api.taxicode.com/faq/hints/

Hints and Tips Response

The Response
`status`	`OK`	Everything is okay.
`status`	`ERROR`	If there was an error and no categories returned.
`error`	String	If status is `ERROR` this will contain the error message.
`hints`	Array	A list of available hints.

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"hints":[
		"Taxicode is a pre-booked fixed-price service",
		"We search your local minicab companies to find you the best fare",
		"Our medium to long-distance fares are typically lower that you will find elsewhere",
		"You can pay by a card or by using Apple Pay or Google Wallet",
		"You don't need to create an account to book with us"
	]
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<hints>
		<element value='0'>Taxicode is a pre-booked fixed-price service</element>
		<element value='1'>We search your local minicab companies to find you the best fare</element>
		<element value='2'>Our medium to long-distance fares are typically lower that you will find elsewhere</element>
		<element value='3'>You can pay by a card or by using Apple Pay or Google Wallet</element>
		<element value='4'>You don't need to create an account to book with us</element>
	</hints>
</TaxicodeResponse>

Array
(
    [status] => OK
    [hints] => Array
        (
            [0] => Taxicode is a pre-booked fixed-price service
            [1] => We search your local minicab companies to find you the best fare
            [2] => Our medium to long-distance fares are typically lower that you will find elsewhere
            [3] => You can pay by a card or by using Apple Pay or Google Wallet
            [4] => You don't need to create an account to book with us
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["hints"]=>
  array(5) {
    [0]=>
    string(44) "Taxicode is a pre-booked fixed-price service"
    [1]=>
    string(64) "We search your local minicab companies to find you the best fare"
    [2]=>
    string(82) "Our medium to long-distance fares are typically lower that you will find elsewhere"
    [3]=>
    string(60) "You can pay by a card or by using Apple Pay or Google Wallet"
    [4]=>
    string(51) "You don't need to create an account to book with us"
  }
}

a:2:{s:6:"status";s:2:"OK";s:5:"hints";a:5:{i:0;s:44:"Taxicode is a pre-booked fixed-price service";i:1;s:64:"We search your local minicab companies to find you the best fare";i:2;s:82:"Our medium to long-distance fares are typically lower that you will find elsewhere";i:3;s:60:"You can pay by a card or by using Apple Pay or Google Wallet";i:4;s:51:"You don't need to create an account to book with us";}}

Affiliate API

The Affiliate API allows you to review your affiliate account and bookings made with your affiliate account.

All calls to the Affiliate API require your API secret key and your API key. They should only be sent securely by your server to the Taxicode API server so that your secret key is not exposed. If your secret key is exposed to users, you should contact us requesting a new secret key.

Affiliate Details

Affiliate Details Request

https://api.taxicode.com/affiliate/

Parameter	Type	Description	Values	Default
`key`	`POST/GET`	Your API Key.	String	-
`secret`	`POST/GET`	Your secret key.	String	-

Affiliate Details Response

Once you've made your request you will recieve back to objects:

The Response

status OK Everything is okay.

ERROR If there was an error and no details can be returned.

error String If status is ERROR this will contain the error message.

affiliate

Object

Affiliate Object
`title`	String	The name of your API account, shown to customers in emails, taxi companies on their dashboard and other places where relevant.
`image`	String	Your logo.
`colour1`	String	The colour code (as hex without preceding #) that is the primary colour used in our email template when sending out emails on your behalf.
`colour2`	String	The colour code (as hex without preceding #) that is the secondary colour used in our email template when sending out emails on your behalf.
`link`	String	The URL of your service so we can link to you in relevant places.

Affiliate Details Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"affiliate":{
		"title":"Top Airport Taxis",
		"image":"http:\/\/www.topairporttaxis.co.uk\/imgs\/compare\/topairporttaxis\/logo_white.png",
		"colour1":"098972",
		"colour2":"FFFFFF",
		"link":"http:\/\/www.topairporttaxis.co.uk\/"
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<affiliate>
		<title>Top Airport Taxis</title>
		<image>http://www.topairporttaxis.co.uk/imgs/compare/topairporttaxis/logo_white.png</image>
		<colour1>098972</colour1>
		<colour2>FFFFFF</colour2>
		<link>http://www.topairporttaxis.co.uk/</link>
	</affiliate>
</TaxicodeResponse>

Array
(
    [status] => OK
    [affiliate] => Array
        (
            [title] => Top Airport Taxis
            [image] => http://www.topairporttaxis.co.uk/imgs/compare/topairporttaxis/logo_white.png
            [colour1] => 098972
            [colour2] => FFFFFF
            [link] => http://www.topairporttaxis.co.uk/
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["affiliate"]=>
  array(5) {
    ["title"]=>
    string(17) "Top Airport Taxis"
    ["image"]=>
    string(76) "http://www.topairporttaxis.co.uk/imgs/compare/topairporttaxis/logo_white.png"
    ["colour1"]=>
    string(6) "098972"
    ["colour2"]=>
    string(6) "FFFFFF"
    ["link"]=>
    string(33) "http://www.topairporttaxis.co.uk/"
  }
}

a:2:{s:6:"status";s:2:"OK";s:9:"affiliate";a:5:{s:5:"title";s:17:"Top Airport Taxis";s:5:"image";s:76:"http://www.topairporttaxis.co.uk/imgs/compare/topairporttaxis/logo_white.png";s:7:"colour1";s:6:"098972";s:7:"colour2";s:6:"FFFFFF";s:4:"link";s:33:"http://www.topairporttaxis.co.uk/";}}

Affiliate Earnings

Affiliate Earnings Request

https://api.taxicode.com/affiliate/earnings/

Parameter	Type	Description	Values	Default
`key`	`POST/GET`	Your API Key.	String	-
`secret`	`POST/GET`	Your secret key.	String	-

Affiliate Earnings Response

Once you've made your request you will recieve back to objects:

The Response
`status`	`OK`	Everything is okay.
`status`	`ERROR`	If there was an error and no earnings data can be returned.
`error`	String	If status is `ERROR` this will contain the error message.
`earnings`	Object	A list of years (YYYY) containing a list of months (MM) containing a list of bookings and the value they earned the affiliate.

Affiliate Earnings Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"earnings":{
		"2014":{
			"12":{
				"TC12345676":27.01,
				"TC12345677":6.23
			}
		},
		"2015":{
			"01":{
				"TC12345678":1.36,
				"TC12345679":1.5,
				"TC12345680":4.23
			},
			"02":{
				"TC12345681":10.6,
				"TC12345682":9.85,
				"TC12345683":7.57,
				"TC12345684":4.23
			}
		}
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<earnings>
		<element value='2014'>
			<element value='12'>
				<TC12345676>27.01</TC12345676>
				<TC12345677>6.23</TC12345677>
			</element>
		</element>
		<element value='2015'>
			<element value='01'>
				<TC12345678>1.36</TC12345678>
				<TC12345679>1.5</TC12345679>
				<TC12345680>4.23</TC12345680>
			</element>
			<element value='02'>
				<TC12345681>10.6</TC12345681>
				<TC12345682>9.85</TC12345682>
				<TC12345683>7.57</TC12345683>
				<TC12345684>4.23</TC12345684>
			</element>
		</element>
	</earnings>
</TaxicodeResponse>

Array
(
    [status] => OK
    [earnings] => Array
        (
            [2014] => Array
                (
                    [12] => Array
                        (
                            [TC12345676] => 27.01
                            [TC12345677] => 6.23
                        )

                )

            [2015] => Array
                (
                    [01] => Array
                        (
                            [TC12345678] => 1.36
                            [TC12345679] => 1.5
                            [TC12345680] => 4.23
                        )

                    [02] => Array
                        (
                            [TC12345681] => 10.6
                            [TC12345682] => 9.85
                            [TC12345683] => 7.57
                            [TC12345684] => 4.23
                        )

                )

        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["earnings"]=>
  array(2) {
    [2014]=>
    array(1) {
      [12]=>
      array(2) {
        ["TC12345676"]=>
        float(27.01)
        ["TC12345677"]=>
        float(6.23)
      }
    }
    [2015]=>
    array(2) {
      ["01"]=>
      array(3) {
        ["TC12345678"]=>
        float(1.36)
        ["TC12345679"]=>
        float(1.5)
        ["TC12345680"]=>
        float(4.23)
      }
      ["02"]=>
      array(4) {
        ["TC12345681"]=>
        float(10.6)
        ["TC12345682"]=>
        float(9.85)
        ["TC12345683"]=>
        float(7.57)
        ["TC12345684"]=>
        float(4.23)
      }
    }
  }
}

a:2:{s:6:"status";s:2:"OK";s:8:"earnings";a:2:{i:2014;a:1:{i:12;a:2:{s:10:"TC12345676";d:27.010000000000002;s:10:"TC12345677";d:6.2300000000000004;}}i:2015;a:2:{s:2:"01";a:3:{s:10:"TC12345678";d:1.3600000000000001;s:10:"TC12345679";d:1.5;s:10:"TC12345680";d:4.2300000000000004;}s:2:"02";a:4:{s:10:"TC12345681";d:10.6;s:10:"TC12345682";d:9.8499999999999996;s:10:"TC12345683";d:7.5700000000000003;s:10:"TC12345684";d:4.2300000000000004;}}}}

Affiliate Payment Due

If you are an authorised payment handler you will be due to make payments for bookings made through our API once the provider has confirmed the job was completed. We will contact you weekly to confirm the bookings that need to be paid, but you can use this API call to look up the current amount due. This will also help you automate this process. You will still need to email accounts@web3r.co.uk once you have paid with a list of booking references you have paid.

Affiliate Payment Due Request

https://api.taxicode.com/affiliate/payment_due/

Parameter	Type	Description	Values	Default
`key`	`POST/GET`	Your API Key.	String	-
`secret`	`POST/GET`	Your secret key.	String	-

Affiliate Payment Due Response

Once you've made your request you will recieve back to objects:

The Response

status OK Everything is okay.

ERROR If there was an error and no earnings data can be returned.

error String If status is ERROR this will contain the error message.

bookings

Array

Array of objects for bookings that payment is due for:

Booking Payment Due Object
`booking`	String	The booking reference.
`value`	Float	The value of the booking.
`name`	String	The customer name.
`created`	String	The date the booking was made.

total Float The total amount due.

Affiliate Earnings Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"bookings":[
		{
			"booking":"TC12345680",
			"value":24.62,
			"name":"John Smith",
			"created":"2015-07-20 12:32:02"
		},
		{
			"booking":"TC12345680",
			"value":54.2,
			"name":"Sarah Jones",
			"created":"2015-07-28 08:58:12"
		}
	],
	"total":78.82
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<bookings>
		<element value='0'>
			<booking>TC12345680</booking>
			<value>24.62</value>
			<name>John Smith</name>
			<created>2015-07-20 12:32:02</created>
		</element>
		<element value='1'>
			<booking>TC12345680</booking>
			<value>54.2</value>
			<name>Sarah Jones</name>
			<created>2015-07-28 08:58:12</created>
		</element>
	</bookings>
	<total>78.82</total>
</TaxicodeResponse>

Array
(
    [status] => OK
    [bookings] => Array
        (
            [0] => Array
                (
                    [booking] => TC12345680
                    [value] => 24.62
                    [name] => John Smith
                    [created] => 2015-07-20 12:32:02
                )

            [1] => Array
                (
                    [booking] => TC12345680
                    [value] => 54.2
                    [name] => Sarah Jones
                    [created] => 2015-07-28 08:58:12
                )

        )

    [total] => 78.82
)

array(3) {
  ["status"]=>
  string(2) "OK"
  ["bookings"]=>
  array(2) {
    [0]=>
    array(4) {
      ["booking"]=>
      string(10) "TC12345680"
      ["value"]=>
      float(24.62)
      ["name"]=>
      string(10) "John Smith"
      ["created"]=>
      string(19) "2015-07-20 12:32:02"
    }
    [1]=>
    array(4) {
      ["booking"]=>
      string(10) "TC12345680"
      ["value"]=>
      float(54.2)
      ["name"]=>
      string(11) "Sarah Jones"
      ["created"]=>
      string(19) "2015-07-28 08:58:12"
    }
  }
  ["total"]=>
  float(78.82)
}

a:3:{s:6:"status";s:2:"OK";s:8:"bookings";a:2:{i:0;a:4:{s:7:"booking";s:10:"TC12345680";s:5:"value";d:24.620000000000001;s:4:"name";s:10:"John Smith";s:7:"created";s:19:"2015-07-20 12:32:02";}i:1;a:4:{s:7:"booking";s:10:"TC12345680";s:5:"value";d:54.200000000000003;s:4:"name";s:11:"Sarah Jones";s:7:"created";s:19:"2015-07-28 08:58:12";}}s:5:"total";d:78.820000000000007;}

Affiliate Booking Details

Affiliate Booking Details Request

https://api.taxicode.com/booking/details/

Parameter	Type	Description	Values	Default
`key`	`POST/GET`	Your API Key.	String	-
`secret`	`POST/GET`	Your secret key.	String	-
`id`	`POST/GET`	Your ID of the booking (Example: TC12312312)	String	-

Affiliate Booking Details Response

Once you've made your request you will recieve back to objects:

The Response
`status`	`OK`	Everything is okay.
`status`	`ERROR`	If there was an error and no booking details can be returned.
`error`	String	If status is `ERROR` this will contain the error message.
`booking`	Object	See example below.

Affiliate Earnings Response

JSON

XML

PRE

VAR DUMP

SERIALIZED

{
	"status":"OK",
	"booking":{
		"reference":"TC12312312",
		"date":"2015-01-07 16:30:00",
		"return":false,
		"pickup":{
			"string":"Fleet, Hampshire, GU51",
			"position":[
				51.2864,
				-0.839153
			],
			"postcode":"GU51"
		},
		"destination":{
			"string":"Aldershot, Hampshire, GU51",
			"position":[
				51.2554,
				-0.767322
			],
			"postcode":"GU11"
		},
		"price":13.64,
		"distance":5,
		"people":1,
		"company_name":"Taxi Company Name",
		"company_number":"01234 567890",
		"status":"Unconfirmed"
	}
}

<?xml version="1.0" encoding="UTF-8"?>
<TaxicodeResponse>
	<status>OK</status>
	<booking>
		<reference>TC12312312</reference>
		<date>2015-01-07 16:30:00</date>
		<return></return>
		<pickup>
			<string>Fleet, Hampshire, GU51</string>
			<position>
				<element value='0'>51.2864</element>
				<element value='1'>-0.839153</element>
			</position>
			<postcode>GU51</postcode>
		</pickup>
		<destination>
			<string>Aldershot, Hampshire, GU51</string>
			<position>
				<element value='0'>51.2554</element>
				<element value='1'>-0.767322</element>
			</position>
			<postcode>GU11</postcode>
		</destination>
		<price>13.64</price>
		<distance>5</distance>
		<people>1</people>
		<company_name>Taxi Company Name</company_name>
		<company_number>01234 567890</company_number>
		<status>Unconfirmed</status>
	</booking>
</TaxicodeResponse>

Array
(
    [status] => OK
    [booking] => Array
        (
            [reference] => TC12312312
            [date] => 2015-01-07 16:30:00
            [return] => 
            [pickup] => Array
                (
                    [string] => Fleet, Hampshire, GU51
                    [position] => Array
                        (
                            [0] => 51.2864
                            [1] => -0.839153
                        )

                    [postcode] => GU51
                )

            [destination] => Array
                (
                    [string] => Aldershot, Hampshire, GU51
                    [position] => Array
                        (
                            [0] => 51.2554
                            [1] => -0.767322
                        )

                    [postcode] => GU11
                )

            [price] => 13.64
            [distance] => 5
            [people] => 1
            [company_name] => Taxi Company Name
            [company_number] => 01234 567890
            [status] => Unconfirmed
        )

)

array(2) {
  ["status"]=>
  string(2) "OK"
  ["booking"]=>
  array(11) {
    ["reference"]=>
    string(10) "TC12312312"
    ["date"]=>
    string(19) "2015-01-07 16:30:00"
    ["return"]=>
    bool(false)
    ["pickup"]=>
    array(3) {
      ["string"]=>
      string(22) "Fleet, Hampshire, GU51"
      ["position"]=>
      array(2) {
        [0]=>
        float(51.2864)
        [1]=>
        float(-0.839153)
      }
      ["postcode"]=>
      string(4) "GU51"
    }
    ["destination"]=>
    array(3) {
      ["string"]=>
      string(26) "Aldershot, Hampshire, GU51"
      ["position"]=>
      array(2) {
        [0]=>
        float(51.2554)
        [1]=>
        float(-0.767322)
      }
      ["postcode"]=>
      string(4) "GU11"
    }
    ["price"]=>
    float(13.64)
    ["distance"]=>
    int(5)
    ["people"]=>
    int(1)
    ["company_name"]=>
    string(17) "Taxi Company Name"
    ["company_number"]=>
    string(12) "01234 567890"
    ["status"]=>
    string(11) "Unconfirmed"
  }
}

a:2:{s:6:"status";s:2:"OK";s:7:"booking";a:11:{s:9:"reference";s:10:"TC12312312";s:4:"date";s:19:"2015-01-07 16:30:00";s:6:"return";b:0;s:6:"pickup";a:3:{s:6:"string";s:22:"Fleet, Hampshire, GU51";s:8:"position";a:2:{i:0;d:51.2864;i:1;d:-0.83915300000000004;}s:8:"postcode";s:4:"GU51";}s:11:"destination";a:3:{s:6:"string";s:26:"Aldershot, Hampshire, GU51";s:8:"position";a:2:{i:0;d:51.255400000000002;i:1;d:-0.76732199999999995;}s:8:"postcode";s:4:"GU11";}s:5:"price";d:13.640000000000001;s:8:"distance";i:5;s:6:"people";i:1;s:12:"company_name";s:17:"Taxi Company Name";s:14:"company_number";s:12:"01234 567890";s:6:"status";s:11:"Unconfirmed";}}

Welcome to the Taxicode API

Overview

Global Parameters

Auth API

Request

Example Response

Booking API

Booking Quote

Quote Request

Quote Response

Quote Example Response

Booking Voucher Validation

Validation Request

Validation Response

Valid Voucher Response

Invalid Voucher Response

Create Booking Quote Checkout Session

Validation Request

Booking Quote Checkout Session Response

Booking Quote Checkout Session Created Response

Booking Quote Checkout Session Creation Error Response

Booking Payment Intent Client Gateway Secret

Payment Intent Client Gateway Secret Request

Payment Intent Client Gateway Secret Response

Payment Intent Client Gateway Secret Created Response

Payment Intent Client Gateway Secret Error Response

Booking Pay

Pay Request

Pay Response

Pay Example Response

Leave Customer Tip

Leave Customer Tip Request

Leave Customer Tip Response

Booking Journey

Journey Request

Journey Response

Booking State

State Request

State Response

Booking Resend

Resend Request

Resend Response

Booking Cancel

Resend Request

Resend Response

FAQ API

Categories

FAQ Categories Request

FAQ Categories Response

Category

FAQ Category Request

FAQ Category Response

Hints and Tips

Hints and Tips Request

Hints and Tips Response

Affiliate API

Affiliate Details

Affiliate Details Request

Affiliate Details Response

Affiliate Details Response

Affiliate Earnings

Affiliate Earnings Request

Affiliate Earnings Response

Affiliate Earnings Response

Affiliate Payment Due

Affiliate Payment Due Request

Affiliate Payment Due Response

Affiliate Earnings Response

Affiliate Booking Details

Affiliate Booking Details Request

Affiliate Booking Details Response

Affiliate Earnings Response