SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester

List meetings

Newest first. q searches titles and summaries, and also the transcript when the key has the transcripts scope.

GEThttps://app.softsolz.uk/api/v1/services/meetings/meetings

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Query Params

qstring

Words to search for.

statusstring

upcoming, live or past.

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Number of meetings to skip (default 0).

Response

Response Body · array of objects

idstringMeeting id.
titlestring | nullMeeting title.
platformstring | nullzoom, meet or teams.
meeting_urlstringThe link the assistant was sent to.
modestringWhat the assistant does.
spoken_languagestringLanguage spoken in the meeting.
notes_languagestring | nullLanguage of the notes.
meeting_typestringTeam or client meeting.
statusstringscheduled, joining, waiting, in_call, ended, failed or canceled.
status_reasonstring | nullWhy a meeting failed or was canceled.
join_atstring | nullWhen it joins.
started_atstring | nullWhen it began.
ended_atstring | nullWhen it ended.
summarystring | nullWritten summary once the notes are ready.
decisionsarray of stringsDecisions made in the meeting.
action_itemsarray of objectsAction items found in the meeting.
key_pointsarray of stringsKey points of the meeting.
chaptersarray | nullThe meeting topic by topic, in order. Null for meetings written before chapters existed.
report_statusstringState of the notes: pending, ready or failed.
recordingobjectThe recording choice.
sender_namestring | nullWho sent the assistant.
created_atstringWhen it was created.
updated_atstringWhen it last changed.
matchobjectWhy a search found this meeting. Only present when q is sent.

Request

curl --request GET \
--url https://app.softsolz.uk/api/v1/services/meetings/meetings \
--header 'Authorization: Bearer sk_live_your_key'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": [
{
"id": "your-id",
"title": "your-title",
"platform": "your-platform",
"meeting_url": "https://example.com",
"mode": "listen",
"spoken_language": "your-spoken-language",
"notes_language": "your-notes-language",
"meeting_type": "team",
"status": "your-status",
"status_reason": "your-status-reason",
"join_at": "2026-01-01T09:00:00.000Z",
"started_at": "2026-01-01T09:00:00.000Z",
"ended_at": "2026-01-01T09:00:00.000Z",
"summary": "your-summary",
"decisions": [
"your-decisions"
],
"action_items": [],
"key_points": [
"your-key-points"
],
"chapters": [
{
"title": "your-title",
"at": 1,
"points": [
"your-points"
]
}
],
"report_status": "your-report-status",
"recording": {
"kind": "none",
"status": "your-status"
},
"sender_name": "your-sender-name",
"created_at": "2026-01-01T09:00:00.000Z",
"updated_at": "2026-01-01T09:00:00.000Z",
"match": {
"kind": "your-kind",
"text": "your-text",
"speaker": "your-speaker",
"at": "2026-01-01T09:00:00.000Z"
}
}
],
"meta": {
"limit": 50,
"offset": 0,
"total": 1,
"has_more": false
}
}