List completed meetings

get /v1/meetings

Autorização

Exige o escopo meetings.read.

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.
`account_id`	`string`	Não	Return only records linked to this account. Take the id from `GET /v1/accounts` or from an `accounts` field. An id the company never issued, or one issued to another company, yields an empty page, not an error; a malformed id is a 400 `INVALID_FILTER`.
`team_id`	`string`	Não	Return only records owned by a member of this team. Members are the sellers whose default team it is: a seller in several teams counts for their default team only. Take the id from `GET /v1/teams`. An id the company never issued, one issued to another company, or a team with no members yields an empty page, not an error; a malformed id is a 400 `INVALID_FILTER`.
`tag_id`	`string`	Não	Return only records carrying this tag. Take the id from `GET /v1/tags` or from a `tags` field. An id the company never issued, or one issued to another company, yields an empty page, not an error; a malformed id is a 400 `INVALID_FILTER`.
`score_min`	`integer`	Não	Lowest overall evaluation score to include, inclusive, from 0 to 10. Only completed evaluations count: records whose evaluation has no score, or is not completed, are excluded whenever a score bound is present. Defaults to 0 when only `score_max` is given. A non-integer or out-of-range value, or a `score_min` above `score_max`, is a 400 `INVALID_FILTER`.
`score_max`	`integer`	Não	Highest overall evaluation score to include, inclusive, from 0 to 10. Defaults to 10 when only `score_min` is given. A non-integer or out-of-range value, or a `score_max` below `score_min`, is a 400 `INVALID_FILTER`.

Exemplo de requisição

curl "https://api.salesbud.com.br/v1/meetings?limit=...&cursor=..." \
  -H "Authorization: Bearer $SALESBUD_ACCESS_TOKEN"

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",
          "name": "Example Ltda",
          "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

Status	Descrição
`200`	Company-scoped meeting page.
`400`	Invalid request.
`401`	Missing or invalid credentials.
`403`	The token lacks the required scope, its user owner lost matching product access, or a connector awaits administrator approval. API_ACCESS_DISABLED identifies the feature gate for manual clients and third-party OAuth apps; AI_COLLABORATORS_DISABLED identifies the gate for first-party OAuth apps. For partner credentials, the gate also requires an active partner and the required published module, and applies to previously issued tokens.
`429`	Client rate limit exceeded.
`503`	A required audit or rate-limit dependency is unavailable.