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

# Fetch Cards By Account

This API handles requests to fetch cards by Account. It returns a list of all cards linked to an account.

<br />

| Field # | Field name           | Description                        |
| :------ | :------------------- | :--------------------------------- |
| 1       | code                 | Internal Response Code             |
| 2       | description          | Successful or Error Message        |
| 3       | accountCustomerCards | List of Card Account Details       |
| 4       | errors               | Errors array if any errors exists. |

# 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/fetchCardByAccount": {
      "post": {
        "summary": "Fetch Cards By Account",
        "description": "This API handles requests to fetch cards by Account. It returns a list of all cards linked to an account.",
        "operationId": "fetch-cards-by-account",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "issuerNr",
                  "accountId"
                ],
                "properties": {
                  "issuerNr": {
                    "type": "integer",
                    "description": "Issuer number",
                    "format": "int32"
                  },
                  "accountId": {
                    "type": "string",
                    "description": "Account ID or Number"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": \"00\",\n  \"description\": \"Successful\",\n  \"accountCustomerCards\": [\n    {\n      \"accountId\": \"0002489624\",\n      \"customerId\": \"20220404083650993770017\",\n      \"pan\": \"5061800000000000017\",\n      \"firstName\": \"JUNAID\",\n      \"lastName\": \"OLORUNTOBI\",\n      \"nameOnCard\": \"JUNAID OLORUNTOBI\",\n      \"mobileNr\": \"\"\n    },\n    {\n      \"accountId\": \"0002489624\",\n      \"customerId\": \"20220404083650993770017\",\n      \"pan\": \"5061800000000000025\",\n      \"firstName\": \"JUNAID\",\n      \"lastName\": \"OLORUNTOBI\",\n      \"nameOnCard\": \"JUNAID OLORUNTOBI\",\n      \"mobileNr\": \"\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "example": "00"
                    },
                    "description": {
                      "type": "string",
                      "example": "Successful"
                    },
                    "accountCustomerCards": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "accountId": {
                            "type": "string",
                            "example": "0002489624"
                          },
                          "customerId": {
                            "type": "string",
                            "example": "20220404083650993770017"
                          },
                          "pan": {
                            "type": "string",
                            "example": "5061800000000000017"
                          },
                          "firstName": {
                            "type": "string",
                            "example": "JUNAID"
                          },
                          "lastName": {
                            "type": "string",
                            "example": "OLORUNTOBI"
                          },
                          "nameOnCard": {
                            "type": "string",
                            "example": "JUNAID OLORUNTOBI"
                          },
                          "mobileNr": {
                            "type": "string",
                            "example": ""
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "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
}
```