Skip to main content
GET
/
v2
/
requests
List requests
curl --request GET \
  --url https://thirdparty.qonto.com/v2/requests \
  --header 'Authorization: Bearer <token>'
{
  "requests": [
    {
      "id": "965b8c57-72fd-4d12-8d85-56874104c81a",
      "request_type": "flash_card",
      "status": "pending",
      "initiator_id": "cc32875a-a590-44c7-bdc1-0680ae72b0db",
      "approver_id": "<string>",
      "note": "Library subscription",
      "declined_note": "<string>",
      "payment_lifespan_limit": "250.00",
      "pre_expires_at": "2022-03-15T22:59:59.999Z",
      "currency": "EUR",
      "processed_at": "<string>",
      "created_at": "2021-11-24T10:33:23.817Z"
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 11,
    "total_count": 210,
    "per_page": 20
  }
}

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.
Available options:
pending,
approved,
canceled,
declined
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.
Available options:
transfer,
multi_transfer,
flash_card,
virtual_card
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
​
meta
object
required

Metadata for paginated responses