Errors

An error response always has the shape { "error": { "type", "message", "code", "request_id" } }. type is one of a fixed set of machine-readable values (see the Errors group's Error codes page); message is human-readable and may change wording over time — never parse it.

request_id identifies the exact request in SamaPrime's own logs — include it when contacting support about a specific failed call.

See the Errors group below for the full status/type table and how to deliberately trigger each one in your test environment.