List files
/filesLists the files stored in the current account, using cursor-based pagination. Results are sorted by creation date, newest first.
The collection can be filtered by purpose and by creation date range.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Query Parameters
Maximum number of items to return, from 1 to 200.
1 <= value <= 200Cursor for the next page, taken from page.next_cursor of the previous response.
Sort order. A leading - sorts in descending order.
Value in
- "-created_at"
Only files uploaded for this purpose.
Only items created after this date and time (ISO 8601).
date-timeOnly items created before this date and time (ISO 8601).
date-timeHeader Parameters
Optional client-generated identifier of the request, up to 64 characters from [A-Za-z0-9._-]. Echoed back in the response and recorded in the request log; it never replaces the server-generated X-Request-Id.
length <= 64Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/files"{ "data": [ { "checksum": { "md5": "string", "sha256": "string" }, "content_type": "string", "created_at": "2019-08-24T14:15:22Z", "extension": "string", "filename": "string", "id": "string", "object": "file", "purpose": "string", "size_bytes": 0, "status": "ready" } ], "page": { "limit": 1, "next_cursor": "string", "prev_cursor": "string" }}