> For the complete documentation index, see [llms.txt](https://docs.udara360.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.udara360.io/udara360-docs-1/cards/interswitch/getcardaccountbycustomerid.md).

# GetCardAccountByCustomerId

The "GetCardAccountByCustomerId" endpoint allows customers to retrieve all card records tied to a particular customer, regardless of the account they're linked to.

<mark style="color:green;">`GET`</mark> `/api/Card/v{{version}}/Interswitch/GetCardAccountByCustomerId`

To retrieve a customer's card records, you need to provide the `customerId` as a query parameter. A successful request returns a list of matching card-account records under `data`, each showing the account-side details (`accountNumber`, `nameOnCard`, `customerId`) alongside the full linked card profile in a nested `card` object, plus a `recordCount` showing the total number of matching records.

This endpoint streamlines the process of finding every card belonging to a customer in a single call, useful for a full customer-level card view rather than looking up cards one account at a time.

**Headers**

| Name                                           | Value              |
| ---------------------------------------------- | ------------------ |
| Content-Type<mark style="color:red;">\*</mark> | `application/json` |
| Request-Reference                              | `unique_string`    |

**Query Params**

| Name         | Description                                          |
| ------------ | ---------------------------------------------------- |
| `customerId` | The ID of the customer to retrieve card records for. |

Here is an example request and response with a sample payload sent to the endpoint in Curl format.

<details>

<summary>Sample Request</summary>

```json
curl --location -g '{{baseUrl}}/api/Card/v{{version}}/Interswitch/GetCardAccountByCustomerId?customerId=00005187' \
--header 'Content-Type: application/json'
```

</details>

<details>

<summary>Response: <code>200</code></summary>

```json
{
  "status": true,
  "message": "string",
  "data": {
    "data": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "dateCreated": "2025-03-31T17:15:36.415Z",
        "dateLastModified": "2025-03-31T17:15:36.415Z",
        "accountNumber": "string",
        "nameOnCard": "string",
        "customerId": "string",
        "cardId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "card": {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "dateCreated": "2025-03-31T17:15:36.415Z",
          "dateLastModified": "2025-03-31T17:15:36.415Z",
          "batchNo": "string",
          "maskedPan": "string",
          "encrptedPan": "string",
          "hashedPan": "string",
          "accountNumber": "string",
          "nameOnCard": "string",
          "serialNumber": "string",
          "expiryDate": "2025-03-31T17:15:36.415Z",
          "requestDate": "2025-03-31T17:15:36.415Z",
          "issuedDate": "2025-03-31T17:15:36.415Z",
          "issuanceStatus": "string",
          "cardProfileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "cardType": "string",
          "cardScheme": "string",
          "status": "string",
          "isATMEnabled": true,
          "isPOSEnabled": true,
          "isWebEnabled": true
        },
        "bankCode": "string",
        "encrptedPan": "string",
        "hashedPan": "string",
        "overrideProductApplicableFee": true,
        "overrideProductApplicableInterest": true,
        "productCode": "string",
        "productName": "string",
        "signatureFileUrl": "string",
        "passportFileUrl": "string",
        "status": "string"
      }
    ],
    "recordCount": 0
  }
}
```

</details>