THthredfi
Bills

List bills

List all bills for a business with filters for status, vendor, dates, reference numbers, and amounts. Supports standardized pagination.

get/v1/platform/businesses/{business_id}/bills/

Request

  • Base URL
    https://docs.thredfi.com (the document declares no server; this is the origin it was published from)
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or HTTP basic
    • or HTTP bearer
    • or HTTP bearer

Path parameters

business_idstring required

Query parameters

due_at_endstring date-time

Bills due on/before this timestamp (ISO format)

due_at_startstring date-time

Bills due on/after this timestamp (ISO format)

max_amountinteger

Maximum total amount in cents

memostring

Exact memo match

memo_containsstring

Memo contains substring (case-insensitive)

min_amountinteger

Minimum total amount in cents

pageinteger

Page number (1-indexed, default: 1)

page_sizeinteger

Number of items per page (default: 20, max: 100)

received_at_endstring date-time

Bills received on/before this timestamp (ISO format)

received_at_startstring date-time

Bills received on/after this timestamp (ISO format)

reference_numbersstring

Filter by reference numbers (comma-separated). Searches bill_number, vendor_bill_number, purchase_order_number

searchstring
sortstring

Sort order. Values: created_at, -created_at, updated_at, -updated_at (prefix with - for descending)

statusstring

Filter by bill status (comma-separated). Values: received, partially_paid, paid, voided

vendor_external_idstring

Filter by vendor external ID

vendor_idstring

Filter by vendor ID (supports comma-separated UUIDs for multiple vendors)

Response

countinteger required

Total number of items

Example response

{
  "count": 123,
  "page_info": {
    "total_count": 123,
    "current_page": 1,
    "total_pages": 7,
    "page_size": 20
  }
}

Changes