The Explain Address Code API performs strict validation on all incoming requests to
ensure that each code can be decoded accurately and that the correct decoder logic is
applied. If any required fields are missing, incorrectly formatted, or inconsistent with
the selected codeType, the API returns a structured validation
error.
Below are the validation error codes that may be returned, along with what each one represents:
The table below includes a Condition column to clarify the expected behavior. Standard conditions, based on typical API functionality, are provided. You can adjust these conditions as needed to match your system's specific logic.
Error Codes
| Error Code | Condition | Details |
|---|---|---|
| DIS‑1001 | Unauthorized, Invalid token | Token is missing, malformed, or expired |
| DIS‑1002 | Not Authorized to access this API | Token is valid but lacks required permissions or scopes |
| DIS‑1003 | Issue with internal services | Internal dependency or service failure |
| DIS‑1004 | Workspace Id is missing from Bearer Token | Token does not include a workspace identifier |
| DIS‑1005 | Rate limit exceeded | Request count exceeds allowed rate limit |
| DIS‑1006 | Unauthorized, Invalid key/secret | API key or secret is incorrect or revoked |
| DIS‑1007 | API quota permanently exhausted for trial user | Trial user has consumed all allotted quota |
| DIS‑1009 | Access blocked due to too many failed attempts | Multiple consecutive authentication or request failures |
| DIS‑1010 | Workspace has expired | Workspace subscription or trial period has ended |
| DIS‑LI‑1011 | Service is not available to serve the request | Service is temporarily down or under maintenance |
| DIS‑LI‑1014 | Batch size must not exceed 25 | Request contains more than 25 items in a batch |
| DIS‑LI‑1037 | codeType is missing |
Returned when the request does not include the required
codeType field, so the API cannot determine
which decoder to use. |
| DIS‑LI‑1038 | Unsupported codeType value |
Triggered when codeType is provided but does not
match one of the supported values: GMC,
GLC, or GDI. |
| DIS‑LI‑1039 | code field missing |
Returned when an item in the codes[] array does
not include the required code field. |
| DIS‑LI‑1040 | GMC code format invalid | The provided Global Match Code does not meet the expected length or format rules for GMC. |
| DIS‑LI‑1041 | GLC code format invalid | The provided Global Location Code does not meet the expected length or format rules for GLC. |
| DIS‑LI‑1042 | GDI code format invalid | The provided Global Delivery Indicator does not meet the expected length or format rules for GDI. |