---
updatedAt: 2026-02-13T13:17:56.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# Fetch Multiple Cards by Issuer Number

This API handles requests to fetch cards based on various parameters such as issuer number, PAN (Primary Account Number), first name, last name, or card program. Multiple cards may be returned, but with a limit of 100 cards in the response.

<br />

| Field # | Field name  | Description                 |
| :------ | :---------- | :-------------------------- |
| 1       | code        | Internal Response Code      |
| 2       | description | Successful or Error Message |
| 3       | cardDetails | List of Card Details        |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "passport-management",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://qa.interswitchng.com/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/card-management/api/v1/card/fetchMultiple": {
      "post": {
        "summary": "Fetch Multiple Cards by Issuer Number",
        "description": "This API handles requests to fetch cards based on various parameters such as issuer number, PAN (Primary Account Number), first name, last name, or card program. Multiple cards may be returned, but with a limit of 100 cards in the response.",
        "operationId": "fetch-multiple-cards-by-issuer-number",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "issuerNr",
                  "cardProgram"
                ],
                "properties": {
                  "issuerNr": {
                    "type": "integer",
                    "description": "Issuer number",
                    "format": "int32"
                  },
                  "cardProgram": {
                    "type": "string",
                    "description": "Card Program e.g VERVE"
                  },
                  "firstName": {
                    "type": "string",
                    "description": "Required for New Debit and Prepaid Cards"
                  },
                  "lastName": {
                    "type": "string",
                    "default": "Required for New Debit and Prepaid Cards"
                  },
                  "pan": {
                    "type": "string",
                    "description": "Required for Reissue Debit and Prepaid Cards"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": \"00\",\n  \"description\": \"Successful\",\n  \"cardDetails\": [\n    {\n      \"pan\": \"5060990000000056128\",\n      \"expiryDate\": \"5004\",\n      \"issuerNr\": \"2\",\n      \"firstName\": \"Test\",\n      \"lastName\": \"Test\",\n      \"nameOnCard\": \"Test\",\n      \"cardProgram\": \"VERVE\",\n      \"customerId\": \"1234567867\",\n      \"cardStatus\": \"0\",\n      \"seqNr\": \"001\",\n      \"streetAddress\": \"OKO AWO\",\n      \"city\": \"Lagos\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "00"
                    },
                    "description": {
                      "type": "string",
                      "example": "Successful"
                    },
                    "cardDetails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pan": {
                            "type": "string",
                            "example": "5060990000000056128"
                          },
                          "expiryDate": {
                            "type": "string",
                            "example": "5004"
                          },
                          "issuerNr": {
                            "type": "string",
                            "example": "2"
                          },
                          "firstName": {
                            "type": "string",
                            "example": "Test"
                          },
                          "lastName": {
                            "type": "string",
                            "example": "Test"
                          },
                          "nameOnCard": {
                            "type": "string",
                            "example": "Test"
                          },
                          "cardProgram": {
                            "type": "string",
                            "example": "VERVE"
                          },
                          "customerId": {
                            "type": "string",
                            "example": "1234567867"
                          },
                          "cardStatus": {
                            "type": "string",
                            "example": "0"
                          },
                          "seqNr": {
                            "type": "string",
                            "example": "001"
                          },
                          "streetAddress": {
                            "type": "string",
                            "example": "OKO AWO"
                          },
                          "city": {
                            "type": "string",
                            "example": "Lagos"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"error\": \"unauthorized\",\n  \"error_description\": \"Full authentication is required to access this resource\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "unauthorized"
                    },
                    "error_description": {
                      "type": "string",
                      "example": "Full authentication is required to access this resource"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```