Skip to main content
cURL
curl -X POST https://api.origoid.com/auth/token \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"expireAfter": 1800}'
{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Token issued",
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRfaWQiOiI...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "scope": "*"
  },
  "transactionId": "3eb33303-3466-4071-872e-067584149666",
  "processedAt": "2026-03-19T10:00:00-06:00",
  "billable": false
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
expireAfter
integer

Token lifetime in seconds. Optional. When omitted the gateway uses its configured default (currently 3600). Values outside [1, 3600] are rejected with OUT_OF_RANGE.

Required range: 1 <= x <= 3600
Example:

3600

Response

Token generated successfully.

​
status
enum<string>
required

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Available options:
OK,
ERROR
​
type
string
required

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

​
message
string
required

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

​
transactionId
string<uuid>
required

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

​
processedAt
string<date-time>
required

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

​
billable
boolean
required

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

​
data
object

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

​
errors
object[]

Per-field error details. Present only on INVALID_REQUEST responses.