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. | 3.7 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 | ||