Get a limit increase request

GET

https://client.api.corpx.com/v1/accounts/:accountId/limit-requests/:requestId

GET

/v1/accounts/:accountId/limit-requests/:requestId

curl https://client.api.corpx.com/v1/accounts/accountId/limit-requests/requestId \
     -H "X-Content-SHA256: X-Content-SHA256" \
     -H "X-Request-Signature: X-Request-Signature" \
     -H "X-Request-Timestamp: X-Request-Timestamp" \
     -H "X-Tenant-Id: X-Tenant-Id" \
     -H "Authorization: Bearer <token>"

{
  "id": "lr_01J9XQ8K2M3N4P5Q6R7S8T9U0V",
  "status": "approved",
  "operation": "pix_out",
  "window": "daytime",
  "currentLimitBrl": 20000,
  "requestedLimitBrl": 50000,
  "justification": "Folha de pagamento do mês.",
  "identifier": "3f1c0b6e-9a2d-4c71-8e55-1b7a0d4c9e21",
  "createdAt": "2026-10-02T18:00:01Z",
  "approvedLimitBrl": 40000,
  "decisionMessage": "Aprovado parcialmente.",
  "effectiveAt": null,
  "events": [
    {
      "at": "2026-10-02T18:00:01Z",
      "status": "pending_review",
      "message": "Pedido recebido."
    },
    {
      "at": "2026-10-02T19:10:00Z",
      "status": "approved",
      "message": "Aprovado parcialmente."
    }
  ]
}

One request plus the public timeline. Reviewer-only notes are omitted.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired

Account identifier.

requestIdstringRequired

Limit request id (lr_ + ULID).

Headers

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

Response

The request and its public events.

idstring

statusenum

Allowed values:

operationenum

Allowed values:

windowenum

Allowed values:

currentLimitBrldouble

Effective ceiling when the request was opened. 0 when the account had none.

requestedLimitBrldouble

justificationstring

identifierstring

createdAtdatetime

approvedLimitBrldouble or nullOptional

Ceiling actually applied. Null until approval. May differ from requestedLimitBrl when the reviewer adjusts it.

decisionMessagestring or nullOptional

effectiveAtdatetime or nullOptional

When the new ceiling starts. Null means it was applied immediately.

eventslist of objectsOptional

Errors

404

Not Found Error