Skip to main content
POST
/
v0
/
business
/
{business_id}
/
bills
Create Bills
curl --request POST \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/bills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "business_id": "<string>",
    "number": "<string>",
    "description": "<string>",
    "due_at": "2023-11-07T05:31:56Z",
    "issued_at": "2023-11-07T05:31:56Z",
    "vendor_id": "<string>",
    "lines": [
      {
        "description": "<string>",
        "amount": 120.52,
        "ledger_id": "<string>",
        "metadata_": {}
      }
    ]
  }
]
'
{
  "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",
      "status": "open",
      "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>",
          "transaction_id": "<string>",
          "payment_id": "<string>",
          "datetime": "2023-11-07T05:31:56Z",
          "payment_amount": 123,
          "id": "<string>",
          "bill": "<unknown>"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.getasset.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Headers

x-user-id
string | null

Optional external entity identifier that performed the action

Path Parameters

business_id
string<biz_string>
required

The id of the business

Example:

"biz_GA6EG2qFxA97NZHtxeLPUy"

Body

application/json
Maximum array length: 100
business_id
string<biz_string>
required

The ID of the Business that the bill is associated with

Example:

"biz_Pk2fNFDd8wj7EFeLWJywc7"

number
string
required

The number of the bill

Example:

"BILL-001"

description
string
required

The description of the bill

Example:

"Office supplies"

due_at
string<date-time>
required

The due date of the bill in ISO-8601 format

Example:

"2025-02-15T00:00:00Z"

issued_at
string<date-time>
required

The date the bill was issued in ISO-8601 format

Example:

"2025-01-15T00:00:00Z"

vendor_id
string<ven_string>
required

The ID of the Vendor that the bill is associated with

Example:

"ven_WQMDNUHpBThYSNh4AprDBo"

lines
BillLineCreate · object[]
required

The lines of the bill

Response

Successful Response

data
BillPublic · object[]
required