Skip to main content
GET
List Recordings & Uploads Endpoint
This endpoint is in beta. The interface is stable enough to build on; we may add fields as it matures.

Overview

Returns two separate lists for your workspace:
  • recordings — audio from calls placed on your Tuco line, captured automatically.
  • items — files you uploaded, via Upload attachment or the Leads → Upload audio etc tab.
Use this when you want everything in the workspace. To pull the calls made to one specific lead, use Get call recordings instead — that endpoint takes a phone number and returns full call timing.

Making a request

  • Method: GET
  • URL: https://app.tuco.ai/api/attachments/list
  • Headers: Authorization: Bearer tuco_...

Query parameters

number
Max entries to return per list. Default 20, min 1, max 100.
string
Opaque cursor from a previous response’s nextCursor, to page through uploads.
string
Opaque cursor from a previous response’s recordingsNextCursor, to page through recordings. Recordings and uploads paginate independently — see Paging.

Response

array
Call recordings, newest first.
string
Cursor for the next page of recordings, or null.
boolean
Whether more recordings exist beyond this page.
array
Files you uploaded, newest first.
string
Cursor for the next page of uploads, or null.
boolean
Whether more uploads exist beyond this page.

Paging

Recordings and uploads are paged independently, each with its own cursor. Pass recordingsCursor to advance recordings and cursor to advance uploads; you can send both, either, or neither.
limit applies to each list, so limit=20 can return up to 20 recordings and up to 20 uploads in one response.
Every url is a signed link that expires. Do not store it — keep the callId (for recordings) or pathname, and call this endpoint again when you need fresh links. The audio itself is kept indefinitely; only the link is time-limited.
Links from this endpoint are valid for 1 year. Note that the same recording requested via Get call recordings returns a link valid for 30 days — treat both as short-lived and re-fetch rather than caching either.

Format

Call recordings are MP3, mono — both sides of the conversation are mixed into a single channel. Good for playback and transcription; not suited to separating the speakers.

Scope

You only ever see your own workspace’s recordings and uploads. The API key you authenticate with determines the workspace, and there is no parameter to query another one.

Errors