Skip to main content
PUT
/
coa
/
api
/
v1
/
bill
/
{id}
/
curl --request PUT \
  --url https://api.meetcampfire.com/coa/api/v1/bill/{id}/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "terms": "net_45",
  "bill_date": "2025-08-01",
  "due_date": "2025-09-15",
  "lines": [
    {
      "tags": [
        {
          "id": "8355",
          "name": "Project A",
          "group": 727
        }
      ],
      "account": "2622",
      "account_name": "6700 - Office Expenses",
      "amount": 12000,
      "description": "Updated Large Expense Line",
      "bill_customer": "34182",
      "bill_customer_name": "ABC Bead Supply",
      "department": "35",
      "department_name": "Engineering"
    },
    {
      "tags": [],
      "account": "2600",
      "account_name": "5000 - Cost of Goods Sold",
      "amount": 3000,
      "description": "Additional inventory purchase",
      "bill_customer": "34182",
      "bill_customer_name": "ABC Bead Supply",
      "department": "36",
      "department_name": "Sales"
    }
  ],
  "entity": "54",
  "entity_name": "Top Level",
  "entity_currency": "USD",
  "currency": "USD",
  "exchange_rate_book": 1,
  "exchange_rate": 1,
  "vendor": "34182",
  "vendor_name": "ABC Bead Supply",
  "bill_number": "1234567",
  "item_date": "2025-08-01",
  "message_on_bill": "Updated large expense with additional items",
  "mailing_address": "1234 Campground Road. San Francisco CA 98765"
}'
{
  "id": 31894,
  "lines": [
    {
      "id": 298627,
      "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": "Updated Large Expense Line",
      "amount": 12000,
      "tax": 0,
      "tax_description": null,
      "source": null,
      "source_id": null,
      "currency": "USD",
      "created_at": "2025-07-25T14:30:15+0000",
      "last_modified_at": "2025-07-25T14:30:15+0000",
      "account": 2622,
      "bill_customer": 34182,
      "department": 35
    },
    {
      "id": 298628,
      "account_number": "5000",
      "account_name": "5000 - Cost of Goods Sold",
      "department_name": "Sales",
      "bill_customer_name": "ABC Bead Supply",
      "tags": [],
      "amortization_schedule": [],
      "description": "Additional inventory purchase",
      "amount": 3000,
      "tax": 0,
      "tax_description": null,
      "source": null,
      "source_id": null,
      "currency": "USD",
      "created_at": "2025-07-25T14:30:15+0000",
      "last_modified_at": "2025-07-25T14:30:15+0000",
      "account": 2600,
      "bill_customer": 34182,
      "department": 36
    }
  ],
  "payments": [
    {
      "id": 5234,
      "amount": 5400,
      "payment_date": "2025-08-15",
      "currency": "USD",
      "payment_transaction_bank_description": "ACH Transfer",
      "payment_journal_entry_order": "JE-2025-001345",
      "voided_journal_entry_order": null,
      "created_at": "2025-08-15T14:22:33+0000",
      "payment_journal_entry": 7491960,
      "payment_transaction": 12345678,
      "voided_journal_entry": null,
      "source": "BANK_IMPORT"
    }
  ],
  "payment_journal_entries": [
    7491960
  ],
  "status": "partially_paid",
  "past_due_days": null,
  "entity_name": "Top Level",
  "entity_currency": "USD",
  "vendor_name": "ABC Bead Supply",
  "attachments": [],
  "total_amount": 15000,
  "amount_due": 9600,
  "amount_paid": 5400,
  "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_45",
  "bill_number": "1234567",
  "bill_date": "2025-08-01",
  "due_date": "2025-09-15",
  "paid_date": null,
  "message_on_bill": "Updated large expense with additional items",
  "source_id": null,
  "source": null,
  "payment_status": "partial",
  "currency": "USD",
  "exchange_rate": 1,
  "exchange_rate_book": 1,
  "created_at": "2025-07-25T04:24:32+0000",
  "last_modified_at": "2025-07-25T14:30:15+0000",
  "entity": 54,
  "vendor": 34182,
  "journal_entry": 7491951,
  "source_file": null,
  "tax_rate": null,
  "voided_journal_entry": null
}

Authorizations

​
Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

​
id
integer
required

Body

