{
  "code": "invalid_phone_number",
  "doc_url": "https://docs.ding.live/api/error-handling#invalid_phone_number",
  "message": "+0 is not a valid phone number"
}

Ding uses conventional HTTP statuses to indicate the success or failure of a request:

  • Codes within the 2xx range indicate success.
  • Codes in the 4xx range indicate an error that failed given the information provided (e.g. required parameter was omitted or an authentication failed).
  • Codes in the 5xx range indicate an error with Ding’s servers (these are rare).
code
enum<string>

A machine-readable code that describes the error. Possible values are:

  • invalid_phone_number - This is not a valid E.164 number.
  • internal_server_error - An internal server error occurred.
  • bad_request - The request was malformed.
  • account_invalid - The customer UUID you provided is invalid.
  • negative_balance - You have a negative balance.
  • invalid_line - Ding does not support this type of phone number.
  • unsupported_region - Ding does not support this region yet.
  • invalid_auth_uuid - The authentication UUID you provided is invalid.
  • blocked_number - The phone number you provided is in the blocklist.
  • invalid_app_version - The app version you provided is invalid.
  • invalid_os_version - The OS version you provided is invalid.
  • invalid_device_model - The device model you provided is invalid.
  • invalid_device_id - The device ID you provided is invalid.
Available options:
invalid_phone_number,
internal_server_error,
bad_request,
account_invalid,
negative_balance,
invalid_line,
unsupported_region,
invalid_auth_uuid,
invalid_app_realm,
unsupported_app_realm_device_type,
app_realm_require_device_type,
blocked_number,
invalid_app_version,
invalid_os_version,
invalid_device_model,
invalid_device_id
doc_url
string

A link to the documentation that describes the error.

message
string

A human-readable message that describes the error.