---
updatedAt: 2025-11-11T00:10:27.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/v1.1/llms.txt
---

# Get All Supplier Stores

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "retail-ecosystem",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://retail-ecosystem-service.k8.isw.la"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/retail-ecosystem/api/v1/suppliers/{supplierId}/stores": {
      "get": {
        "summary": "Get All Supplier Stores",
        "description": "",
        "operationId": "get-all-supplier-stores",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "supplierId",
            "in": "path",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 1
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"statusCode\": 200,\n    \"message\": \"Supplier store(s) retrieved successfully!\",\n    \"data\": [\n        {\n            \"id\": 10432,\n            \"name\": \"Blem ca-sadd\",\n            \"initials\": \"BL\",\n            \"urlEndpoint\": \"mx16141-22112409e9f24f16\",\n            \"type\": \"PHYSICAL\",\n            \"merchantCode\": \"MX16141\",\n            \"payableCode\": \"2738900\",\n            \"email\": \"laleyeola@grr.la\",\n            \"phoneNumber\": \"+2348114988327\",\n            \"address\": \"Estaport Avenue Revers\",\n            \"landmark\": null,\n            \"lga\": \"Agege\",\n            \"city\": \"Gbagada Cache\",\n            \"state\": \"Lagos\",\n            \"country\": \"Nigeria\",\n            \"status\": \"OPEN\",\n            \"identifier\": \"DISTRIBUTOR\",\n            \"fullWarehouseAddress\": \"Estaport Avenue Revers, Gbagada Cache, Lagos, Nigeria.\"\n        },\n        {\n            \"id\": 10448,\n            \"name\": \"Sammie Sunglass Store-saddadd\",\n            \"initials\": \"SA\",\n            \"urlEndpoint\": \"mx20464-0edee0ac3df54fc7\",\n            \"type\": \"PHYSICAL\",\n            \"merchantCode\": \"MX20464\",\n            \"payableCode\": \"Default_Payable_MX20464\",\n            \"email\": \"samuel.obayagbona@interswitchg\",\n            \"phoneNumber\": \"+2348114988327\",\n            \"address\": \"17b Oko Awo Street, \",\n            \"landmark\": null,\n            \"lga\": null,\n            \"city\": \"Victoria island\",\n            \"state\": \"Lagos\",\n            \"country\": \"Nigeria\",\n            \"status\": \"OPEN\",\n            \"identifier\": \"DISTRIBUTOR\",\n            \"fullWarehouseAddress\": \"17b Oko Awo Street, , Victoria island, Lagos, Nigeria.\"\n        }\n    ],\n    \"validation\": null\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "statusCode": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "message": {
                      "type": "string",
                      "example": "Supplier store(s) retrieved successfully!"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 10432,
                            "default": 0
                          },
                          "name": {
                            "type": "string",
                            "example": "Blem ca-sadd"
                          },
                          "initials": {
                            "type": "string",
                            "example": "BL"
                          },
                          "urlEndpoint": {
                            "type": "string",
                            "example": "mx16141-22112409e9f24f16"
                          },
                          "type": {
                            "type": "string",
                            "example": "PHYSICAL"
                          },
                          "merchantCode": {
                            "type": "string",
                            "example": "MX16141"
                          },
                          "payableCode": {
                            "type": "string",
                            "example": "2738900"
                          },
                          "email": {
                            "type": "string",
                            "example": "laleyeola@grr.la"
                          },
                          "phoneNumber": {
                            "type": "string",
                            "example": "+2348114988327"
                          },
                          "address": {
                            "type": "string",
                            "example": "Estaport Avenue Revers"
                          },
                          "landmark": {},
                          "lga": {
                            "type": "string",
                            "example": "Agege"
                          },
                          "city": {
                            "type": "string",
                            "example": "Gbagada Cache"
                          },
                          "state": {
                            "type": "string",
                            "example": "Lagos"
                          },
                          "country": {
                            "type": "string",
                            "example": "Nigeria"
                          },
                          "status": {
                            "type": "string",
                            "example": "OPEN"
                          },
                          "identifier": {
                            "type": "string",
                            "example": "DISTRIBUTOR"
                          },
                          "fullWarehouseAddress": {
                            "type": "string",
                            "example": "Estaport Avenue Revers, Gbagada Cache, Lagos, Nigeria."
                          }
                        }
                      }
                    },
                    "validation": {}
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Authourization",
        "value": "Bearer <token>"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```