Sorts the order that Buggy Models are returned in (buggy_model_name). Use ASC for Ascending or DESC for Descending. If excluded, will default to ASC.
variants
Integer
Optional
0
Specify whether to return all Buggy Model variants e.g. return the black, red, green, yellow models instead of just returning the one model. Useful if you want to do price comparisons of all versions available, but generally speaking omitting this is all that would be needed. Use 1 to include, use 0 to exclude.
double
Integer
Optional
2
Specify where to return single occupancy buggy's only (0), double buggy's only (1) or all types (2).
shrink
Integer
Optional
0
Specify whether to use standard folded measurements or whether to use the smallest possible measurements (e.g remove wheels or handles). Note - if the manufacturer hasn't advised of removable components, the standard measurements will be used. Use 1 to use the smallest buggy dimensions, use 0 to use standard.
available
String
Optional
prices
Specify whether to return models where My Buggy My Car has found UK retailers currently selling each model. Use pricesto only show models that have a price. Use all to return all models regardless of availability. Note, this option is available regardless of whether your subscription plan offers pricing information.
Counts against quota: No
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=getbuggymodelslist&brandid=<BRANDID>&sort=<SORT>&double=<DOUBLE>&shrink=<SHRINK>variants=<VARIANTS>&available=<AVAILABLE>' \
--header 'Authorization: Basic YOUR_BASE64_KEY'
Sorts the order that Buggy Models are returned in (buggy_model_name). Use ASC for Ascending or DESC for Descending. If excluded, will default to ASC.
variants
Integer
Optional
0
Specify whether to return all Buggy Model variants e.g. return the black, red, green, yellow models instead of just returning the one model. Useful if you want to do price comparisons of all versions available, but generally speaking omitting this is all that would be needed. Use 1 to include, use 0 to exclude.
double
Integer
Optional
2
Specify where to return single occupancy buggy's only (0), double buggy's only (1) or all types (2).
shrink
Integer
Optional
0
Specify whether to use standard folded measurements or whether to use the smallest possible measurements (e.g remove wheels or handles). Note - if the manufacturer hasn't advised of removable components, the standard measurements will be used. Use 1 to use the smallest buggy dimensions, use 0 to use standard.
available
String
Optional
prices
Specify whether to return models where My Buggy My Car has found UK retailers currently selling each model. Use pricesto only show models that have a price. Use all to return all models regardless of availability. Note, this option is available regardless of whether your subscription plan offers pricing information.
Counts against quota: Yes
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=getbuggymodels&brandid=<BRANDID>&sort=<SORT>&double=<DOUBLE>&shrink=<SHRINK>variants=<VARIANTS>&available=<AVAILABLE>' \
--header 'Authorization: Basic YOUR_BASE64_KEY'
Sorts the order that Buggy Models are returned in (buggy_model_name). Use ASC for Ascending or DESC for Descending. If excluded, will default to ASC.
available
String
Optional
prices
Specify whether to return models where My Buggy My Car has found UK retailers currently selling each model. Use pricesto only show models that have a price. Use all to return all models regardless of availability. Note, this option is available regardless of whether your subscription plan offers pricing information.
Counts against quota: Yes
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=getvariants&buggyid=<BUGGYID>&sort=<SORT>&available=<AVAILABLE>' \
--header 'Authorization: Basic YOUR_BASE64_KEY'
An alternative to the carid parameter. A valid UK registered car Vehicle Registration Mark (Car Registration Number).
space
String
Optional
boot
brand
String
Optional
None
sort
String
Optional
brandASC,modelASC
Specify the sort order to return. You can specify one or both of brand or model e.g brandASC,modelDESC or in the singular modelASC (or any combination of these).
variants
Integer
Optional
0
Specify whether to return all Buggy Model variants e.g. return the black, red, green, yellow models instead of just returning the one model. Useful if you want to do price comparisons of all versions available, but generally speaking omitting this is all that would be needed. Use 1 to include, use 0 to exclude.
shrink
Integer
Optional
0
Specify whether to use standard folded measurements or whether to use the smallest possible measurements (e.g remove wheels or handles). Note - if the manufacturer hasn't advised of removable components, the standard measurements will be used. Use 1 to use the smallest buggy dimensions, use 0 to use standard.
double
Integer
Optional
2
Specify where to return single occupancy buggy's only (0), double buggy's only (1) or all types (2).
available
String
Optional
prices
Specify whether to return models where My Buggy My Car has found UK retailers currently selling each model. Use pricesto only show models that have a price. Use all to return all models regardless of availability. Note, this option is available regardless of whether your subscription plan offers pricing information.
Counts against quota: Yes (if the car is measured)
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=searchbycar&vrm=<VRM>brand=<OPTIONAL>&variants=<OPTIONAL>&double=<OPTIONAL>&shrink=<OPTIONAL>&space=<OPTIONAL>&sort=<OPTIONAL>&available=<OPTIONAL>' \
--header 'Authorization: Basic YOUR_BASE64KEY'
# alternatively replace vrm=<VRM> with carid=<CARID> to search by Car ID Number
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.mybuggymycar.com/api/search.php?s=searchbycar&vrm=<VRM>brand=<OPTIONAL>&variants=<OPTIONAL>&double=<OPTIONAL>&shrink=<OPTIONAL>&space=<OPTIONAL>&sort=<OPTIONAL>&available=<OPTIONAL>');
// alternatively replace vrm=<VRM> with carid=<CARID> to search by Car ID Number
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Authorization' => 'Basic YOUR_BASE64_KEY'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
import http.client
conn = http.client.HTTPSConnection("api.mybuggymycar.com")
payload = ''
headers = {
'Authorization': 'Basic YOUR_BASE64_KEY'
}
conn.request("GET", "/api/search.php?s=searchbycar&vrm=<VRM>brand=<OPTIONAL>&variants=<OPTIONAL>&double=<OPTIONAL>&shrink=<OPTIONAL>&space=<OPTIONAL>&sort=<OPTIONAL>&available=<OPTIONAL>", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
# alternatively replace vrm=<VRM> with carid=<CARID> to search by Car ID Number
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://api.mybuggymycar.com/api/search.php?s=searchbycar&vrm=<VRM>brand=<OPTIONAL>&variants=<OPTIONAL>&double=<OPTIONAL>&shrink=<OPTIONAL>&space=<OPTIONAL>&sort=<OPTIONAL>&available=<OPTIONAL>");
xhr.setRequestHeader("Authorization", "Basic YOUR_BASE64_KEY");
xhr.send();
// alternatively replace vrm=<VRM> with carid=<CARID> to search by Car ID Number
The above command returns JSON structured like this:
Compares the specified car and buggy to determine if the buggy will fit into the boot of the car.
The returned json includes confirmation of both the car and the buggy that was specified in the request.
The results array will detail a simple Yes/No response to "will the buggy fit". It also details 4 positions that the buggy might or might not fit.
In the event the results array returns "N/A", this likely indicates that the necessary boot measurements have not been collected yet. Check the boot_measurement_available value from the search array. A "Yes" confirms that this car can be used to use the buggy comparison APIs
Note: buggyid can be substituted by buggy brand, model and variant
URL Parameters
Parameter
Type
Required?
Default
Description
carid
Integer
Yes (or VRM)
N/A
vrm
String
Yes (or carid)
N/A
An alternative to the carid parameter. A valid UK registered car Vehicle Registration Mark (Car Registration Number).
buggyid
Integer
Yes
N/A
brand
String
Yes (alternate)
N/A
model
String
Yes (with brand)
N/A
variant
String
Yes (with brand)
N/A
space
String
Optional
boot
Select which boot measurements to use. You can use the getCar query to determine which measurements are available. Where possible, the API will substitute if measurements are unavailable. This will be advised in the response->message and results->error_messageOptions:boot - core boot measurements from boot floor to parcel shelf/top of rear seats
lower - use the are below the boot floor. Where this measurement is used, the boot floor is removable. Please note that the width and depth of the lower area are used which frequently give a smaller usable area despite the height increasing.
ceiling - uses the core boot measurements but assumes the parcel-shelf is removed and the space up the boot ceiling is usable.
max_height - combines the height of the lower boot and ceiling. As with the lower measurement, the width and depth of the lower area are also used which frequently gives a smaller usable area despite the height increase.
seats_flat - assumes the rear seats are folded flat
3rdboot - if a 3rd row of seats are available, this value specifies to use the space behind the 3rd row to the height of the seats / parcel-shelf.
3rdceiling - as with 3rd boot but extends to the height of the ceiling behind the 3rd row of seats.
shrink
Integer
Optional
0
Specify whether to use standard folded measurements or whether to use the smallest possible measurements (e.g remove wheels or handles). Note - if the manufacturer hasn't advised of removable components, the standard measurements will be used. Use 1 to use smallest buggy dimensions, use 0 to use standard.
Counts against quota: Yes (if car is measured)
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=buggyfit&carid=<CARID>&buggyid=<BUGGYID>&shrink=<OPTIONAL>&space=<OPTIONAL>' \
--header 'Authorization: Basic YOUR_BASE64_KEY'
# alternatively replace carid=<CARID> with vrm=<VRM> to search by Car Registration Number
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.mybuggymycar.com/api/search.php?s=buggyfit&carid=<CARID>&buggyid=<BUGGYID>&shrink=<OPTIONAL>&space=<OPTIONAL>');
// alternatively replace carid=<CARID> with vrm=<VRM> to search by Car Registration Number
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Authorization' => 'Basic YOUR_BASE64_KEY'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("GET", "https://api.mybuggymycar.com/api/search.php?s=buggyfit&carid=<CARID>&buggyid=<BUGGYID>&shrink=<OPTIONAL>&space=<OPTIONAL>");
xhr.setRequestHeader("Authorization", "Basic YOUR_BASE64_KEY");
xhr.send();
// alternatively replace carid=<CARID> with vrm=<VRM> to search by Car Registration Number
[VRM] can be replaced with a valid [CARID] that can be obtained by using the Car ID Lookup queries. Note, if both are supplied, vrm will be taken in preference. YOUR_BASE64_KEY needs to be replaced with your API key.
The above command returns JSON structured like this:
This call might be helpful if you want to see whether a buggy will fit into space in your home (a cupboard under the stairs for example), or if you want to check if your buggy is allowed as carry-on when travelling on a plane.
The call compares the folded dimensions of the specified buggy to the dimensions you specify, to determine if the buggy will fit into that space.
The returned json includes confirmation of both the buggy and the dimensions that were specified in the request.
The results array will detail a simple Yes/No response to "will the buggy fit". It also details 4 positions that the buggy might or might not fit.
Specify whether to use standard folded measurements or whether to use the smallest possible measurements (e.g remove wheels or handles). Note - if the manufacturer hasn't advised of removable components, the standard measurements will be used. Use 1 to use the smallest buggy dimensions, use 0 to use standard.
width
Integer
Yes
N/A
Specify the width in cm of the space you want the buggy to fit in to
height
Integer
Yes
N/A
Specify the height in cm of the space you want the buggy to fit in to
depth
Integer
Yes
N/A
Specify the depth in cm of the space you want the buggy to fit in to
Counts against quota: Yes (if car is measured)
curl --location --request GET 'https://api.mybuggymycar.com/api/search.php?s=buggyfitotherbuggyid&<BUGGYID>&shrink=<SHRINK>&width=<WIDTH>&height=<HEIGHT>&depth=<DEPTH>' \
--header 'Authorization: Basic YOUR_BASE64_KEY'
Make sure to replace <WIDTH>, <HEIGHT> and <DEPTH> with a positive value in cm, BUGGYID with a valid Buggy Model ID and YOUR_BASE64_KEY with your API key.
The above command returns JSON structured like this:
Get the Buggy Models for a given Buggy Brand ID. This provides a limited result array and is intended to support searching/identification of a buggy e.g. perhaps for use in a Drop Down List. For more detailed buggy responses, use .
The Brand ID should match a value returned from the call.
Optionally you can specify the sort order that the buggy models should be returned in and also whether to include the variants of a given buggy model. You could also make use of the call to subsequently return a list of model variants if needed.
A valid Buggy Brand ID. Use to identify a valid ID
Get the Buggy Models for a given Buggy Brand ID. This provides the same results as the query above, but this returns more detailed information (including image links) for each buggy.
The Brand ID should match a value returned from the call.
Optionally you can specify the sort order that the buggy models should be returned in and also whether to include the variants of a given buggy model. You could also make use of the call to subsequently return a list of model variants if needed.
A valid Buggy Brand ID. Use to identify a valid ID
The Buggy Model ID should match a value returned from the or call. Alternatively you can specify the Buggy Brand and Model name as defined in and the or calls
A valid Buggy Model ID. Use to identify a valid ID. Alternatively, specify brand name and model name
URL encoded brand name as defined in
URL encoded model name as defined in or
Note, the carid must be identified using the searches. Alternatively, you could use the vrm parameter which will perform this lookup.
A valid carid. The carid corresponds to a car id that can be identified using the searches. Alternatively, use the vrm parameter
Select which boot measurements to use. You can use the query to determine which measurements are available. Where possible, the API will substitute if measurements are unavailable. This will be advised in the response->message and results->error_messageOptions:boot - core boot measurements from boot floor to parcel shelf/top of rear seats
lower - use the are below the boot floor. Where this measurement is used, the boot floor is removable. Please note that the width and depth of the lower area are used which frequently give a smaller usable area despite the height increasing.
ceiling - uses the core boot measurements but assumes the parcel-shelf is removed and the space up the boot ceiling is usable.
max_height - combines the height of the lower boot and ceiling. As with the lower measurement, the width and depth of the lower area are also used which frequently gives a smaller usable area despite the height increase.
seats_flat - assumes the rear seats are folded flat
3rdboot - if a 3rd row of seats is available, this value specifies to use the space behind the 3rd row to the height of the seats / parcel-shelf.
3rdceiling - as with 3rd boot but extends to the height of the ceiling behind the 3rd row of seats.
The name of a buggy brand. If specified, the query will only return results for this brand. A list of buggy brands can be obtained from
[VRM] can be replaced with a valid [CARID] that can be obtained by using the queries. Note, if both are supplied, vrm will be taken in preference. YOUR_BASE64_KEY needs to be replaced with your API key.
Note, the carid must be identified using the searches. Alternatively, you could use the vrm parameter which will perform this lookup.
A valid carid. The carid corresponds to a car id that can be identified using the searches. Alternatively, use the vrm parameter
A valid Buggy Model ID. Use to identify a valid buggy ID
URL encoded brand name as defined in
URL encoded model name as defined in or
URL encoded variant name as defined in either or or
A valid Buggy Model ID. Use to identify a valid ID
URL encoded brand name as defined in
URL encoded model name as defined in or
URL encoded variant name as defined in either or or
