bills

Fetch bills matching the supplied arguments.

Arguments

Argument	Type	Required	Description
`from_date`	ISODateTime	No	Inclusive start of the date range, in ISO-8601 datetime format.
`to_date`	ISODateTime	No	Inclusive end of the date range, in ISO-8601 datetime format.
`status`	`String`	No	Filter by status; use values returned by the corresponding status field.
`analyze`	`Boolean`	No	If true, the query will only be analyzed (cost estimated) without executing it.

Return Type

BillsQueryResult

Query

query bills(
  $from_date: ISODateTime,
  $to_date: ISODateTime,
  $status: String,
  $analyze: Boolean
) {
  bills(
    from_date: $from_date,
    to_date: $to_date,
    status: $status,
    analyze: $analyze
  ) {
    request_id
    complexity
    data {
      ...BillConnectionFragment
    
      pageInfo {
        ...PageInfoFragment
      
        hasNextPage
        hasPreviousPage
        startCursor
        endCursor
      }
      edges {
        ...BillEdgeFragment
      
        node {
          ...BillFragment
        
          id
          legacy_id
          status
          customer_name
          profile_name
          created_at
          due_date
          amount
          totals {
            ...FeeCategoryTotalConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...FeeCategoryTotalEdgeFragment
            
              node {
                ...FeeCategoryTotalFragment
              
                id
                legacy_id
                amount
                label
                category
                quantity
              }
              cursor
            }
          }
          bill_exports {
            ...BillExportsConnectionFragment
          
            pageInfo {
              ...PageInfoFragment
            
              hasNextPage
              hasPreviousPage
              startCursor
              endCursor
            }
            edges {
              ...BillExportsEdgeFragment
            
              node {
                ...BillExportsFragment
              
                id
                legacy_id
                status
                file_url
              }
              cursor
            }
          }
          billing_period {
            ...BillingPeriodFragment
          
            start
            end
          }
          billing_frequency
        }
        cursor
      }
    }
  }
}

Variables

{
  "from_date": "2026-07-09T15:30:00Z",
  "to_date": "2026-07-09T15:30:00Z",
  "status": "pending",
  "analyze": true
}

Response

{
  "data": {
    "bills": {
      "request_id": "UmVjb3JkOjEyMzQ=",
      "complexity": 100,
      "data": [{id: "QmlsbDoxMjM0"}]
    }
  }
}