v2

latestOpenAPI 3.0.3raw.githubusercontent.com2025-01-245593419.2 KB
Requests

Approve a request

OAuth scope: request_review.write

Accessible only using Strong Customer Authentication.

<!-- theme: none -->

💡 Example of SCA usage: Postman visual flow


This endpoint allows you to approve a pending request. You can ge the list of all requests via GET /v2/requests.

Inside Qonto, requests can be listed and approved in the Requests tab.

The impacted request will change status from status = pending to status = approved.


request_type can take 4 different values:

  • flash_cards: a flash card is a non-physical card with a budget and a last day of validity. The card becomes inactive after the budget is totally spent or the last date of validity is past.
  • virtual_cards: a virtual card is a non-physical card with a monthly budget. Card holder can spend that amount every calendar month. Above that, transactions will be refused.
  • transfers: a transfer of money from one Qonto account to another account.
  • multi_transfers: several transfers executed at the same time. A document can be provided to create a multi-transfer which is composed of many different transfers.
post/v2/requests/{request_type}/{id}/approve

Path parameters

idstring required

UUID of the request to be processed.

request_type'flash_cards' | 'virtual_cards' | 'transfers' | 'multi_transfers' required

Type of a request to be approved.

Headers

X-Qonto-Idempotency-Keystring uuid required

The API supports idempotency for safely retrying requests without accidentally performing the same operation twice.

X-Qonto-Staging-Tokenstring

Required only for Sandbox API requests; to get one, please submit the following form: https://getqonto.atlassian.net/servicedesk/customer/portal/5/group/47/create/143.

Request body

debit_ibanstring uuid

Example request

{
  "debit_iban": "FR7616958000019475096658493"
}

Response

returns a success status code

Example response

{
  "request_transfer": {
    "id": "be160c90-058e-487a-b775-5b5cad3992aa",
    "request_type": "transfer",
    "initiator_id": "8fdb86eb-8e49-4be8-ab60-658b680629af",
    "approver_id": null,
    "note": "personal needs",
    "declined_note": null,
    "status": "approved",
    "currency": "EUR",
    "processed_at": null,
    "created_at": "2021-10-11T14:28:28Z"
  }
}