> ## Documentation Index > Fetch the complete documentation index at: https://docs.anycrm.anyreach.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Meetings > List meetings (activities with type='meeting') for the active org. Filters: from / to (ISO 8601, applied to due_at), owner_id, account_id. `order` may be 'asc' or 'desc' (applied to due_at). NULLS go last either way so unscheduled meetings sort to the bottom. Lists activities with `type='meeting'` across the active org, with embedded account/deal/contact summaries. Sorted by `due_at` (direction controlled by `order`), with `NULLS LAST` in either direction so unscheduled meetings always sort to the bottom, then by `created_at` descending as a tiebreaker. Returns a bare JSON array — no total-count header, no pagination envelope. `limit` is capped at `500` server-side. Passing a linked-filter together with its matching id-filter matches nothing: `unlinked_account=true` together with an explicit `account_id`, or `unlinked_deal=true` with `deal_id`, sends the same PostgREST query key twice (`eq.` and `is.null`), which is a self-contradicting `AND` — you get an empty result, not an error. ### Auth Requires a CRM read [scope](/authentication#scopes) and an active organization on the token. Any of `contacts:read`, `deals:read`, `companies:read`, or `activities:read` qualifies, as does any `*:manage` scope — manage implies read. ### Response Array of meeting objects: | Field | Type | Description | | ------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` (uuid) | Primary key. | | `type` | `string` | Always `"meeting"` on this endpoint. | | `subject` | `string \| null` | Meeting title. | | `body` | `string \| null` | Free-text notes. | | `due_at` | `string \| null` (timestamptz) | Scheduled time. | | `completed_at` | `string \| null` (timestamptz) | When the meeting was marked done, if applicable. | | `duration_minutes` | `integer \| null` | Meeting length. | | `metadata` | `object \| null` (jsonb) | Free-form. When populated by a connected calendar/video integration it typically carries `{"transcript", "recording_url", "attendees": [{"name","email"}], "started_at", "ended_at", "location", "provider"}`, but manual logging (via `ActivityBody`) only ever writes `transcript`, `recording_url`, `attendees`, `location`, and `provider` — there's no field for `started_at`/`ended_at` on manual entries, so those two keys only appear on synced rows. | | `account_id` | `string \| null` (uuid) | Linked account. | | `deal_id` | `string \| null` (uuid) | Linked deal. | | `contact_id` | `string \| null` (uuid) | Linked contact. | | `owner_id` | `string \| null` | Logto user sub of the owning rep. | | `source` | `string` | `manual`, `import`, or a sync source (`calendar`, `gmail`, `outlook`, `slack`, `teams`). | | `direction` | `string \| null` | Not typically meaningful for meetings; carried over from the shared select. | | `created_at` | `string` (timestamptz) | Row creation time. | | `accounts` | `object \| null` | Embedded: `{ id, name, domain }`. `null` if `account_id` is unset. | | `deals` | `object \| null` | Embedded: `{ id, name, stage_id }`. `null` if `deal_id` is unset. | | `contacts` | `object \| null` | Embedded: `{ id, first_name, last_name, email }`. `null` if `contact_id` is unset. | ## OpenAPI ````yaml GET /activities/meetings openapi: 3.1.0 info: title: anycrm-api version: 0.0.1 servers: [] security: [] tags: - name: Customer Intelligence description: >- Company research and ICP-fit scoring — create a research run, track its progress, and read back scored companies as leads. - name: Outreach description: >- The cold-email management console — domains, mailboxes, and campaigns — as a thin control plane over the SalesForge stack. - name: AnyCard description: >- Authenticated CRUD for AnyCard, the org's digital business-card / lead-capture product. - name: AnyCard Events description: >- Event-attribution analytics for AnyCard — which captured leads converted, broken down by source, owner, and deal. - name: AnyCard Share Links description: >- Unauthenticated endpoints reached by anyone who scans a QR code or opens a shared AnyCard link. - name: AI description: >- A streaming (SSE) AI chat endpoint with account-commit actions it can take on the caller's behalf. - name: Analytics Assistant description: >- The natural-language analytics assistant — a guarded text-to-SQL loop (SSE) that answers ad-hoc questions over the org's CRM data as a least-privilege, read-only database role. - name: Account Readiness description: >- Account Readiness Profiles — AI-scored signals on whether an account is ready for outreach or expansion, computed via a Temporal workflow. - name: Integrations description: >- Pipedream Connect — issuing connect tokens and managing the org's connected third-party accounts. - name: Feedback description: >- User-submitted platform feedback (bug reports, feature requests) — global, not scoped to one organization. - name: Public Media description: >- Unauthenticated image reads for publicly-embeddable assets (card photos, inline email images) — allowlisted by key shape; everything else in the storage bucket stays private. - name: Service Health description: Service liveness. paths: /activities/meetings: get: tags: - Activities summary: List Meetings description: >- List meetings (activities with type='meeting') for the active org. Filters: from / to (ISO 8601, applied to due_at), owner_id, account_id. `order` may be 'asc' or 'desc' (applied to due_at). NULLS go last either way so unscheduled meetings sort to the bottom. operationId: list_meetings_activities_meetings_get parameters: - name: from in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only return meetings with due_at on or after this ISO 8601 timestamp — filters due_at, not effective_time. title: From description: >- Only return meetings with due_at on or after this ISO 8601 timestamp — filters due_at, not effective_time. - name: to in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only return meetings with due_at on or before this ISO 8601 timestamp — filters due_at, not effective_time. title: To description: >- Only return meetings with due_at on or before this ISO 8601 timestamp — filters due_at, not effective_time. - name: owner_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter to meetings owned by this user's id. title: Owner Id description: Filter to meetings owned by this user's id. - name: account_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter to meetings linked to this account. title: Account Id description: Filter to meetings linked to this account. - name: deal_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter to meetings linked to this deal. title: Deal Id description: Filter to meetings linked to this deal. - name: unlinked_account in: query required: false schema: type: boolean description: >- If true, only return meetings with no account_id. Combining with an explicit account_id filter yields an empty result. default: false title: Unlinked Account description: >- If true, only return meetings with no account_id. Combining with an explicit account_id filter yields an empty result. - name: unlinked_deal in: query required: false schema: type: boolean description: >- If true, only return meetings with no deal_id. Combining with an explicit deal_id filter yields an empty result. default: false title: Unlinked Deal description: >- If true, only return meetings with no deal_id. Combining with an explicit deal_id filter yields an empty result. - name: order in: query required: false schema: type: string description: >- Sort direction for due_at, compared case-insensitively: 'asc' (any capitalization) sorts ascending, anything else sorts descending. Meetings with no due_at always sort last. default: desc title: Order description: >- Sort direction for due_at, compared case-insensitively: 'asc' (any capitalization) sorts ascending, anything else sorts descending. Meetings with no due_at always sort last. - name: limit in: query required: false schema: type: integer description: Maximum rows to return; capped at 500 server-side. default: 200 title: Limit description: Maximum rows to return; capped at 500 server-side. - name: offset in: query required: false schema: type: integer description: Number of rows to skip, for pagination. default: 0 title: Offset description: Number of rows to skip, for pagination. responses: '200': description: Successful Response content: application/json: schema: type: array items: additionalProperties: true type: object title: Response List Meetings Activities Meetings Get '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````