Cookie

We use cookies to improve your experience on our site, and to provide a live chat feature. To find out more please read our privacy policy.

Skip to content

Troubleshooting

We've created this page to help you resolve common issues but contact us if you need any help.

Check HTTP status codes

Postcoder responds to each request with one of several HTTP status codes shown below. We recommend your check the status within your integration and handle it accordingly. Note, an HTTP status code of 200 indicates a request was successful but does not imply that results - such as addresses - were found.

HTTP status codeDescription
200The request was successful
400An issue with the contents of the request (e.g. a required parameter is missing)
403An issue with the API key or account (e.g. the API key is invalid or there are insufficient credits for the request)
404An issue with the structure of the request (e.g. the endpoint does not exist)
500An issue with Postcoder, which we will likely already be working to resolve

Check credits remaining with an API call

Use the status or status/creditsabovethreshold endpoints to programmatically check how many credits remain on your API key. Alternatively, go to the Credit pack management page to see the same information.

Segment usage on your API key

When using your API key across multiple websites, apps or clients, you may need to know how many requests each one has made. You can determine this by setting the identifier querystring parameter of each request to a meaningful value such as "websiteA" or "client123". You'll then be able to view these identifiers and the number of requests made by each one on the Identifier Usage page.

Example request with no identifier:

GET https://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/email/sales%40alliescomputing.com?format=json

Example request with an identifier of "websiteA":

GET https://ws.postcoder.com/pcw/PCW45-12345-12345-1234X/email/sales%40alliescomputing.com?format=json&identifier=websiteA

View recently recorded errors

Go to the Error reports page to view recently recorded errors from requests made using your API key.

Resolve 403 errors

Here's how to resolve some 403 errors that you may encounter during integration:

Browser direct lookups exceeded, retry later
This means you've exceeded the default rate limit of 5 requests from any one IP address in 5 minutes. Manage the security settings for your API key to increase the limit, and review the API key security page to ensure you have the optimum security settings in place.

The server IP address is not registered
This indicates a request was made from an IP address that is not on your trusted IP address list. Manage the security settings for your API key to add the IP address or IP address range, and review the API key security page to ensure you have the optimum security settings in place.

Account doesn't have access to required datasets
This error occurs when your API key is used to make a request for a dataset or feature that is not currently enabled on your API key. Some datasets such as Eircode and AddressBase and features like email and mobile validation need to be enabled before they can be used. Visit the Features page to enable access.

Configure your firewall and security layers

You can allow Postcoder through your firewall and security layers by allow-listing the domain of ws.postcoder.com.

We do not recommed allow-listing by IP address since Postcoder is load-balanced across multiple IP addresses which change frequently.

Reset your lost password

Go to the Reset password page to update your password if you've forgotten it.

Change your email address

Go to your User profile to change your email address if you're still able to log into your account.

Contact us if you've forgotten the email address associated with your account, or if you no longer have access to it.

Please understand that we will need to verify your identity and details to ensure you are the rightful owner before any changes can be made.