List meetings

Returns your meetings, newest first by default.

GET/meetings

Required scope: meetings:read
Authentication: Authorization: Bearer
Rate-limit policy: readaccount

Archived meetings are hidden unless archived says otherwise. List items omit participants, speakers and counts; fetch one meeting to get them. Every item carries the current transcript.revision, which takes time proportional to the length of its transcript, so pages of very long meetings answer slower: use a smaller limit when you walk your whole history.

Parameters

Parameters
Name	In	Type	Required	Default	Constraints	Description
`status`	query	`array<string>` repeatable	no	–	–	Filter by derived status. Repeat the parameter to match several (`status=ready&status=failed`). Allowed values: `draftrecordinguploadedprocessingreadyfailed`
`archived`	query	`string`	no	`false`	–	Return active (`false`), archived (`true`) or all (`all`) items. Allowed values: `falsetrueall`
`created_after`	query	`string`	no	–	≤ 64 characters	Only meetings created after this moment (exclusive). RFC 3339 date or date-time. Compared in milliseconds, like the timestamps in responses, so passing back a returned timestamp never returns that same item again.
`created_before`	query	`string`	no	–	≤ 64 characters	Only meetings created before this moment (exclusive). RFC 3339 date or date-time. Compared in milliseconds, like the timestamps in responses, so passing back a returned timestamp never returns that same item again.
`updated_after`	query	`string`	no	–	≤ 64 characters	Only meetings changed after this moment (exclusive). RFC 3339 date or date-time. Compared in milliseconds, like the timestamps in responses, so passing back a returned timestamp never returns that same item again.
`q`	query	`string`	no	–	≤ 200 characters	Search in the title.
`sort`	query	`string`	no	`created_at`	–	Field to sort by. Allowed values: `created_atupdated_at`
`order`	query	`string`	no	`desc`	–	Sort direction. Allowed values: `descasc`
`limit`	query	`integer`	no	`20`	1–100 · format: int32	Page size, from 1 to 100. Default 20. Follow `has_more`, not the page size.
`cursor`	query	`string`	no	–	≤ 1024 characters	Opaque cursor from `next_cursor` of the previous page. Cursors are tied to the user, route, sort order and filters.

Response

200

A page of meetings.

RateLimit The most restrictive policy that applied: "name";r=<requests left>;t=<seconds>, where t is the number of seconds until one more request is allowed (0 when the quota is full). Absent when no rate limiter ran for the request.
RateLimit-Policy The rate-limit policies that applied to the request, one "name";q=<burst>;w=<seconds> item per policy, for example "read";q=10;w=2, "account";q=20;w=2: q is the burst quota and w the seconds in which an empty quota refills. Sent on every authenticated response; absent when no rate limiter ran for the request, for example when it was rejected before the key was checked.
Request-Id ID of this request (req_ prefix), the same as request_id in an error body. It is also sent as X-Request-ID. Quote it when you contact support.
X-Client-Request-Id Your own X-Client-Request-Id request header, echoed back. It is sent only when the value you sent has 1-128 characters from A-Z a-z 0-9 . _ : -.
X-RateLimit-Limit Burst quota of the most restrictive policy (q in RateLimit-Policy). Absent when no rate limiter ran.
X-RateLimit-Remaining Requests left in the most restrictive policy (r in RateLimit). Absent when no rate limiter ran.
X-RateLimit-Reset Seconds until one more request is allowed in the most restrictive policy (t in RateLimit; 0 when the quota is full). It is a number of seconds, not a timestamp. Absent when no rate limiter ran.

Content type: application/json

objectstringrequired
Always list.
dataarray<object>required
The items of this page.
17 fields
- idstringrequired
  Public meeting ID (mtg_ prefix).
  26–26 characters · pattern: ^mtg_[0-9A-Za-z]{22}$
- objectstringrequired
  Always meeting.
- titlestringrequired
  Meeting title.
- languagestring | nullrequired
  Language code of the meeting, for example lt.
- statusstringrequired
  Derived status. Archived meetings keep the status of their latest processing run.
  Allowed values: draftrecordinguploadedprocessingreadyfailed
- archivedbooleanrequired
  Whether the meeting is archived.
- created_atstringrequired
  When the meeting was created.
  ≤ 24 characters · format: date-time
- updated_atstringrequired
  When the meeting was last changed.
  ≤ 24 characters · format: date-time
- started_atstring | nullrequired
  Real start time, or null while unknown. It is not aliased to created_at.
  ≤ 24 characters · format: date-time
- duration_msinteger | nullrequired
  Duration in milliseconds, or null.
  0–9007199254740991 · format: int64
- web_urlstringrequired
  Link to the meeting in the Diko app.
  format: uri
- processingobjectrequired
  Latest processing run.
  3 fields
  - statusstring | nullrequired
    Processing status, or null when no run exists.
    Allowed values: queuedtranscribingdiarizingsummarizingcompletefailedcanceled
  - progressnumber | nullrequired
    Progress from 0 to 1, or null.
    0–1
  - errorobject | nullrequired
    Error details when processing failed.
    2 fields
    codestringrequired
    Stable error code. Unknown internal codes are reported as internal_error.
    Allowed values: upload_unavailableaudio_invalidaudio_too_longtranscription_failedtranscription_timeoutprovider_limitcanceledinternal_error
    messagestringrequired
    Explanation in the language of Accept-Language. Never an internal error text.
- transcriptobjectrequired
  Transcript summary.
  4 fields
  - statusstringrequired
    Transcript status.
    Allowed values: noneprocessingready
  - revisionstring | nullrequired
    Opaque token that changes whenever any segment changes.
  - segment_countintegerrequired
    Number of segments.
    0–2147483647 · format: int32
  - has_pending_editsbooleanrequired
    Whether grammar suggestions are waiting for approval in Diko.
