Skip to navigation

Cancel a limit increase request

Cancels a request that is still pending_review. Any other status is 409 limit_request_closed. Sends limit_request.updated.

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-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Acting-DocumentstringOptional

CPF of the human performing the operation. Required on cashout routes when the credential enforces a transaction PIN. On a company P2P profile contact, this CPF is the holder who signs; it is not taken from the body.

X-Acting-IpstringOptional

Real IP of the end user, for integrator credentials calling on their behalf. This is the IP evaluated against cashoutSourceIps — without it the check would see your server’s IP. Ignored for delegated credentials, where the connection IP is already the right one.

X-Acting-User-AgentstringOptional<=512 characters

Optional user-agent of the end user’s browser or app, for integrator credentials calling on their behalf. Feeds risk analysis only: an invalid or oversized value is dropped and the payment still proceeds. Ignored for delegated credentials.

X-Acting-Device-IdstringOptional<=128 characters

Optional device fingerprint or identifier from the integrator’s own system. Risk analysis only; never required and never a reason to reject the payment. Ignored for delegated credentials.

X-Acting-Session-IdstringOptional<=128 characters

Optional session id of the end user in the integrator’s system. Risk analysis only; never required and never a reason to reject the payment. Ignored for delegated credentials.

X-Acting-GeostringOptional

Optional latitude,longitude in decimal degrees. Out of range or malformed values are dropped. Risk analysis only. Ignored for delegated credentials.

Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

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.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Response

The cancelled request.
idstring
statusenum

awaiting_documents is outside the queue until submit. info_requested means the reviewer asked for more and the 7-day window restarted.

operationenum
Allowed values:
windowenum
Allowed values:
currentLimitBrldouble

Effective ceiling when the request was opened, including a previous-register (legacy) ceiling. 0 only when that window was open (no ceiling).

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.
documentsDueAtdatetime or nullOptional
Deadline to submit documents or the reply to an information request. Null on requests opened before this field existed.
submittedAtdatetime or nullOptional
When the holder submitted the request into the review queue.
bundleobjectOptional
Operations opened together. The bundle ID is the first request ID.
skippedlist of objectsOptional
Operations not opened in this bundle.

Errors

404
Not Found Error
409
Conflict Error