List completed meetings
get /v1/meetings
Devolve uma lista de objetos reunião.
Autorização
Seção intitulada “Autorização”Exige o escopo meetings.read.
Parâmetros de query
Seção intitulada “Parâmetros de query”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | integer | Não | Records per page, 1 to 100. A page may return fewer than this while has_more is still true; drive the loop by has_more, not by the size of data. |
cursor | string | Não | Signed cursor returned by the previous page. |
created_after | string date-time | Não | Return records created after this instant. |
created_before | string date-time | Não | Return records created before this instant. |
meeting_after | string date-time | Não | Return records whose event instant is after this value. |
meeting_before | string date-time | Não | Return records whose event instant is before this value. |
owner_email | string email | Não | Exact case-insensitive owner email match. |
type | video · audio | Não | Media the record was captured as. Independent of the resource kind: a call can be video and a meeting can be audio. |
audience | internal · external | Não | Whether the record had participants from outside the company (external) or only internal ones. |
has_transcript | boolean | Não | Filter by existence of a transcript resource. |
Exemplo de requisição
Seção intitulada “Exemplo de requisição”curl "https://api.salesbud.com.br/v1/meetings?limit=...&cursor=..." \ -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"Exemplo de resposta
Seção intitulada “Exemplo de resposta”{ "data": [ { "id": "mtg_ExampleMeeting01", "object": "meeting", "title": "Discovery - Acme", "status": "completed", "type": "video", "audience": "external", "meeting_at": "2026-01-14T13:00:00.000Z", "duration_seconds": 2840, "no_show": false, "participants": [ { "display_name": "Example Buyer", "email": "buyer@example.com", "kind": "external" }, { "email": "procurement@example.com", "kind": "external" } ], "owner": { "id": "usr_ExampleOwner01", "name": "Example Rep", "email": "rep@example.com", "team": { "id": "team_ExampleTeam01", "name": "Inside Sales", "role": "participant", "is_default": true } }, "template": { "id": "tpl_ExampleTemplate01", "name": "Discovery script", "answers": [ { "field": "qst_ExampleQuestion01", "question": "What pains did the customer describe?", "answer": "Manual CRM entry after every call, about two hours a day." } ] }, "tags": [ { "id": "tag_ExampleTag01", "name": "Enterprise" } ], "customer_questions": [ { "question": "Does it integrate with our CRM?", "category": "integrations" } ], "competitors": [ { "id": "ctr_ExampleCompetitor01", "name": "Example CRM" } ], "enablement": { "next_steps": "Send the proposal by Friday covering 5,400 seats.", "meeting_type": "qualification", "speaking_duration": { "users": [ { "user": { "id": "usr_ExampleOwner01", "name": "Example Rep", "email": "rep@example.com" }, "duration_seconds": 1760 } ], "others_seconds": 1080 } }, "accounts": [ { "id": "acc_ExampleAccount01", "domain": "acme.example.com", "cnpj": "12345678000199" } ], "overall_evaluation": { "status": "completed", "justification": "Strong discovery, weak on next steps." }, "skill_scores": [], "bot_history": [], "transcript": { "available": true, "status": "completed" }, "created_at": "2026-01-14T12:58:47.000Z", "updated_at": "2026-01-14T14:10:43.000Z" } ], "pagination": { "limit": 50, "has_more": true, "next_cursor": "cur_ExampleCursor01" }, "request_id": "req_ExampleRequestId01"}Respostas
Seção intitulada “Respostas”| Status | Descrição |
|---|---|
200 | Company-scoped meeting page. |
400 | Invalid request. |
401 | Missing or invalid credentials. |
403 | The token does not contain the required scope. |
429 | Client rate limit exceeded. |
503 | A required audit or rate-limit dependency is unavailable. |