Errors | Deel. PayAndBill API Documentation

The Deel. PayAndBill API uses standard HTTP status codes to indicate the success or failure of a request.

Status Codes

Status Code	Meaning	Description
`200`	OK	The request succeeded.
`201`	Created	A new resource was created successfully.
`400`	Bad Request	The request was invalid. Check required fields and validation rules.
`401`	Unauthorized	Authentication failed. The token is missing, invalid, or expired.
`404`	Not Found	The requested resource does not exist. Verify the ID or UUID.
`429`	Too Many Requests	Rate limit exceeded. See Rate Limits for details.
`500`	Internal Server Error	An unexpected error occurred on the server.

Returned when creating or updating a record and not all required values are present, or when any other validation fails.

1 {
2   "error": "Bad Request",
3   "message": "Validation failed: entityName is required"
4 }

Returned when the request does not include a valid Bearer token or the token has expired.

If you receive a 401 response, re-authenticate using the OAuth Token Exchange endpoint or refresh your token.

Returned when the requested resource could not be found (e.g. incorrect UUID).

The response body is typically empty.

Returned when the rate limit has been exceeded. Check the X-RateLimit-Reset header for when you can resume making requests.