> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Card Details

> This endpoint retrieves detailed information about a specific card

### Params

<ParamField path="cardId" type="string" required>
  The unique card identifier
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates whether the call was successful
</ResponseField>

<ResponseField name="cardId" type="string">
  The unique card identifier
</ResponseField>

<ResponseField name="userId" type="string">
  The user ID of the card holder
</ResponseField>

<ResponseField name="status" type="string">
  Card status: `notActivated`, `active`, `locked`, or `canceled`
</ResponseField>

<ResponseField name="type" type="string">
  Card type: `physical` or `virtual`
</ResponseField>

<ResponseField name="last4" type="string">
  Last 4 digits of the card number
</ResponseField>

<ResponseField name="expirationMonth" type="string">
  Card expiration month (MM)
</ResponseField>

<ResponseField name="expirationYear" type="string">
  Card expiration year (YYYY)
</ResponseField>

<ResponseField name="brand" type="string">
  Card brand (e.g., "Visa", "Mastercard")
</ResponseField>

<ResponseField name="limit" type="object">
  Spending limits configured for the card

  <Expandable title="Limit object">
    <ResponseField name="amount" type="number">
      Limit amount
    </ResponseField>

    <ResponseField name="frequency" type="string">
      Frequency: `per24HourPeriod`, `per7DayPeriod`, `per30DayPeriod`, `perYearPeriod`, `allTime`, or `perAuthorization`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="createdAt" type="string">
  ISO 8601 timestamp when the card was created
</ResponseField>

<ResponseField name="activatedAt" type="string">
  ISO 8601 timestamp when the card was activated
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/cards/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d' \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>'
  ```

  ```js Javascript theme={null}
  const response = await fetch('https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/cards/7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d', {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'api-key': '<api-key>'
    }
  });

  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "cardId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
    "userId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
    "status": "active",
    "type": "virtual",
    "last4": "4242",
    "expirationMonth": "12",
    "expirationYear": "2027",
    "brand": "Visa",
    "limit": {
      "amount": 5000,
      "frequency": "per30DayPeriod"
    },
    "createdAt": "2024-01-15T10:00:00Z",
    "activatedAt": "2024-01-15T10:05:00Z"
  }
  ```
</ResponseExample>

### Error Responses

<ResponseExample>
  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized. Please check your authentication credentials."
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Card not found."
  }
  ```
</ResponseExample>
