Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-012382333.4 MB

Create a Card

post/cards

Request body

account_idstring required

The Account the card should belong to.

descriptionstring

The description you choose to give the card.

entity_idstring

The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.

Example request

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "description": "Card for Ian Crease"
}

Response

Card

account_idstring required

The identifier for the account this card belongs to.

created_atstring date-time required

The ISO 8601 date and time at which the Card was created.

descriptionstring nullable required

The card's description for display purposes.

entity_idstring nullable required

The identifier for the entity associated with this card.

expiration_monthinteger required

The month the card expires in M format (e.g., August is 8).

expiration_yearinteger required

The year the card expires in YYYY format (e.g., 2025).

idstring required

The card identifier.

idempotency_keystring nullable required

The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about idempotency.

last4string required

The last 4 digits of the Card's Primary Account Number.

status'active' | 'disabled' | 'canceled' required

This indicates if payments can be made with the card.

type'card' required

A constant representing the object's type. For this resource it will always be card.

Example response

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "authorization_controls": null,
  "billing_address": {
    "city": "New York",
    "line1": "33 Liberty Street",
    "line2": null,
    "postal_code": "10045",
    "state": "NY"
  },
  "created_at": "2020-01-31T23:59:59Z",
  "description": "Office Expenses",
  "digital_wallet": {
    "digital_card_profile_id": "digital_card_profile_s3puplu90f04xhcwkiga",
    "email": "user@example.com",
    "phone": "+16505046304"
  },
  "entity_id": null,
  "expiration_month": 11,
  "expiration_year": 2028,
  "id": "card_oubs0hwk5rn6knuecxg2",
  "idempotency_key": null,
  "last4": "4242",
  "status": "active",
  "type": "card"
}