cURL
Files
Get
Retrieve a file’s metadata.
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"
Path Parameters
ID of the file.
Example:
"file_EneDabCuJCpfe5CFi5X12e"
Response
An uploaded file.
Unique identifier for the file, prefixed with file_.
Example:
"file_EneDabCuJCpfe5CFi5X12e"
Original filename.
Example:
"background-sound.wav"
What a file is used for.
Available options:
agent_background_sound, fine_tune, tts_generation, voice-clone Example:
"agent_background_sound"
Size of the file in bytes.
Example:
2048576
Processing status of the file.
Example:
"ready"
ID of the account that owns the file.
Example:
"org_2x6zg1zx5cnZJHwZCJypdW6YIiC"
Timestamp when the file was created.
Example:
"2026-07-25T18:30:00.000Z"