Data Quality user documentation
home/Address validation/Address Validation REST/API reference/Standard response codes

Standard response codes

The following response codes can potentially be returned by all methods:

Status Code Description
400: Bad Request
(applicable to search-address and verify-address methods only)		 This code is returned when there is something wrong with the formatting of the request, i.e. bad syntax. It is normally accompanied by a message explaining what is wrong with the request in more detail. Sample messages/scenarios:
  • "The query property is required": missing the mandatory query parameter
  • "The query field is required": empty value for query
  • "The value <value> is not valid for skip": invalid value for skip
  • "The skip field must be a positive integer": negative integer for skip
  • "The value <value> is not valid for take": invalid value for take
  • "The take field must be a positive integer": negative integer for take
  • "This method does not support <country>": invalid method <country>
401: Unauthorized Returned when a user makes a request without being authenticated. This is normally associated with an invalid token. Sample messages/scenarios:
"Authentication has been denied for this request"
  • Missing/empty/invalid Auth-Token
  • The mandatory country parameter is missing/empty/invalid
  • Empty value for id
  • Your token is setup with the URL restriction via Self Service Portal > Licenses. Check the Permitted URL value.
403: Forbidden Returned when a user has authenticated but does not have permission to access the resource. This is normally associated with a token that is valid but not for the service being requested. Sample messages/scenarios:
"Authorization has been denied for this request": Token that is not entitled to use the product
404: Not Found
(applicable to address-layout method only)		 Returned when the server has not found anything matching the Request-URI. Sample messages/scenarios:
"The value '' is not valid for Id": Invalid value for id
500: Internal Server Error Returned when the server encountered an unexpected condition which prevented it from fulfilling the request. Sample messages/scenarios:
"Please contact Experian support.": Server encounters an unexpected condition
503: Service Unavailable The service is down for maintenance.
Address Validation REST

API reference