---
title: "POST /user/{userID}/card-credit"
method: POST
path: "/user/{userID}/card-credit"
tags: ["card-credit"]
---

# POST /user/{userID}/card-credit

`POST /user/{userID}/card-credit`

Create a new credit card request.

## Path parameters

- `userID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- CardCredit
  - `first_line` string — The first line of text on the card, used as name/description for it. It can contain at most 17 characters and it can be empty.
  - `second_line` string, required — The second line of text on the card, used as name/description for it. It can contain at most 17 characters and it can be empty.
  - `name_on_card` string, required — The user's name as it will be on the card. Check 'card-name' for the available card names for a user.
  - `preferred_name_on_card` string — The user's preferred name that can be put on the card.
  - `alias` Pointer
    - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
    - `value` string — The alias value.
    - `name` string — The alias name.
    - `service` string — The pointer service. Only required for external counterparties.
  - `type` string, required — The type of card to order. Can be MASTERCARD.
  - `product_type` string, required — The product type of the card to order.
  - `pin_code_assignment` CardPinAssignment[] — Array of Types, PINs, account IDs assigned to the card.
    - `type` string — PIN type. Can be PRIMARY, SECONDARY or TERTIARY
    - `routing_type` string — Routing type.
    - `pin_code` string — The 4 digit PIN to be assigned to this account.
    - `monetary_account_id` integer — The ID of the monetary account to assign to this pin for the card.
    - `status` string — The status of the card pin assignment.
  - `monetary_account_id_fallback` integer — ID of the MA to be used as fallback for this card if insufficient balance. Fallback account is removed if not supplied.
  - `order_status` string — The order status of this card. Can be CARD_REQUEST_PENDING or VIRTUAL_DELIVERY.

## Response `200`

With bunq it is possible to order credit cards that can then be connected with each one of the monetary accounts the user has access to (including connected accounts).

- CardCreditCreate
  - `Id` BunqId
    - `id` integer — An integer ID of an object. Unique per object type.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/versions/369477c7bd26/schema)