Sign in

v1

latestOpenAPI 3.1.02026-07-226875162.5 KB
Organization

List Organization Notes

List ended notes in the workspaces of the organization bound to the API key, with cursor-based pagination. A note is "ended" when its recording has finished (recordingEndAt is set) — the same condition that fires the note.ended webhook event.

Filter by endedAfter / endedBefore (ISO 8601, applied to recordingEndAt) to bound the window. Results are ordered by note ID descending (newest-created first) with an ID-based cursor; the time filters bound the window, they do not change the sort order.

get/v1/external/organizations/me/notes

Query parameters

endedAfterstring date-time

ISO 8601 datetime — return only notes with recordingEndAt >= this value.

endedBeforestring date-time

ISO 8601 datetime — return only notes with recordingEndAt < this value.

cursorstring

Cursor for the next page

sizeinteger

Page size (default 100, max 200)

Response

List of ended notes in the organization's workspaces

nextCursorstring nullable required

Cursor for next page, null if last page

Example response

{
  "content": [
    {
      "guid": "note-guid-123",
      "workspaceGuid": "ws_a1b2c3d4",
      "title": "Meeting notes",
      "createdAt": "2025-07-20T10:00:00Z",
      "updatedAt": "2025-07-20T11:10:00Z",
      "sourceType": "live-voice",
      "recordingStartAt": "2025-07-20T10:00:10Z",
      "recordingEndAt": "2025-07-20T11:00:10Z",
      "recordingDurationSeconds": 3600,
      "transcribeLocale": "en_US",
      "translateLocale": "ko_KR",
      "webUrl": "https://tiro.ooo/n/123",
      "collaborators": [
        {
          "guid": "user-guid-123",
          "name": "John Doe",
          "email": "john@example.com",
          "role": "OWNER"
        }
      ],
      "participants": [
        {
          "name": "Alice Kim",
          "email": "alice@example.com"
        }
      ],
      "documents": [
        {
          "id": 456,
          "noteGuid": "note-abc123-def456",
          "note": {
            "guid": "note-abc123-def456",
            "webUrl": "https://tiro.ooo/n/xQ8YKnZUPGHNB"
          },
          "template": {
            "id": 1,
            "title": "영업 보고서"
          },
          "locale": "ko_KR",
          "sections": [
            {
              "content": {
                "type": "text/plain",
                "content": "Hello everyone, welcome to today's meeting..."
              },
              "createdAt": "2025-10-20T12:35:26Z"
            }
          ],
          "createdAt": "2025-10-20T12:35:26Z",
          "updatedAt": "2025-10-20T13:45:30Z"
        }
      ]
    }
  ],
  "nextCursor": "opaque-cursor-string"
}