Nestoria API - Return Codes

response status codes

Starting with API version 1.18, we return two fields in the response called application_response_code and application_response_text which provide more information about the status of the request. These are returned for all requests using the search-listings method, and also for any request to the API where an invalid version has been specified. application_response_code is a three-digit number indicating the status, and application_response_text is a human-readable explanation of the current status.

search-listings method

request ok

Codes 100-199 indicate the request was valid, and the location was identified correctly.

application_response_code	application_response_text
100	listings returned for one unambiguous location	Location was recognised correctly.
101	listings returned for best guess of ambiguous location	The location specified was ambiguous, but we determined that one of the possible locations was more likely than the others. Alternative location names are also returned in this case.
110	listings returned, location very large	Location was specified correctly and listings were returned, but it was very large (e.g. if 'London' was specified). It may be useful in this case to specify a smaller location to return fewer listings. Please note it is only possible to retrieve the first 1000 listings from the API (see error 902).
111	guid(s) specified	One or more listing GUIDs were specified instead of a location, and the listings corresponding to these GUIDs were returned.

listings not returned (bad location)

Codes 200-299 indicate the location did not exist or was not specified correctly, but the request was otherwise valid.

application_response_code	application_response_text
200	ambiguous location	The location given was ambiguous and we could not determine which possibility to display listings for. The possible location names are returned in this case.
201	unknown location	The location given could not be found.
202	misspelled location	The specified location is not valid, but has a very similar spelling to one or more locations which are valid. Possible valid locations are returned in the response.
210	coordinate error	An error occurred while processing the specified coordinates. Please note requests to the API must be sent to the correct server for the country you want to retrieve listings for (see the page on API methods).

listings not returned (invalid request)

Codes 900-999 indicate the request was not formed correctly.

application_response_code	application_response_text
900	bad request	The request was invalid. When using the search_listings method, every request must specify either the location or listing GUIDs, but not both, otherwise this error will be returned.
901	pagination out of range	An invalid value was specified for the 'page' parameter. Allowed values are between 1 and the returned 'total_pages' value for the specific query.
902	pagination attempted to specify more than 1000th result	The pagination options were specified in such a way as to display more than the 1000th result. The API is limited to returning more than 1000 listings in one query.

internal error

Code 500 indicates an error due to an internal fault.

application_response_code	application_response_text
500	internal Nestoria error	An error occurred internally; please contact us with details of any request which caused this to be returned.

all methods

These response codes are returned for all API methods where the version is specified incorrectly in the request.

invalid version

application_response_code	application_response_text
910	unknown API version	An API version was specified which does not exist.
911	unsupported old API version	An API version was specified which is no longer supported.

Nestoria only displays listings provided under agreement with our partners.

Copyright © 2013 Lokku Ltd.