Credit costs
Each request to a Postcoder endpoint costs one or more credits as shown below.
Buy a credit pack or set up a monthly plan to add credits to your account.
Feature | Endpoint | Standard request Enhanced request (if applicable) Enhanced requests return additional fields; see "Additional response fields" for applicable endpoints in the API reference | ||
---|---|---|---|---|
Address lookup | UK and international | address Returns one or more full addresses for a given postcode or part of an address. Supports over 240 countries and provides UK postcode lookup, Irish Eircode lookup and global address lookup. | UK | 2.0 credits 2.4 credits |
Ireland | 4.5 credits 4.5 credits | |||
Rest of world | 2.0 credits | |||
autocomplete/find Returns one or more address suggestions as a UK or Irish address is being typed. | UK | 0 credits | ||
Ireland | ||||
autocomplete/retrieve Returns the full address for a given suggestion ID returned by the /autocomplete/find endpoint above. | UK | 2 credits 2.4 credits | ||
Ireland | 4.5 credits 4.5 credits | |||
udprn Returns the full address for a given Royal Mail UDPRN. | 2.0 credits 2.4 credits | |||
street Returns one or more street addresses for a given UK postcode. | 1.5 credits 1.9 credits | |||
nyb Returns one or more Royal Mail Not Yet Built addresses for a given UK postcode. | 1.8 credits 2.2 credits | |||
position Returns the coordinates for a given UK postcode or Irish Eircode. | UK | 0.9 credits | ||
Ireland | 4.5 credits | |||
rgeo Returns one or more street / full addresses for a given coordinate position in the UK or Ireland. | UK | 0.9 credits | ||
Ireland | 4.5 credits | |||
AddressBase | addressbase Returns one or more property records with an associated Delivery Point Address (DPA) record that matches a given postcode or part of an address. | 3.5 credits | ||
pafaddressbase Returns one or more Royal Mail PAF addresses for a given postcode or part of an address, enriched with data from the associated property records. | 4.5 credits | |||
addressbase/uprn Returns the property record for a given Ordnance Survey UPRN. | 3.5 credits | |||
addressbase/dpa Returns one or more property records with an associated Delivery Point Address (DPA) record that matches a given postcode or part of an address. | 3.5 credits | |||
addressbase/lpi Returns one or more property records with an associated Local Property Identifier (LPI) record that matches a given postcode or part of address. | 3.5 credits | |||
addressbase/dpalpi Refer to the addressbase/lpi endpoint which now works in the same way as this original endpoint. | 3.5 credits | |||
Rooftop geocoding | pafaddressbase Returns one or more full addresses in the UK for a given postcode or part of an address, with rooftop coordinates in England, Scotland and Wales, and postcode coordinates in Northern Ireland. | 4.5 credits | ||
addressbase Returns one or more full addresses in Great Britain for a given postcode or part of an address, with rooftop coordinates in England, Scotland and Wales. | 3.5 credits | |||
address/ie Returns one or more full addresses in Ireland for a given Eircode or part of an address, all with rooftop coordinates. | 4.5 credits | |||
Bank validation | bank Returns a true or false for valid and provides details about the bank and branch. | 1.2 credits | ||
Email validation | email Returns a true or false for valid and provides alternative spelling suggestions and disposable email detection. | 1.2 credits | ||
Mobile validation | mobile Returns a true or false for valid and provides details about the number and network provider. | 1.2 credits | ||
OTP verification | otp/send Sends an OTP text message to a user's UK mobile phone number. | 4.5 credits | ||
otp/verify Checks the OTP provided to you by the user and returns a true or false . | 0 credits | |||
Health status | status Returns service information and the settings associated with a given API key. | 0 credits |