Search files
POST/v1/files/search-query
Returns a paginated list of files for the authenticated user's organization based on the provided search criteria.
Note: If you specify expense IDs, only files directly attached to those expenses will be returned. If you wish to find files attached the line objects you must request those separately.
Note: Reimbursement lines that have been split (expense type REIMBURSEMENT_INVOICE_LINE_SPLIT) never carry
their own file attachments - the receipt is attached to the parent line instead. If you
pass the ID of a split line, this endpoint automatically resolves it to its parent line and returns the files
attached there.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
- 502
- 503
- 504
Files data
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Bad request (e.g., invalid filter parameters)
Unauthorized
Forbidden (e.g., user has no organizations, insufficient scope privileges)
Rate limit exceeded. Reduce request frequency and retry after the indicated number of seconds.
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Number of seconds to wait before retrying. Only present on 429 Too Many Requests responses.
Internal server error
Bad gateway. An upstream service could not be reached.
Service temporarily unavailable. An upstream service returned a 503 error.
Gateway timeout. An upstream service did not respond in time.