# List gateways

`GET https://api.cademi.com.br/api/v3/sales/gateways`

Operation ID: `gateways.list` · API v3

Returns the catalog of supported payment gateways. The catalog is the same for every account, is returned in a single response, and does not include any account credentials.

Required permissions: `gateways.read`.

## Responses

### 200

Returns the gateway catalog.

Body: `data`: array of Gateway.

Fields of Gateway:

| Field | Type | Required | Description |
|---|---|---|---|
| `capabilities` | object | yes |  |
| `featured` | boolean | yes |  |
| `help_url` | string or null | yes |  |
| `icon_url` | string or null | yes |  |
| `id` | string | yes | Public ID of the payment gateway: gtw_ followed by the gateway's catalog key. |
| `labels` | object | yes | The name the payment gateway uses for each field in its own documentation. |
| `name` | string | yes |  |
| `object` | string, one of `gateway` | yes |  |

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

Full schema: https://cademi.dev/openapi/v3.json