List all Bills - Asset API Documentation

GET

business

{business_id}

bills

List all Bills

curl --request GET \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/bills \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "business_id": "<string>",
      "vendor_id": "<string>",
      "number": "<string>",
      "description": "<string>",
      "total_amount": 123,
      "total_paid": 123,
      "due_at": "2023-11-07T05:31:56Z",
      "issued_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "voided_at": "2023-11-07T05:31:56Z",
      "metadata_": {},
      "lines": [
        {
          "description": "<string>",
          "ledger_id": "ldg_ErisumsAc7qgmbTctM7zKK",
          "amount": 123,
          "id": "<string>",
          "bill_id": "<string>",
          "metadata_": {}
        }
      ],
      "payments": [
        {
          "bill_id": "<string>",
          "payment_id": "<string>",
          "datetime": "2023-11-07T05:31:56Z",
          "payment_amount": 123,
          "id": "<string>",
          "transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
          "credit_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "bill": "<unknown>"
        }
      ],
      "tags": {
        "Job": [
          {
            "amount": "3000.00",
            "value": "Maple Street Remodel"
          },
          {
            "amount": "1500.00",
            "value": "Downtown Office Rewire"
          }
        ]
      }
    }
  ],
  "pagination": {
    "next_page_token": "<string>",
    "previous_page_token": "<string>"
  }
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

business_id

string<biz_string>

required

The id of the business

Example:

"biz_GA6EG2qFxA97NZHtxeLPUy"

Query Parameters

due_at_start

string<date-time> | null

Include bills due after this period (inclusive) in ISO-8601 format

due_at_end

string<date-time> | null

Include bills due before this period (exclusive) in ISO-8601 format

status

Filter bills by one or more statuses, comma-separated

page_token

string | null

The page token to for the next or previous page

page_size

integer

default:100

Required range: 1 <= x <= 100

Response

Successful Response

data

BillPublic · object[]

required

Show child attributes

pagination

PaginationResponse · object

required

Show child attributes

⌘I

List all Bills

curl --request GET \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/bills \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "business_id": "<string>",
      "vendor_id": "<string>",
      "number": "<string>",
      "description": "<string>",
      "total_amount": 123,
      "total_paid": 123,
      "due_at": "2023-11-07T05:31:56Z",
      "issued_at": "2023-11-07T05:31:56Z",
      "id": "<string>",
      "voided_at": "2023-11-07T05:31:56Z",
      "metadata_": {},
      "lines": [
        {
          "description": "<string>",
          "ledger_id": "ldg_ErisumsAc7qgmbTctM7zKK",
          "amount": 123,
          "id": "<string>",
          "bill_id": "<string>",
          "metadata_": {}
        }
      ],
      "payments": [
        {
          "bill_id": "<string>",
          "payment_id": "<string>",
          "datetime": "2023-11-07T05:31:56Z",
          "payment_amount": 123,
          "id": "<string>",
          "transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
          "credit_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "bill": "<unknown>"
        }
      ],
      "tags": {
        "Job": [
          {
            "amount": "3000.00",
            "value": "Maple Street Remodel"
          },
          {
            "amount": "1500.00",
            "value": "Downtown Office Rewire"
          }
        ]
      }
    }
  ],
  "pagination": {
    "next_page_token": "<string>",
    "previous_page_token": "<string>"
  }
}