Skip to main content
GET
/
v2
/
requests
List requests
curl --request GET \
  --url https://thirdparty.qonto.com/v2/requests \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "current_page": 1,
    "next_page": null,
    "prev_page": null,
    "total_pages": 1,
    "total_count": 4,
    "per_page": 25
  },
  "requests": [
    {
      "id": "965b8c57-72fd-4d12-8d85-56874104c81a",
      "request_type": "virtual_card",
      "status": "pending",
      "initiator_id": "cc32875a-a590-44c7-bdc1-0680ae72b0db",
      "approver_id": null,
      "note": "Library subscription",
      "declined_note": null,
      "payment_monthly_limit": "5.00",
      "currency": "EUR",
      "processed_at": null,
      "created_at": "2021-11-24T10:34:51.706Z"
    },
    {
      "id": "fd6d72c0-557d-4d51-8502-d7ce86cb72ea",
      "request_type": "flash_card",
      "status": "canceled",
      "initiator_id": "dbbb579a-f8a5-41df-8cea-09e040464366",
      "approver_id": null,
      "note": "Restaurant",
      "declined_note": null,
      "pre_expires_at": "2022-03-15T22:59:59.999Z",
      "payment_lifespan_limit": "250.00",
      "currency": "EUR",
      "processed_at": "2021-11-24T10:33:59.965Z",
      "created_at": "2021-11-24T10:33:23.817Z"
    },
    {
      "id": "68e38bca-064c-4b50-8343-26ce40f617af",
      "request_type": "multi_transfer",
      "status": "approved",
      "initiator_id": "300d309f-a7e0-4db2-af3b-003ce0a676a4",
      "approver_id": "087a7f4f-d316-4bad-810f-84807634cb9f",
      "note": "Scheduled multi transfer (for Aug 2022)",
      "declined_note": null,
      "total_transfers_amount": "25561.80",
      "total_transfers_amount_currency": "EUR",
      "total_transfers_count": 43,
      "scheduled_date": "2022-08-15",
      "processed_at": "2021-11-24T10:34:51.706Z",
      "created_at": "2021-11-10T12:22:28.790Z"
    },
    {
      "id": "57d28d6f-3a22-4573-990a-c62d2f7d67f0",
      "request_type": "transfer",
      "status": "declined",
      "initiator_id": "dbbb579a-f8a5-41df-8cea-09e040464366",
      "attachment_ids": [],
      "approver_id": "788571b5-1aea-4aec-bb7b-366288a4ba68",
      "note": "Provider subscription",
      "declined_note": "This is not in our policy",
      "creditor_name": "John Doe",
      "amount": "30.00",
      "currency": "EUR",
      "scheduled_date": "2021-10-06",
      "recurrence": "monthly",
      "last_recurrence_date": null,
      "processed_at": "2021-10-06T16:14:28.284Z",
      "created_at": "2021-10-06T16:14:11.673Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

​
X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

​
status[]
enum<string>[]

Requests can be filtered by their status. This filter accepts an array of the following statuses: pending: a request still waiting for final status.

  • approved: a request that has been approved by approver. Final status.
  • declined: a request that has been declined by approver. Final status.
  • canceled: a request that has been canceled by requester. Final status.
Example:

"status[]=approved&status[]=declined&status[]=pending"

​
request_type[]
enum<string>[]

Requests can be filtered by their request_type. This filter accepts an array of the following statuses:

  • flash_card: 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_card: 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.
  • transfer: a transfer of money from one Qonto account to another account.
  • multi_transfer: several transfers executed at the same time. A document can be provided to create a multi-transfer which is composed of many different transfers.
Example:

"request_type[]=transfer&request_type[]=multi_transfer"

​
created_at_from
string<date-time>

Requests can be filtered by their created_at property. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

​
processed_at_from
string<date-time>

Requests can be filtered by their processed_at property. Please use a valid date time format (ISO 8601 for instance).

Example:

"2019-01-10T11:47:53.123Z"

​
sort_by
string
default:created_at:desc

Requests can be sorted by a specific property and order. Property: processed_at, created_at or status Order: asc (Ascending) / desc (Descending)

Do note: Sorting by status:asc returns a list of requests with statuses in the following order: pending, approved, declined, canceled.

​
page
string

Returned page (cf. Pagination).

​
per_page
string

Number of requests per page (cf. Pagination).

Response

Returns the list of requests.

​
requests
object[]
required
  • Option 1
  • Option 2
  • Option 3
  • Option 4
​
meta
object
required

Metadata for paginated responses