Skip to main content
PATCH
/
v0
/
business
/
{business_id}
/
bills
/
{bill_id}
Update a Bill
curl --request PATCH \
  --url https://api.sandbox.getasset.com/v0/business/{business_id}/bills/{bill_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "number": "BILL-002",
  "description": "Updated office supplies",
  "due_at": "2025-03-01T00:00:00Z",
  "issued_at": "2025-01-20T00:00:00Z",
  "status": "open",
  "line_changes": {
    "create_lines": [
      {
        "description": "<string>",
        "amount": 120.52,
        "ledger_id": "<string>",
        "metadata_": {}
      }
    ],
    "delete_lines": [
      "<string>"
    ]
  }
}
'
{
  "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.

Path Parameters

business_id
string<biz_string>
required

The id of the business

Example:

"biz_GA6EG2qFxA97NZHtxeLPUy"

bill_id
string<bil_string>
required

The id of the bill

Example:

"bil_WQMDNUHpBThYSNh4AprDBo"

Body

application/json
number
string | null

The new number of the bill

Example:

"BILL-002"

description
string | null

The new description of the bill

Example:

"Updated office supplies"

due_at
string<date-time> | null

The new due date of the bill in ISO-8601 format

Example:

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

issued_at
string<date-time> | null

The new issued date of the bill in ISO-8601 format

Example:

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

status
enum<string> | null

The new status of the bill

Available options:
open,
paid,
voided
Example:

"open"

line_changes
BillLineChanges · object

The changes to the lines of the bill

Response

Successful Response

data
BillPublic · object
required