Error Codes
This table maps standard HTTP status codes to specific business rules in this API, helping you troubleshoot client-side integration issues:
Error Code Reference#
| HTTP status | API error code | Error type | Cause & remediation details |
|---|---|---|---|
| 400 Bad Request | BAD_REQUEST / INVALID_* | Validation | Triggered by invalid XML parsing, missing required elements/attributes, or failing validation rules downstream. Check syntax and constraints in table definitions. |
| 401 Unauthorized | UNAUTHORIZED | Validation | Missing or invalid credentials. The X-API-Key header is missing, empty, or does not exist in the platform repository. |
| 403 Forbidden | PARTNER_MISMATCH | Validation | The requested property code is already registered under a different partner. You are unauthorized to modify it. |
| 403 Forbidden | FORBIDDEN | Validation | The {propertyCode} in the URI exists in the database but is owned by a different partner company. |
| 403 Forbidden | NO_ACTIVE_SUBSCRIPTION | Validation | Required. The requested property does not have an active subscription. A platform administrator must first set up an active subscription (such as GOOGLE_HOTEL_SUBSCRIPTION or GOOGLE_FREE_BOOKING_LINKS) for this property before rate/availability pushes can be accepted. |
| 429 Too Many Requests | TOO_MANY_REQUESTS | RateLimit | Requests exceeded your configured transactions-per-minute threshold. Pause operations and check the Retry-After header for cooling duration. |
| 500 Server Error | SYSTEM_ERROR | Exception | An unhandled server-side database crash, mapping failure, or system failure occurred. Contact administrative support if it persists. |
| 502 Bad Gateway | Various errors | Exception | A connection breakdown or invalid format push while communicating downstream with Google's endpoint. Indicates the local save succeeded, but synchronization failed. |