Skip to main content

Error Handling

Upfront uses HTTP status codes to indicate the status of API requests. Generally:
  • 2xx indicates success
  • 4xx indicates something was wrong with the provided information
  • 5xx indicates something went wrong on Upfront’s servers

Error Response Format

All error responses follow a consistent format:
{
  "code": "error_code",
  "message": "A human-readable message explaining what went wrong"
}

Attributes

  • code (string): A machine-readable error code that can be used programmatically
  • message (string): A human-readable message providing more context about the error. These messages may change over time and should not be used programmatically.

Error Codes

Application Errors

CodeHTTP StatusDescription
invalid_address400The address provided could not be validated against the Google Address Validation API