GET/files

List files

Requires Bearer authentication. See Authentication.

Responses

200 200

Field Type Description

filesrequired array —

idrequired string (uuid) —

tenantIdrequired string (uuid) —

customerAccountIdrequired string (uuid) —

fileTyperequired string —

sourcerequired object —

`kind`required	"s3" \| "gcs"	—
`uri`required	string	—
`bucket`required	string	—
`key`required	string	—

contentTyperequired string —

sizeBytesrequired string —

sha256required string —

fileNamerequired string —

metadatarequired object (record) —

environmentrequired "PRODUCTION" | "STAGING" | "DEVELOPMENT" —

statusrequired enum (5) —

createdAtrequired string (date-time) —

updatedAtrequired string (date-time) —

nextCursorrequired string —

401 401

Field Type Description

errorrequired object —

`code`required	string	—
`message`required	string	—
`details`	any	—

Errors

Errors use the standard envelope. See Errors for codes, status mappings, and retry semantics.

{ "files": [ { "id": "00000000-0000-0000-0000-000000000000", "tenantId": "00000000-0000-0000-0000-000000000000", "customerAccountId": "00000000-0000-0000-0000-000000000000", "fileType": "string", "source": { "kind": "s3", "uri": "string", "bucket": "string", "key": "string" }, "contentType": "string", "sizeBytes": "string", "sha256": "string", "fileName": "string", "metadata": {}, "environment": "PRODUCTION", "status": "PENDING", "createdAt": "2026-06-24T18:04:16.527Z", "updatedAt": "2026-06-24T18:04:16.527Z" } ], "nextCursor": "string" }