v1

latestOpenAPI 3.1.0Proprietary2026-08-06177398877.4 KB
Documents

Filter documents

Search for documents using filter criteria.

Usage

Documents are typically associated with other entities (orders, loads, services). Use filters to find documents by type, status, or date range.

Example Filters

  • Find all invoices: { "filter": { "type": { "equalTo": "INVOICE" } } }
  • Find uploaded documents: { "filter": { "status": { "equalTo": "UPLOADED" } } }
  • Find documents created today: { "filter": { "createdAt": { "greaterThanOrEqualTo": "2025-01-15T00:00:00Z" } } }
post/documents/filter

Request body

pageSizeinteger

Number of results per page

cursorstring

Pagination cursor from previous response

Response

Documents matching filter criteria

Example response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key": "doc-inv-2025-001",
      "fileName": "invoice-2025-001.pdf",
      "extension": "pdf",
      "contentType": "application/pdf",
      "fileSize": 102400,
      "uploadUrl": "https://s3.amazonaws.com/bucket/key?signature=...",
      "downloadUrl": "https://s3.amazonaws.com/bucket/key?signature=...",
      "tags": {
        "invoiceNumber": "INV-2025-001",
        "customerPO": "PO-12345"
      },
      "createdAt": "2025-01-15T10:30:00Z",
      "updatedAt": "2025-01-15T10:35:00Z"
    }
  ],
  "pagination": {
    "pageSize": 50,
    "hasNextPage": true,
    "endCursor": "eyJpZCI6IjU1MGU4NDAwLWUyOWItNDFkNC1hNzE2LTQ0NjY1NTQ0MDAwMCJ9"
  }
}