> 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/providus/search-providus-cards.md).

# Search Providus Cards

The "SearchCards" endpoint allows customers to search for Providus-issued cards using any combination of filters like account number, status, customer ID, card ID, cardholder ID, card program ID, masked PAN, last four digits, BIN, or date range.

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

{% hint style="info" %}
Pass only the field(s) you intend to search by. Every field is optional.
{% endhint %}

To search for cards, you can pass any of the supported query parameters `accountNumber`,`cardId`, as needed.

This endpoint streamlines card lookups within the Providus card data store, letting you search and filter across Providus-issued cards in a single call.

**Headers**

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

**Query Params**

<table><thead><tr><th>Name</th><th data-type="checkbox">Required/Optional</th><th>Description</th></tr></thead><tbody><tr><td><code>accountNumber</code></td><td>true</td><td>The account number to search by.</td></tr><tr><td><code>cardId</code></td><td>true</td><td>The ID of the card record to search by.</td></tr></tbody></table>

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 --request GET '{{baseUrl}}/api/Card/v{{version}}/Providus/SearchCards' \
--header 'Content-Type: application/json' \
--data '{
  "startDate": null,
  "endDate": null,
  "pageNumber": null,
  "pageSize": null,
  "accountNumber": "1000071961",
  "status": null,//InActive = 0, Active = 1, Paused = 2, Blocked = 3
  "customerID": null,
  "cardId": null,
  "cardholderId": null,
  "cardProgramId": null,
  "maskedPAN": null,
  "lastFour": null,
  "bin": null,
  "thirdPartyProvider": 2
}'
```

</details>

<details>

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

```json
{
  "data": {
    "data": [
      {
        "id": "b6adc86a-750d-436a-9625-b35400c5ed58",
        "dateCreated": "2025-09-10T13:00:37.8333333",
        "dateLastModified": null,
        "bankCode": "100001",
        "cardholderId": "9cc89c4e-06f5-4320-8417-9597f5773ad8",
        "cardProgramId": 0,
        "nameOnCard": "OLADELE Olalekan",
        "accounts": null,
        "cardId": "76b0c321-9376-4bde-b4e6-f4740189ed40",
        "cardNumber": null,
        "accountNumber": "1000071961",
        "maskedPAN": "346754*********1785",
        "lastFour": "1785",
        "bin": null,
        "pan": null,
        "cvv": null,
        "cardCreationDate": "10/09/2025 12:00:37",
        "cardExpiration": "02/26",
        "state": null,
        "type": "Instant",
        "status": "Active",
        "canSetPin": false,
        "canChangePin": false,
        "isPinSet": null
      }
    ],
    "recordCount": 1
  },
  "status": true,
  "message": "Request successful"
}
```

</details>