> 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/get-card-request-status.md).

# Get Card Request Status

Retrieves the status of a card operation(ISSUE, TOPUP, WITHDRAWAL, BLOCK) request using either request ID or document ID.

**Endpoint:** `GET /request/status`

**Query Parameters:**

<table><thead><tr><th width="166.77783203125">Parameter</th><th width="139">Type</th><th width="149.22216796875">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>request_id</code></td><td>String</td><td>Conditional</td><td>Unique request identifier</td></tr><tr><td><code>docid</code></td><td>Number</td><td>Conditional</td><td>Document ID</td></tr></tbody></table>

**Note:** Either `request_id` or `docid` must be provided.

**Response (Block Operation):**

```json
{
  "type": "BLOCK",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "block": {
    "san": "1234567890",
    "releasedBalance": 150.75,
    "currency": "USD"
  }
}
```

**Response Parameters (Block Operation):**

<table><thead><tr><th width="216.77783203125">Field</th><th width="155">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>String</td><td>Operation type (BLOCK)</td></tr><tr><td><code>status</code></td><td>String</td><td>Current status of the operation (see Status Values below)</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 original request</td></tr><tr><td><code>block</code></td><td>Object</td><td>Block operation details</td></tr><tr><td><code>block.san</code></td><td>String</td><td>Secure Account Number (card identifier)</td></tr><tr><td><code>block.releasedBalance</code></td><td>Decimal</td><td>Balance released back to user account after blocking</td></tr><tr><td><code>block.currency</code></td><td>String</td><td>Currency code (USD, EUR, etc.)</td></tr></tbody></table>

**Response (Top-Up Operation):**

```json
{
  "type": "TOPUP",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "topup": {
    "san": "1234567890",
    "amount": 100.00,
    "currency": "USD"
  }
}
```

**Response Parameters (Top-Up Operation):**

<table><thead><tr><th width="195.2222900390625">Field</th><th width="160.111083984375">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>String</td><td>Operation type (TOPUP)</td></tr><tr><td><code>status</code></td><td>String</td><td>Current status of the operation (see Status Values below)</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 original request</td></tr><tr><td><code>topup</code></td><td>Object</td><td>Top-up operation details</td></tr><tr><td><code>topup.san</code></td><td>String</td><td>Secure Account Number (card identifier)</td></tr><tr><td><code>topup.amount</code></td><td>Decimal</td><td>Amount added to the card</td></tr><tr><td><code>topup.currency</code></td><td>String</td><td>Currency code (USD, EUR, etc.)</td></tr></tbody></table>

**Response (Issue Operation):**

```json
{
  "type": "ISSUE",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "issue": {
    "san": "1234567890",
    "pan": "************5678",
    "expYear": 2026,
    "expMonth": 12,
    "cvv": "123",
    "currency": "USD",
    "initialBalance": 100.00,
    "cardName": "My Card"
  }
}
```

**Response Parameters (Issue Operation):**

<table><thead><tr><th width="222.2222900390625">Field</th><th width="157.888916015625">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>Current status of the operation (see Status Values below)</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 original request</td></tr><tr><td><code>issue</code></td><td>Object</td><td>Issue operation details</td></tr><tr><td><code>issue.san</code></td><td>String</td><td>Secure Account Number (card identifier)</td></tr><tr><td><code>issue.pan</code></td><td>String</td><td>Masked Primary Account Number</td></tr><tr><td><code>issue.expYear</code></td><td>Number</td><td>Card expiration year</td></tr><tr><td><code>issue.expMonth</code></td><td>Number</td><td>Card expiration month (1-12)</td></tr><tr><td><code>issue.cvv</code></td><td>String</td><td>Card verification value</td></tr><tr><td><code>issue.currency</code></td><td>String</td><td>Card currency code</td></tr><tr><td><code>issue.initialBalance</code></td><td>Decimal</td><td>Initial balance loaded on the card</td></tr><tr><td><code>issue.cardName</code></td><td>String</td><td>Custom name assigned to the card</td></tr></tbody></table>

**Response (Withdrawal Operation):**

```json
{
  "type": "WITHDRAWAL",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "withdrawal": {
    "san": "1234567890",
    "amount": 50.00,
    "currency": "USD"
  }
}
```

**Response Parameters (Withdrawal Operation):**

<table><thead><tr><th width="225.77783203125">Field</th><th width="139">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>type</code></td><td>String</td><td>Operation type (WITHDRAWAL)</td></tr><tr><td><code>status</code></td><td>String</td><td>Current status of the operation (see Status Values below)</td></tr><tr><td><code>docid</code></td><td>Integer</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 original request</td></tr><tr><td><code>withdrawal</code></td><td>Object</td><td>Withdrawal operation details</td></tr><tr><td><code>withdrawal.san</code></td><td>String</td><td>Secure Account Number (card identifier)</td></tr><tr><td><code>withdrawal.amount</code></td><td>Decimal</td><td>Amount withdrawn from the card</td></tr><tr><td><code>withdrawal.currency</code></td><td>String</td><td>Currency code (USD, EUR, etc.)</td></tr></tbody></table>

**Operation Types:**

* `ISSUE` - Card issuance
* `TOPUP` - Card top-up
* `WITHDRAWAL` - Card withdrawal
* `BLOCK` - Card blocking

**Status Values:**

* `INPROCESS` - Operation is being processed
* `EXECUTED` - Operation completed successfully
* `DECLINED` - Operation was declined for some reason