- minutesobjectrequired
  Minutes summary.
  3 fields
  - statusstringrequired
    Minutes status.
    Allowed values: nonegeneratingreadyfailedinsufficientunavailable
  - versioninteger | nullrequired
    Version number of the latest ready minutes.
    0–2147483647 · format: int32
  - verification_statusstring | nullrequired
    Result of the evidence check: verified, repaired after a second pass, or unverified.
    Allowed values: verifiedrepairedunverified
- participantsarray<object>
  Participants. Only in the single-meeting response.
  5 fields
  - idstringrequired
    Public participant ID (prt_ prefix).
    26–26 characters · pattern: ^prt_[0-9A-Za-z]{22}$
  - objectstringrequired
    Always participant.
  - namestring | nullrequired
    Participant name.
  - emailstring | nullrequired
    Participant e-mail address, if known.
  - rolestring | nullrequired
    Participant role, if known.
- speakersarray<object>
  Speakers. Only in the single-meeting response.
  4 fields
  - idstringrequired
    Public speaker ID (spk_ prefix).
    26–26 characters · pattern: ^spk_[0-9A-Za-z]{22}$
  - objectstringrequired
    Always speaker.
  - labelstringrequired
    Automatic label such as SPEAKER_00.
  - namestring | nullrequired
    Name assigned to the speaker, if any.
- countsobject
  Counts. Only in the single-meeting response.
  4 fields
  - participantsintegerrequired
    Number of participants.
    0–2147483647 · format: int32
  - speakersintegerrequired
    Number of speakers.
    0–2147483647 · format: int32
  - action_itemsintegerrequired
    Number of action items.
    0–2147483647 · format: int32
  - commentsintegerrequired
    Number of comments.
    0–2147483647 · format: int32
has_morebooleanrequired
Whether more items follow. Keep paging while this is true.
next_cursorstring | nullrequired
Cursor for the next page, or null when has_more is false.
≤ 1024 characters

Examples

Request

cURL

curl "https://api.diko.app/api/v1/meetings?status=ready&limit=20" \
  -H "Authorization: Bearer $DIKO_API_KEY"

Python

import os

import requests

response = requests.get(
    "https://api.diko.app/api/v1/meetings",
    headers={"Authorization": f"Bearer {os.environ['DIKO_API_KEY']}"},
    params={"status": ["ready"], "limit": 20},
    timeout=30,
)
response.raise_for_status()
print(response.json())

TypeScript

const response = await fetch("https://api.diko.app/api/v1/meetings?status=ready&limit=20", {
  headers: {
    Authorization: `Bearer ${process.env.DIKO_API_KEY}`,
  },
})
if (!response.ok) throw new Error(`${response.status} ${await response.text()}`)
console.log(await response.json())

Example response · 200 · application/json

JSON

{
  "object": "list",
  "data": [
    {
      "id": "mtg_5uF4g2Xu1i0qz3yAp0CP7W",
      "object": "meeting",
      "title": "Pardavimų aptarimas",
      "language": "lt",
      "status": "ready",
      "archived": false,
      "created_at": "2026-10-11T08:00:00.000Z",
      "updated_at": "2026-10-11T09:30:00.000Z",
      "started_at": null,
      "duration_ms": 3541000,
      "web_url": "https://studio.diko.app/meetings/c2171dae-bbc2-53b3-92b9-ba8c37850ff6",
      "processing": {
        "status": "complete",
        "progress": 1,
        "error": null
      },
      "transcript": {
        "status": "ready",
        "revision": "r_1bedcb71b3a1fdc6bfeeb92054fc6f92",
        "segment_count": 412,
        "has_pending_edits": false
      },
      "minutes": {
        "status": "ready",
        "version": 2,
        "verification_status": "verified"
      }
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors

This endpoint can return these errors. Every code is described in the error catalog.

HTTP	Code	Meaning	Retry?
400	`invalid_parameter`	A path, query or body parameter has an invalid value, a required field is missing or a field is unknown (unknown fields are rejected). `error.param` names the parameter.	no
400	`invalid_cursor`	The `cursor` is corrupted or was issued for another user, route, sort order or set of filters.	no
401	`missing_api_key`	The request has no `Authorization` header.	no
401	`invalid_api_key`	The header is unusable (a scheme other than `Bearer`, an empty key or more than one `Authorization` header) or the key is unknown or malformed (wrong structure or checksum). The response is identical in all these cases.	no
401	`api_key_expired`	The key has expired.	no
401	`api_key_revoked`	The key was revoked: manually, after a rotation grace period ended, because of a leak or because the account was disabled.	no
401	`api_key_disabled`	The key is temporarily disabled.	no
402	`subscription_required`	The account has no active paid access.	no
403	`ip_not_allowed`	The key has an IP allowlist and the request IP is not on it, or it cannot be determined reliably.	no
403	`account_disabled`	The account is disabled.	no
403	`email_not_verified`	The account e-mail address is not verified.	no
403	`api_access_suspended`	A Diko administrator suspended API access for this account.	no
403	`plan_required`	The plan does not include the API. `error.details.required_plans` lists `verslas`.	no
403	`insufficient_scope`	The key lacks the scope this endpoint needs. `error.details` contains `required_scopes` and `granted_scopes`.	no
429	`rate_limit_exceeded`	A rate-limit policy was exceeded. `error.details.policy` names it.	yes, after Retry-After
500	`internal_error`	An internal server error.	conditionally
503	`service_unavailable`	The service is temporarily busy, for example because of database load.	yes, after Retry-After