---
id: list-stores
title: "List Stores"
sidebar_label: List Stores
hide_title: true
description: "Management API - Onboarding - List Stores"
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import Ingress from '../../src/components/ingress/ingress.react';

<Ingress title="List Stores">
    This describes the request used to create a Merchant and add stores to that merchant
</Ingress>

### List stores for current organization

<Tabs defaultValue="req" values={[
{ label: 'Request', value: 'req', },
{ label: 'Response', value: 'res', }
]}>

<TabItem value="req">

```json
GET /manage/stores HTTP/1.1
Host: api.uat.walleydev.com // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
```

</TabItem>

<TabItem value="res">

```json
{
  "data": [
    {
      "id": "9684",
      "name": "Test Company",
      "countryCode": "SE"
      "salesSegment": "B2C"
    },
    {
      "id": "9685",
      "name": "Test Company",
      "countryCode": "SE"
      "salesSegment": "B2B"
    },
    {
      "id": "9688",
      "name": "Test Company",
      "countryCode": "SE",
      "salesSegment": "B2C"
    }
  ],
  "links": {},
  "metaData": {}
}
```

</TabItem>
</Tabs>

### List stores for a sub organization

<Tabs defaultValue="req" values={[
{ label: 'Request', value: 'req', },
{ label: 'Response', value: 'res', }
]}>

<TabItem value="req">

```json
GET /manage/organizations/{organizationId}/stores HTTP/1.1
Host: api.uat.walleydev.com // (Please note! Different hostname in production)
Authorization: Bearer bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
```

</TabItem>

<TabItem value="res">

```json
{
  "data": [
    {
      "id": "9684",
      "name": "Test Company",
      "countryCode": "SE",
      "salesSegment": "B2C"
    },
    {
      "id": "9685",
      "name": "Test Company",
      "countryCode": "SE",
      "salesSegment": "B2B"
    },
    {
      "id": "9688",
      "name": "Test Company",
      "countryCode": "SE",
      "salesSegment": "B2C"
    }
  ],
  "links": {},
  "metaData": {}
}
```

</TabItem>
</Tabs>

## Data Model

### Request

##### Request headers

| Header            | Required | Explanation                                                                                                             |
| ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Authorization** | Yes      | Instructions on how to generate the Bearer token value can be found [here](/docs/manage/getting-started/authentication) |

##### Request query parameters

| Property           | Required          | Explanation                                            |
| ------------------ | ----------------- | ------------------------------------------------------ |
| **organizationId** | Yes if applicable | The specific Organization identifier to get stores for |

### Response

The response is wrapped in a [Response object containing data, links and metadata](/docs/onboarding/models/data-response)

| Property         | Explanation                            |
| ---------------- | -------------------------------------- |
| **id**           | Store identifier                       |
| **name**         | Store name, used for human readability |
| **countryCode**  | Country code of the store              |
| **salesSegment** | SalesSegment type "B2B" or "B2C"       |