Skip to Content
SaaSFlow
DevelopersAPIReferencefiles

List files

List uploaded files, newest first, paginated. Files are the receipts and invoices attached to transactions as proof for the books.

Authentication

Checking whether you're signed in…
GET
/companies/{companyId}/files

Authorization

headerAuthorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

Path Parameters

companyId*string
Formatuuid

Query Parameters

unassignedOnly?string
Value in"true""false"
limit?|
Range0 <= value <= 500
Default100
offset?|
Range0 <= value
Default0

Response Body

Paginated list of files

application/json
  1. response
items*array<>
totalCount*number
Example Request
curl -X GET 'https://api.saasflow.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/files'
Example Response200
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",      "transactionIds": [        "string"      ],      "filename": "string",      "fileExtension": "string",      "size": -2147483648,      "storagePath": "string",      "parseStatus": "open",      "parseData": {        "amount": {          "value": 0,          "currency": "string"        },        "date": "string",        "type": "invoice"      },      "createdTime": "2019-08-24T14:15:22Z",      "createdUserId": "string",      "lastUpdatedTime": "2019-08-24T14:15:22Z",      "lastUpdatedUserId": "string"    }  ],  "totalCount": 0}