Skip to main content
When a request fails, the Reserve Sense API returns an RFC 9457 problem document (application/problem+json). The type member is a URL on this page. Open it for what the error means. title is the short name of that type. detail is the message for this request.

Not authenticated

Type: https://docs.reservesense.com/api/errors#not-authenticated
Status: 401
The request did not include a valid Reserve Sense session. Sign in and retry. If you are already signed in, your session may have expired — sign in again.

Forbidden

Type: https://docs.reservesense.com/api/errors#forbidden
Status: 403
You are signed in but cannot perform this action. You do not have permission for this resource or organization. Switch accounts or ask an administrator.

Not found

Type: https://docs.reservesense.com/api/errors#not-found
Status: 404
The requested resource does not exist or is not visible to you. Check the ID and that you are in the right organization. The item may have been deleted.

Bad request

Type: https://docs.reservesense.com/api/errors#bad-request
Status: 400
The server could not read the request. The body or headers were malformed (for example, invalid JSON or a bad webhook signature). Fix the request and retry.

Validation

Type: https://docs.reservesense.com/api/errors#validation
Status: 422
A field in the request did not match the expected schema. detail names the field and the rule (required, format, range). Correct the field and retry. This is different from unprocessable, which is a business rule after the schema succeeds.

Unprocessable

Type: https://docs.reservesense.com/api/errors#unprocessable
Status: 422
The request was valid but cannot be applied. The fields parsed, but a business rule blocked the change — for example a report that is already complete, a missing related record, or a value that is not allowed in this context. Read detail for the rule. Schema failures use validation instead.

Conflict

Type: https://docs.reservesense.com/api/errors#conflict
Status: 409
The change conflicts with data that already exists. A unique value is already taken (for example a property number). Choose a different value.

Rate limited

Type: https://docs.reservesense.com/api/errors#rate-limited
Status: 429
A usage limit was reached. Wait and retry. AI generation services have a daily cap; other limits may apply.

Internal

Type: https://docs.reservesense.com/api/errors#internal
Status: 500
The request failed because of a server-side error. Retry later. If it continues, contact info@reservesense.com with the time of the request and what you were doing.

Unavailable

Type: https://docs.reservesense.com/api/errors#unavailable
Status: 503
A required service is temporarily down. A third-party dependency may be offline. Retry later.