---
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`

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.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/revisions/25208d6f9deb/schema)