cURL
Files
List
Paginated list of your uploaded files.
GET
cURL
Authorizations
Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.
Headers
API version header.
Available options:
2026-03-01 Example:
"2026-03-01"
Query Parameters
Only return files uploaded with this purpose. What a file is used for.
Available options:
agent_background_sound, fine_tune, tts_generation, voice-clone Only return files whose filename contains this substring.
Example:
"background"
The number of files to return per page, ranging between 1 and 100.
Example:
10
A cursor for pagination. starting_after is a file ID; the response returns the page of files after it.
Example:
"file_EneDabCuJCpfe5CFi5X12e"
A cursor for pagination. ending_before is a file ID; the response returns the page of files before it.