Approve Card Request

post

https://partner-api.getpliant.com/api/cards/requests/{cardRequestId}/approve

🔒
Required scope: cards:write
The API credential calling this endpoint must be granted the cards category with read & write access.
Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.
A credential without this scope receives 403 Forbidden with the error code INSUFFICIENT_PERMISSION.

Approve a card request created by a cardholder. Optional body parameters can be used to override originally requested values.

This endpoint has changed in comparison to the previous version of the API. The following changes were made:

changed the HTTP response code to 202 Accepted and removed the response body, to reflect the asynchronous nature of this endpoint

Path Params

cardRequestId

uuid

required

The unique identifier of the card request.

Body Params

approvedBy

uuid

required

approvedTransactionLimit

object

approvedMonthlyLimit

object

deprecated

Use approvedLimit instead.

approvedLimit

object

limitRenewFrequency

string

enum

DAILY - The card limit is renewed every day
WEEKLY - The card limit is renewed every week
MONTHLY - The card limit is renewed every calendar month
QUARTERLY - The card limit is renewed every calendar quarter
ANNUAL - The card limit is renewed every year
TOTAL - The card limit is never going to be renewed. After the limit is spent the card cannot be used anymore.

Allowed:

approvedValidityPeriod

integer

validity period of card up to 36 months

label

string | null

Available only for virtual cards with a cardConfig containing VIRTUAL or TRAVEL. The maximum length is 40 characters.

comment

string

length between 0 and 200

cardControls

object

Responses

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Choose an example:

application/json

202Accepted. The request was successful, please wait until the callback is triggered, since this is an asynchronous operation.

400Bad Request. The API consumer sent a malformed request which could not be processed.

401Unauthorized. The API consumer is not authorized to access the requested resource.

403Forbidden. The API consumer is not allowed to access the requested resource.

404Not Found. The requested resource could not be found.

429Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our API guidelines.

500Internal Server Error. The request was not completed due to an internal error.