# Errors Building with an AI agent? Start at https://docs.payme.io/agents.md ## Related - [Authentication and environments](/products-and-customers/getting-started/authentication) Every error returns a JSON body with these fields: | Field | Type | Description | |---|---|---| | `status_error_details` | string | What went wrong. Validation messages are in Hebrew unless you send `Accept-Language: en` (or add `?lang=en`). | | `status_error_code` | integer | `501` – a field failed validation (HTTP `400`). `999` – any other error. | | `validation_errors` | object | Validation errors only. Each key is a field name; its value maps each failed rule to a message. | | `status_additional_info` | string | Extra detail, when there is any. | | `session` | string | Trace id of the request. Quote it when you contact PayMe support. | | HTTP status | Meaning | |---|---| | `400` | Invalid input: a missing or invalid field, a body that isn't valid JSON, or a `guid` that isn't a UUID. | | `401` | Missing, invalid or expired access token, or a refresh token that is unknown, used or expired. See [Authentication and environments](/products-and-customers/getting-started/authentication#authentication). | | `404` | The product or customer doesn't exist, was deleted, or belongs to another seller. | | `409` | Another of the seller's products already uses that `product_remote_id`, or another customer that `customer_external_id`. | | `500` | Server error. Contact PayMe support and quote the `session`. | ```json { "status_error_details": "Field validation failed.", "validation_errors": { "items_per_page": { "max": "The value must be less than max amount." } }, "status_error_code": 501, "session": "f3a1c2b0-9e4d-11ef-8c1a-0242ac120002" } ```