API Testing

Listed below is a brief list of available test methods for our core API endpoints.

Test requests do not require you to purchase lookups and they do not drain any existing balance.


Postcodes

Postcode to Addresses

GET /postcodes/:postcode
Postcode Parameter Response
ID1 1QD Successful postcode lookup response (2000)
ID1 KFA Postcode does not exist error (4040)
ID1 CLIP No lookups remaining error (4020)
ID1 CHOP Limit breach error. Either daily or individual lookup limit has been reached (4021)

Addresses

Address Search

GET /addresses?query=:query
Address Query Response
ID1 1QD Successful query response (2000)
ID1 KFA Empty query response (2000)
ID1 CLIP No lookups remaining error (4020)
ID1 CHOP Limit breach error. Either daily or individual lookup limit has been reached (4021)

UDPRN (Address ID) to Address

GET /addresses/:udprn
UDPRN Parameter Response
0 Successful UDPRN lookup response (2000)
-1 UDPRN not found error (4040)
-2 No lookups remaining error (4020)
-3 Limit breach error. Either daily or individual lookup limit has been reached (4021)
-10 Successful UDPRN lookup response (2000)
-11 Successful UDPRN lookup response (2000)

Autocomplete

Autocomplete Address

GET /autocomplete/addresses?query=:query
Autocomplete Query Response
ID1 1QD Returns a successful autocomplete response where associated UDPRNs resolve to the test UDPRNs listed above