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.

GET /api/Card/v{{version}}/Providus/SearchCards

Pass only the field(s) you intend to search by. Every field is optional.

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*	application/json
Request-Reference	unique_string

Query Params

Name	Required/Optional	Description
accountNumber		The account number to search by.
cardId		The ID of the card record to search by.

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

Sample Request

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
}'

Response: 200

{
  "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"
}