Jobs API reference

Generated from the OpenAPI specification (version 2026-10-01). Base URL: https://app.meetingize.com/api. All requests need Authorization: Bearer <API key or OAuth token>. Try them in the API explorer.

List processing jobs

GET /v1/jobs

What jobs are: every long operation started through the API (processing of a meeting you created, generation of a document) is tracked by a job. A job tells you where the processing is (status, stage, progress), what it produced (meeting_id, document_id), what went wrong (error) and what it cost (usage, once metered).

Lifecycle: queued -> processing -> completed | failed (canceled if the meeting was deleted). A meeting_processing job goes through stages downloading (audio_url only), transcribing, summarizing (skipped with transcribe_only), done; it is completed when the AI report is ready. Documents requested at creation get their own document_generation jobs, listed in document_job_ids (their parent_job_id points back).

Use this list to find what is still running (?status=processing) or to reconcile after a missed webhook. Jobs of meetings processed in the webapp are not listed. Any valid credential.

Parameter	In	Type	Required	Description
cursor	query	string
kind	query	document_generation, meeting_processing		meeting_processing or document_generation.
limit	query	integer
status	query	canceled, completed, failed, processing, queued		queued, processing, completed, failed or canceled.

Responses

• 200:
• 400: Validation error
• 401: Missing or invalid credential
• 403: Insufficient scope
• 404: Not found (also for resources of other accounts)
• 429: Rate limit (rate_limited) or parallel processing quota (parallel_processing_limit) exceeded; see Retry-After

Response fields (200)

Field	Type	Required	Description
data	array of object	yes
has_more	boolean	yes
next_cursor	string | null	yes

curl -s "https://app.meetingize.com/api/v1/jobs" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY"

Get a job (poll this)

GET /v1/jobs/{job_id}

Current state of a job. Poll every 10 to 30 seconds until status is completed or failed (or use webhooks instead of polling). On completed: for a meeting, read GET /meetings/{meeting_id} (and its transcript/summary); for a document, GET /documents/{document_id}. Any valid credential.

Parameter	In	Type	Required	Description
job_id	path	string	yes

Responses

• 200:
• 400: Validation error
• 401: Missing or invalid credential
• 403: Insufficient scope
• 404: Not found (also for resources of other accounts)
• 429: Rate limit (rate_limited) or parallel processing quota (parallel_processing_limit) exceeded; see Retry-After

Response fields (200)

Field	Type	Required	Description
id	string	yes
object	string	yes
kind	meeting_processing, document_generation	yes
status	queued, processing, completed, failed, canceled	yes	queued -> processing -> completed | failed (or canceled)
stage	queued, downloading, transcribing, summarizing, generating, done | null		Finer progress: meeting_processing = queued, downloading (audio_url), transcribing, summarizing, done; document_generation = queued, generating, done
progress	number | null
meeting_id	string | null
document_id	string | null		document_generation: doc_ once completed
parent_job_id	string | null		document_generation started by a meeting creation (document_templates)
transcribe_only	boolean | null
document_templates	array | null
document_job_ids	array | null		meeting_processing: document jobs spawned after the AI report
error	object | null
usage	object | null
metadata	object | null
created_at	string (date-time)	yes
started_at	string | null
finished_at	string | null

curl -s "https://app.meetingize.com/api/v1/jobs/<job_id>" \
  -H "Authorization: Bearer $MEETINGIZE_API_KEY"