List files

GET/api/v1/files

GET /files

curl -X GET 'https://www.unitpost.com/api/v1/files' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'

Response · 200

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "file",
      "id": "id_123",
      "purpose": "sms_opt_in_evidence",
      "status": "awaiting_upload",
      "filename": "string",
      "content_type": "string",
      "size_bytes": 1,
      "sha256": "string",
      "failure_reason": "string",
      "upload": {
        "url": "https://example.com",
        "method": "PUT",
        "headers": {},
        "expires_at": "2026-01-01T00:00:00.000Z"
      },
      "created_at": "2026-01-01T00:00:00.000Z",
      "expires_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

The workspace's unexpired files, newest first, of the purposes this credential may use (sms:manage: the SMS purposes; templates:write or branding:write: image). purpose narrows it. Requires the sms:manage or templates:write or branding:write capability.

Parameters4 fields

Field	Type	Description
`limit`	integer · query	Max rows to return (default 20, max 100).
`after`	string · query	Return rows after this id (forward paging).
`before`	string · query	Return rows before this id (backward paging).
`purpose`	string · query	Only files of this purpose.

Response · 200 fields12 fields

Field	Type	Description
`object`required	string	—
`id`required	string	—
`purpose`required	enumsms_opt_in_evidence \| sms_document \| image	What the file is for: `sms_opt_in_evidence` (PNG, up to 400 KB), `sms_document` (PDF, PNG or JPEG, up to 3 MB), `image` (PNG, JPEG, GIF or WebP, up to 5 MB).
`status`required	enumawaiting_upload \| ready \| failed	`ready`: checked and usable by `file_id`. `awaiting_upload`: an upload session whose bytes haven't been PUT yet (reading the file checks again). `failed`: the uploaded bytes were refused (`failure_reason` says why).
`filename`required	string	—
`content_type`required	string	The type the file's bytes carry (checked by their contents), or, before an upload session's bytes arrive, the type declared.
`size_bytes`required	integer	—
`sha256`required	string \| null	The hex SHA-256 of the bytes once `ready`.
`failure_reason`required	string \| null	—
`upload`required	object \| null	An upload session's PUT, in the create response only (null otherwise).
`created_at`required	string	—
`expires_at`required	string	The file is deleted at this time, 24 hours after it was created, whether or not it was used. An operation that used it keeps its own copy.

200401403422

List files

List files

Search docs and guides