# List FAQ entries

`GET https://api.cademi.com.br/api/v3/support/faqs`

Operation ID: `faqs.list` · API v3

Lists the FAQ entries of the current account. The collection can be filtered by group and status.

Entries are sorted by group name, with ungrouped entries last, and then by position within each group. All matching entries are returned in a single response.

Collection items do not include the answer. Use the retrieve operation to obtain it.

Required permissions: `faqs.read`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `group` | query | string | no |  |
| `status` | query | string, one of `draft`, `published` | no |  |

## Responses

### 200

Returns the collection of FAQ entries.

Body: `data`: array of Faq.

Fields of Faq:

| Field | Type | Required | Description |
|---|---|---|---|
| `answer` | object or null | no |  |
| `created_at` | string (date-time) | yes |  |
| `group` | string or null | yes |  |
| `id` | string | yes |  |
| `object` | string, one of `faq` | yes |  |
| `position` | integer | yes |  |
| `question` | string | yes |  |
| `revision` | string | yes |  |
| `status` | string, one of `draft`, `published` | yes |  |
| `updated_at` | string (date-time) | 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