​
lines
object[]
required
​
bill_number
string
required
Maximum length: 120
​
bill_date
string<date>
required
​
due_date
string<date>
required
​
entity
integer
required
​
vendor
integer | null
required
​
item_date
string<date> | null
​
migrated_journal_id
integer | null
​
mailing_address
string | null
​
terms
  • custom - Custom
  • net_5 - Net 5
  • net_7 - Net 7
  • net_10 - Net 10
  • net_15 - Net 15
  • net_20 - Net 20
  • net_30 - Net 30
  • net_40 - Net 40
  • net_45 - Net 45
  • net_60 - Net 60
  • net_90 - Net 90
  • net_105 - Net 105
  • net_120 - Net 120
  • due_on_receipt - Due on Receipt
Available options:
custom,
net_5,
net_7,
net_10,
net_15,
net_20,
net_30,
net_40,
net_45,
net_60,
net_90,
net_105,
net_120,
due_on_receipt
​
paid_date
string<date> | null
​
message_on_bill
string | null
​
source_id
string | null
​
source
string | null
Maximum length: 250
​
payment_status
  • partial - Partially Paid
  • open - Open
  • paid - Paid
  • payment_not_found - Payment Not Found
  • payment_pending - Payment Pending
  • voided - Voided
Available options:
partial,
open,
paid,
payment_not_found,
payment_pending,
voided
​
currency
string
Maximum length: 3
​
exchange_rate
number | null
Required range: -100000000000000 < x < 100000000000000
​
exchange_rate_book
number | null
Required range: -100000000000000 < x < 100000000000000
​
tax_behavior
  • inclusive - Inclusive
  • exclusive - Exclusive
Available options:
inclusive,
exclusive
​
journal_entry
integer | null
​
source_file
integer | null
​
tax_rate
integer | null
​
voided_journal_entry
integer | null

Response

200 - application/json
​
id
integer
required
​
lines
object[]
required
​
payments
object[]
required
​
payment_journal_entries
integer[]
required
​
status
string
required
​
past_due_days
integer | null
required
​
entity_name
string
required
​
entity_currency
string
required
​
vendor_name
string
required
​
attachments
object[]
required
​
total_amount
string
required
​
amount_due
string
required
​
amount_paid
string
required
​
voided_date
string<date>
required
​
voided_journal_entry_order
string
required
​
amortizations
string
required
​
last_modified_at
string<date-time>
required
​
ramp_use_sandbox
string
required
​
is_deleted
boolean
default:false
required
​
deleted_at
string<date-time> | null
required
​
search_vector
string | null
required
​
search_text
string | null
required
​
bill_number
string
required
Maximum length: 120
​
bill_date
string<date>
required
​
due_date
string<date>
required
​
created_at
string<date-time>
required
​
customer
integer
required
​
entity
integer
required
​
vendor
integer | null
required
​
item_date
string<date> | null
​
mailing_address
string | null
​
terms
  • custom - Custom
  • net_5 - Net 5
  • net_7 - Net 7
  • net_10 - Net 10
  • net_15 - Net 15
  • net_20 - Net 20
  • net_30 - Net 30
  • net_40 - Net 40
  • net_45 - Net 45
  • net_60 - Net 60
  • net_90 - Net 90
  • net_105 - Net 105
  • net_120 - Net 120
  • due_on_receipt - Due on Receipt
Available options:
custom,
net_5,
net_7,
net_10,
net_15,
net_20,
net_30,
net_40,
net_45,
net_60,
net_90,
net_105,
net_120,
due_on_receipt
​
paid_date
string<date> | null
​
message_on_bill
string | null
​
source_id
string | null
​
source
string | null
Maximum length: 250
​
payment_status
  • partial - Partially Paid
  • open - Open
  • paid - Paid
  • payment_not_found - Payment Not Found
  • payment_pending - Payment Pending
  • voided - Voided
Available options:
partial,
open,
paid,
payment_not_found,
payment_pending,
voided
​
currency
string
Maximum length: 3
​
exchange_rate
number | null
Required range: -100000000000000 < x < 100000000000000
​
exchange_rate_book
number | null
Required range: -100000000000000 < x < 100000000000000
​
tax_behavior
  • inclusive - Inclusive
  • exclusive - Exclusive
Available options:
inclusive,
exclusive
​
journal_entry
integer | null
​
source_file
integer | null
​
tax_rate
integer | null
​
voided_journal_entry
integer | null
⌘I