---
title: "Create a flash card request"
method: POST
path: "/v2/requests/flash_cards"
tags: ["Requests"]
---

# Create a flash card request

`POST /v2/requests/flash_cards`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/requests/flash_cards`
- Auth: OAuth 2
  - Authorization code: `https://oauth.qonto.com/oauth2/auth`
  - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `request_cards.write`

Note: this API is still in beta. Please get in touch with our team to know more:
https://getqonto.atlassian.net/servicedesk/customer/portal/5

OAuth scope: `request_cards.write`

---
Create a request of flash card that should be approved by a membership with permissions to review requests.

---
The response contains the created request.

## Headers

- `X-Qonto-Staging-Token` string

## Request body

- object
  - `request_flash_card` object
    - `note` string: Description of a nature of request. Helps approver to understand the reason of this request.
    - `payment_lifespan_limit` integer: Total of payment limit until card expires (unit: euro). Applicable only for Flash cards.
    - `pre_expires_at` string, date-time, nullable: Flash card will be valid until this date.

## Response `200`

OK

- object
  - `request_flash_card` RequestFlashCard: A virtual 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
    - `id` string, uuid: ID of the request
    - `request_type` 'flash_card': Type of the request
    - `status` 'pending' | 'approved' | 'declined' | 'canceled': Status of the request
    - `initiator_id` string, uuid: ID of the membership that initiated the request. <br>When the request is initiated through the API, the initiator is the authenticated membership.
    - `approver_id` string, uuid, nullable: ID of the membership that approved the request
    - `note` string: Reason for the request
    - `declined_note` string, nullable: Reason why the request was declined
    - `pre_expires_at` string, date-time: When the flash card expires
    - `payment_lifespan_limit` string: Total of payment limit until card expires
    - `currency` string: Currency of the card and its limits. ISO-4217 3-characters currency code
    - `processed_at` string, date-time, nullable: When request was approved, canceled or declined
    - `created_at` string, date-time: When request was created

## Other responses

- `400`: Returns a bad request error.
- `401`: Returns an unauthorized error.
- `403`: Returns a forbidden error.
- `422`: Returns an unprocessable entity error.

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)