> For the complete documentation index, see [llms.txt](https://docs.cardspro.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cardspro.com/api/cards/issue-new-card.md).

# Issue New Card

Issues a new card for the authenticated user.

**Endpoint:** `POST /issue`

**Content-Type:** `application/json`

**Request Body:**

```json
{
  "productCode": "B0067bd6bf2b2604be25e9821b0",
  "request_id": "request-id-12345",
  "amount": 25,
  "currency": "USD",
  "cardValidityYears": 3,
  "preferredAccount": "string",
  "cardName": "My New Card",
  "firstName": "Jimmy",
  "lastName": "Taylor",
  "kycUuid": "259da80d-455b-421a-9d7b-152c4937457f"
}
```

**Request Parameters:**

<table><thead><tr><th width="174.99993896484375">Field</th><th width="99.3333740234375">Type</th><th width="106.2222900390625">Required</th><th width="155.2222900390625">Constraints</th><th>Description</th></tr></thead><tbody><tr><td><code>productCode</code></td><td>String</td><td>Yes</td><td>Not blank</td><td>Product code identifying the card type</td></tr><tr><td><code>request_id</code></td><td>String</td><td>Yes</td><td>12-36 characters</td><td>Unique request identifier</td></tr><tr><td><code>amount</code></td><td>Decimal</td><td>Yes</td><td>Not null</td><td>Initial card balance</td></tr><tr><td><code>currency</code></td><td>String</td><td>Yes</td><td>USD, EUR</td><td>Currency code (must match Product currency)</td></tr><tr><td><code>cardValidityYears</code></td><td>Number</td><td>No</td><td>1-4</td><td>card validity period in years(card specific field)</td></tr><tr><td><code>preferredAccount</code></td><td>String</td><td>No</td><td>-</td><td>Preferred account to debit from</td></tr><tr><td><code>cardName</code></td><td>String</td><td>No</td><td>Max 32 characters</td><td>Custom name for the card</td></tr><tr><td><code>email</code></td><td>String</td><td>No</td><td>Valid email format</td><td>Cardholder email(card specific field)</td></tr><tr><td><code>firstName</code></td><td>String</td><td>No</td><td>-</td><td>card specific field</td></tr><tr><td><code>lastName</code></td><td>String</td><td>No</td><td>-</td><td>card specific field</td></tr><tr><td><code>kycUuid</code></td><td>String</td><td>No</td><td>-</td><td>UUID of the passed KYC</td></tr></tbody></table>

**Response:**

```json
{
  "type": "ISSUE",
  "status": "INPROCESS",
  "docid": 123456,
  "request_id": "request-id-12345"
}
```

**Response Parameters:**

<table><thead><tr><th width="195.111083984375">Field</th><th width="159">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>String</td><td>Operation type (ISSUE)</td></tr><tr><td><code>status</code></td><td>String</td><td><p>Current status of the operation </p><p>(INPROCESS, EXECUTED, DECLINED)</p></td></tr><tr><td><code>docid</code></td><td>Number</td><td>Document ID for tracking the operation</td></tr><tr><td><code>request_id</code></td><td>String</td><td>The request ID provided in the request</td></tr></tbody></table>