---
title: "Listar reuniões"
method: GET
path: "/meetings"
tags: ["crm-v2-meetings"]
---

# Listar reuniões

`GET /meetings`

## Request

- Base URL: `https://api.rd.services/crm/v2`
- URL: `https://api.rd.services/crm/v2/meetings`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

Este end-point recupera uma lista paginada de reuniões na conta, permitindo a filtragem por status,
organizador, responsável, data de início e última atualização. É útil para sincronizar a agenda de vendas
com ferramentas externas de SDR, scheduling ou automação.

## Filtro

Propriedades disponíveis para filtro usando [RDQL](crm-v2-rdql-filtering).

| Propriedade | Tipo | Descrição |
| :--- | :--- | :--- |
| `status` | `String` | Filtra pelo status da reunião (`scheduled`, `completed`, `no_show`). |
| `starts_at` | `DateTime` | Filtra pela data e hora de início. |
| `updated_at` | `DateTime` | Filtra pela data e hora da última atualização. |
| `organizer_id` | `String` | Filtra pelo ID do organizador. |
| `responsible_id` | `String` | Filtra pelo ID do responsável. |

## Ordenação

Propriedades disponíveis para [ordenação](crm-v2-introduction#ordenação).

* `starts_at` (padrão, ascendente)
* `status`
* `organizer_id`
* `updated_at`

## Query parameters

- `filter` string
- `sort` object
- `page` object
  - `number` integer: Número da página.
  - `size` integer: Tamanho da página.

## Response `200`

OK

- object
  - `data` object[]: Lista de recursos relacionados.
    - `id` string: Identificador único da reunião.
    - `subject` string: Assunto da reunião. Tamanho máximo de 150 caracteres.
    - `notes` string: Observações da reunião. Tamanho máximo de 1000 caracteres.
    - `starts_at` string, date-time: Data e hora de início da reunião.
    - `ends_at` string, date-time: Data e hora de término da reunião (calculado a partir de `starts_at` e `duration_minutes`).
    - `duration_minutes` integer: Duração da reunião em minutos.
    - `status` 'scheduled' | 'completed' | 'no_show': Status da reunião. Valores: `scheduled`, `completed`, `no_show`.
    - `responsible_id` string: ID do usuário responsável pela reunião.
    - `organizer_id` string: ID do usuário organizador da reunião.
    - `contact_ids` string[]: IDs dos contatos participantes da reunião (máximo de 20).
    - `created_at` string, date-time: Data de criação da reunião.
    - `updated_at` string, date-time: Data de atualização da reunião.
  - `links` object: Links de navegação da paginação.
    - `first` string, uri: Link para a primeira página.
    - `prev` string, uri: Link para a página anterior.
    - `self` string, uri: Link para a página atual.
    - `next` string, uri: Link para a próxima página.
    - `last` string, uri: Link para a última página.

## Other responses

- `400`: A requisição está malformada e não consegue ser processada.
- `401`: O token da API está ausente ou inválido.
- `403`: O token não tem permissão para acessar o recurso solicitado.
- `429`: O limite de requisições foi excedido.
- `500`: Erro interno ou inesperado no servidor.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)