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 code | Description |
|---|---|
| 200 | The request was successful |
| 400 | An issue with the contents of the request (e.g. a required parameter is missing) |
| 403 | An issue with the API key or account (e.g. the API key is invalid or there are insufficient credits for the request) |
| 404 | An issue with the structure of the request (e.g. the API endpoint does not exist) |
| 500 | An 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 API 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
You can use identifiers to see how many requests come from different pages or features of your website or app. See Account types for how to set this up.
Use Postcoder with other organisations
If you provide a solution that's used by other organisations, you can use a SAME account or a partner account to identify usage per organisation and comply with licensing. See Account types for the full comparison and setup steps.
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 recommend 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.