Skip to main content
GET
/
coa
/
api
/
v1
/
bill
List Accounting Bills
curl --request GET \
  --url https://api.meetcampfire.com/coa/api/v1/bill/ \
  --header 'Authorization: <api-key>'
{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "count": 150,
      "next": "http://api.example.com/bills/?limit=50&offset=50",
      "previous": null,
      "results": [
        {
          "id": 31894,
          "lines": [
            {
              "id": 298626,
              "account_number": "6700",
              "account_name": "6700 - Office Expenses",
              "department_name": "Engineering",
              "bill_customer_name": "ABC Bead Supply",
              "tags": [
                {
                  "id": 8355,
                  "group_name": "Projects",
                  "parent_name": null,
                  "parent": null,
                  "name": "Project A",
                  "created_at": "2025-07-17T16:21:02+0000",
                  "last_modified_at": "2025-07-17T16:21:02+0000",
                  "group": 727
                }
              ],
              "amortization_schedule": [],
              "description": "1x Large Expense Line",
              "amount": 10000,
              "tax": 0,
              "tax_description": null,
              "source": null,
              "source_id": null,
              "currency": "USD",
              "created_at": "2025-07-25T04:24:32+0000",
              "last_modified_at": "2025-07-25T04:24:32+0000",
              "account": 2622,
              "bill_customer": 34182,
              "department": 35
            }
          ],
          "payments": [],
          "payment_journal_entries": [],
          "status": "open",
          "past_due_days": null,
          "entity_name": "Top Level",
          "entity_currency": "USD",
          "vendor_name": "ABC Bead Supply",
          "attachments": [],
          "total_amount": 10000,
          "amount_due": 10000,
          "amount_paid": 0,
          "item_date": "2025-08-01",
          "voided_date": null,
          "voided_journal_entry_order": null,
          "search_vector": null,
          "search_text": null,
          "mailing_address": "1234 Campground Road. San Francisco CA 98765",
          "terms": "net_30",
          "bill_number": "1234567",
          "bill_date": "2025-08-01",
          "due_date": "2025-08-24",
          "paid_date": null,
          "message_on_bill": "A really big expense",
          "source_id": null,
          "source": null,
          "payment_status": "open",
          "currency": "USD",
          "exchange_rate": 1,
          "exchange_rate_book": 1,
          "created_at": "2025-07-25T04:24:32+0000",
          "last_modified_at": "2025-07-25T04:24:32+0000",
          "entity": 54,
          "vendor": 34182,
          "journal_entry": 7491951,
          "source_file": null,
          "tax_rate": null
        },
        {
          "id": 31893,
          "lines": [
            {
              "id": 298625,
              "account_number": "5000",
              "account_name": "5000 - Cost of Goods Sold",
              "department_name": "Sales",
              "bill_customer_name": "XYZ Supplies",
              "tags": [],
              "amortization_schedule": [],
              "description": "Inventory purchase",
              "amount": 5000,
              "tax": 400,
              "tax_description": "Sales Tax",
              "source": null,
              "source_id": null,
              "currency": "USD",
              "created_at": "2025-07-24T10:15:22+0000",
              "last_modified_at": "2025-07-24T10:15:22+0000",
              "account": 2600,
              "bill_customer": 34180,
              "department": 36
            }
          ],
          "payments": [
            {
              "id": 5234,
              "payment_transaction_bank_description": "Check #1234",
              "payment_journal_entry_order": "JE-2025-001245",
              "currency": "USD",
              "amount": 5400,
              "payment_date": "2025-07-30",
              "source": "MANUAL",
              "source_id": null,
              "created_at": "2025-07-30T14:22:33+0000",
              "voided_date": null,
              "last_modified_at": "2025-07-30T14:22:33+0000",
              "bill": 10234,
              "payment_journal_entry": 7491960,
              "payment_transaction": 12345678,
              "voided_journal_entry": null
            }
          ],
          "payment_journal_entries": [
            7491960
          ],
          "status": "paid",
          "past_due_days": null,
          "entity_name": "Top Level",
          "entity_currency": "USD",
          "vendor_name": "XYZ Supplies",
          "attachments": [],
          "total_amount": 5400,
          "amount_due": 0,
          "amount_paid": 5400,
          "item_date": "2025-07-24",
          "voided_date": null,
          "search_vector": "'001':2A '2025':1B 'inv':3A 'supplies':5C 'xyz':4C",
          "search_text": "INV-2025-001 XYZ Supplies",
          "mailing_address": "456 Business Ave. New York NY 10001",
          "terms": "net_15",
          "bill_number": "INV-2025-0001",
          "bill_date": "2025-07-24",
          "due_date": "2025-08-08",
          "paid_date": "2025-07-30",
          "source_id": null,
          "source": null,
          "payment_status": "paid",
          "message_on_bill": "Inventory restocking",
          "currency": "USD",
          "exchange_rate": 1,
          "exchange_rate_book": 1,
          "created_at": "2025-07-24T10:15:22+0000",
          "last_modified_at": "2025-07-30T14:22:33+0000",
          "entity": 54,
          "vendor": 34180,
          "journal_entry": 7491950,
          "source_file": null,
          "tax_rate": 8551
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Query Parameters

​
currency
string

Filter by currency code (e.g., USD, EUR)

​
download
boolean
default:false

If true, triggers async download workflow and sends bills via email

​
end_date
string

Filter bills with bill_date on or before this date (YYYY-MM-DD)

​
entity
integer

Filter by entity ID. Can be specified multiple times for multiple entities

​
include_deleted
boolean
default:false

When set to 'true', returns ONLY deleted records instead of active records. Deleted records contain minimal data: 'id', 'is_deleted=true', 'deleted_at' timestamp, and 'last_modified_at'. When 'false' or omitted, returns ONLY active records. This provides clean separation between active and deleted data.

​
last_modified_at__gte
string

Filter for records modified on or after this timestamp. Format: ISO 8601 (e.g., '2024-01-01T00:00:00Z' or '2024-01-01'). Works with both active records and deleted records (filters by deletion time for deleted records).

​
last_modified_at__lte
string

Filter for records modified on or before this timestamp. Format: ISO 8601 (e.g., '2024-12-31T23:59:59Z' or '2024-12-31'). Works with both active records and deleted records (filters by deletion time for deleted records).

​
limit
integer
default:50

Number of results to return per page (default: 50, max: 1000)

​
offset
integer
default:0

The initial index from which to return the results

​
q
string

Search query - searches by mailing address, bill number, message on bill, or vendor name

​
sort
string
default:-bill_date

Sort order. Use field name for ascending, -field for descending. Special fields: vendor_name, total_amount, amount_paid, amount_due, payment. Default: -bill_date

​
start_date
string

Filter bills with bill_date on or after this date (YYYY-MM-DD)

​
status
enum<string>

Filter by payment status

Available options:
1_30,
31_60,
61_90,
91_120,
current,
open,
over_120,
paid,
partially_paid,
past_due,
payment_not_found,
payment_pending,
unpaid,
voided
​
vendor
integer

Filter by vendor ID. Can be specified multiple times for multiple vendors

Response

200 - application/json
​
count
integer
required
Example:

123

​
results
object[]
required
​
next
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=400&limit=100"

​
previous
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=200&limit=100"