---
title: "Create Card"
method: POST
path: "/v2/cards/"
tags: ["cards"]
---

# Create Card

`POST /v2/cards/`

## Request body

- CardIn — Banking card model used as route input
  - `exp_year` integer, required — Year expiration in YYYY format
  - `exp_month` integer, required — Month expiration in MM format
  - `customer` string — Customer to assign the card
  - `cvc` string — Card security code used to secure the transaction
  - `number` string, required — Card number
  - `preferred_network` 'national' | 'visa' | 'mastercard' — Card network to use for co-branded card
  - `zip_code` string — zip code in 2 to 8 digit format
  - `external_id` string — Unique id with unicity check
  - `name` string — custome name given to the card, often the card holder name
  - `tokenize` boolean — Define if card can be reused for future payments

## Response `200`

Successful Response

- CardOut — Banking card model used as route output
  - `customer` string — Associated customer
  - `brand` string, required — Card brand
  - `country` string, required — Country of the card issuer
  - `created` string, date-time, required — Date of creation in Epoch timestamp
  - `exp_month` integer, required — Month in MM format
  - `exp_year` integer, required — Year expiration in YYYY format
  - `external_id` string — Unique id with unicity check
  - `funding` 'credit' | 'debit' | 'prepaid' | 'universal' | 'charge' | 'deferred' | 'unknown' — An enumeration.
  - `id` string, required
  - `last4` string, required — Last 4 digit of the card number
  - `name` string — Custom name given to the card, often the card holder name
  - `nature` 'personal' | 'corporate' | 'unknown' — An enumeration.
  - `preferred_network` 'national' | 'visa' | 'mastercard'
  - `network` 'unknown' | 'national' | 'visa' | 'mastercard' — An enumeration.
  - `zip_code` string — Zip code in 2 to 8 digit format
  - `deleted` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stancer/apis/stancer-api.md) · [All operations](https://skmtc.dev/stancer/apis/stancer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stancer/stancer-api/revisions/c637e4c7ff04/schema)