# Get all channels (https://developer.godaddy.com/en/docs/references/rest/channels/get-channels)

---
title: Get all channels
description: Returns all channels for a provider.
full: true
---

Full description

Returns all channels for a provider. Requires at least one of registeredStores.storeId or externalChannelId; omitting both returns 400. Access requires a service principal with GLOBAL resource group or a customer with COMMERCE\_STORE access.

## GET /channels

Get all channels

Returns all channels for a provider. Requires at least one of registeredStores.storeId or externalChannelId; omitting both returns 400. Access requires a service principal with GLOBAL resource group or a customer with COMMERCE_STORE access.

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `externalChannelId` | string | no |  |
| `registeredStores.storeId` | unknown | no |  |
| `registeredStores.default` | boolean | null | no |  |
| `pageSize` | integer | no |  |
| `page` | integer | no |  |
| `totalRequired` | boolean | no | When `true`, the response includes `totalItems`, `totalPages`, and a `last` HATEOAS link. When `false` (default), those fields and the `last` link are omitted. |

### Responses

**200** — Channels

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/b8a4d41`

**400** — Invalid request (validation error or missing required parameter).

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**401** — Authentication failed or missing.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**403** — Caller is authenticated but not authorized for this action.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**500** — Unexpected server error.

Content-Type: `application/json`

Schema:

- schema reference: `#/x-ext/e2dac50`

**Security:** requires `PAT`; scopes `commerce.channel:read`.