Calls to the API must be for genuine use and responses from the API must not be stored for the purpose of creating an offline copy of the information stored. Failure to comply with this requirement will infringe the API License.
Make & Model Extended API Calls
Make Model Extended
POST /makemodelext
Purpose
To return the make and model of a product using the supplied serial number.
Inputs
- storeid - This must be a valid API store ID and is used to identify the store requesting the make and model information.
- serials - An array of serial numbers. Serial numbers must consist only of alpha-numeric characters (a-z and 0-9) and be at least 3 characters in length.
-
category - OPTIONAL - A numeric category number to identify the type of product the serial relates to. This defaults to 1. Setting this
to 0 (zero) will perform the search on all product categories. At present this method supports the following product categories:-
Supported Categories
Example Request
curl -H 'Accept: application/json' \
-u 123:XXXXXXXXXXXXXXXXXXXXXX \
https://gapi.checkmend.com/makemodelext
{
"storeid": 1,
"category": 1,
"serials": ["012341234512340"]
}
Output
A JSON object containing the make and model of the handset. In the event of an error a JSON object containing an errors array will be returned. For details on the errors array please read the Errors page.
Example Response
Response with matches:HTTP/1.1 200 OK Content-Type: application/json { "makes":[ { "make":"APPLE", "category":1, "serials": ["012341234512340"], "models":[ { "name":"IPHONE 5", "colour":"BLACK", "storage":"32GB", "modelreference":"REFIP5432" },{ "name":"IPHONE 5", "colour":"WHITE", "storage":"32GB", "modelreference":"REFIP5W32" },{ "name":"IPHONE 5", "colour":"BLACK", "storage":"64GB", "modelreference":"REFIP5B64" },{ "name":"IPHONE 5", "colour":"WHITE", "storage":"64GB", "modelreference":"REFIP5W64" } ] } ] }
Response with no matches:HTTP/1.1 400 Bad request Content-Type: application/json { "makes": [ ] }