Skip to main content

​
List Bills

Retrieve a list of bills for the authenticated business.
​
schema
string
required
Schema identifier. Must be bills
​
page
number
Page number for pagination
​
limit
number
Number of records per page
​
date_order
string
Order records by date. Values: asc (oldest first) or desc (newest first). Default: desc

​
Get Bill

Retrieve a specific bill by UUID or source_uuid.
​
uuid
string
required
Bill UUID or source_uuid

​
Create Bill

Create a new bill using AI prompt.
​
prompt
string
required
Description of the bill to create
​
attachments
array
Array of attachment URLs or file references
​
text_attachment
string
Additional text context
curl -X POST "https://api.useadam.io/v1/adam/bills" \
  -H "X-API-Key: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Create a bill from XYZ Supplier for $300 for office supplies dated today"
  }'

​
Update Bill

Update an existing bill by UUID or source_uuid.
​
uuid
string
required
Bill UUID or source_uuid

​
Update Bill Payment

Add or update payments for a bill.
​
uuid
string
required
Bill UUID or source_uuid
​
payments
array
required
Array of payment objects
​
payments[].uuid
string
Payment UUID if updating existing payment
​
payments[].amount_paid
number
required
Payment amount
​
payments[].category
string
required
Bank account name where the payment was made or received
​
payments[].date
string
required
Payment date (YYYY-MM-DD)
​
payments[].exchange_rate
number
Exchange rate if different currency
​
overwrite
boolean
If true, replaces all existing payments. Default: false
curl -X POST "https://api.useadam.io/v1/adam/bills/bill-uuid/payments" \
  -H "X-API-Key: your_secret_key" \
  -H "Content-Type: application/json" \
  -d '{
    "payments": [
      {
        "amount_paid": 300.00,
        "category": "Chase Bank",
        "date": "2024-01-25"
      }
    ]
  }'

​
Delete Bill

Delete a bill by UUID or source_uuid.
​
uuid
string
required
Bill UUID or source_uuid