Create Accounting Bill
curl --request POST \
--url https://api.meetcampfire.com/coa/api/v1/bill/ \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"account": 123,
"id": 123,
"bill": 123,
"description": "<string>",
"amount": 0,
"tax": 0,
"tax_description": "<string>",
"source": "<string>",
"source_id": "<string>",
"currency": "<string>",
"tax_rate": 123,
"bill_customer": 123,
"department": 123
}
],
"bill_number": "<string>",
"bill_date": "2023-12-25",
"due_date": "2023-12-25",
"entity": 123,
"vendor": 123,
"item_date": "2023-12-25",
"migrated_journal_id": 123,
"chat_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "<string>",
"paid_date": "2023-12-25",
"message_on_bill": "<string>",
"ita_allocation_number": "<string>",
"source_id": "<string>",
"source": "<string>",
"source_bill_data": null,
"external_ramp_id": "<string>",
"currency": "<string>",
"exchange_rate": 0,
"exchange_rate_book": 0,
"chat_id": -1,
"payment_term": 123,
"journal_entry": 123,
"source_file": 123,
"tax_rate": 123,
"ap_account": 123,
"voided_journal_entry": 123
}
'import requests
url = "https://api.meetcampfire.com/coa/api/v1/bill/"
payload = {
"lines": [
{
"account": 123,
"id": 123,
"bill": 123,
"description": "<string>",
"amount": 0,
"tax": 0,
"tax_description": "<string>",
"source": "<string>",
"source_id": "<string>",
"currency": "<string>",
"tax_rate": 123,
"bill_customer": 123,
"department": 123
}
],
"bill_number": "<string>",
"bill_date": "2023-12-25",
"due_date": "2023-12-25",
"entity": 123,
"vendor": 123,
"item_date": "2023-12-25",
"migrated_journal_id": 123,
"chat_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "<string>",
"paid_date": "2023-12-25",
"message_on_bill": "<string>",
"ita_allocation_number": "<string>",
"source_id": "<string>",
"source": "<string>",
"source_bill_data": None,
"external_ramp_id": "<string>",
"currency": "<string>",
"exchange_rate": 0,
"exchange_rate_book": 0,
"chat_id": -1,
"payment_term": 123,
"journal_entry": 123,
"source_file": 123,
"tax_rate": 123,
"ap_account": 123,
"voided_journal_entry": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
lines: [
{
account: 123,
id: 123,
bill: 123,
description: '<string>',
amount: 0,
tax: 0,
tax_description: '<string>',
source: '<string>',
source_id: '<string>',
currency: '<string>',
tax_rate: 123,
bill_customer: 123,
department: 123
}
],
bill_number: '<string>',
bill_date: '2023-12-25',
due_date: '2023-12-25',
entity: 123,
vendor: 123,
item_date: '2023-12-25',
migrated_journal_id: 123,
chat_uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
mailing_address: '<string>',
paid_date: '2023-12-25',
message_on_bill: '<string>',
ita_allocation_number: '<string>',
source_id: '<string>',
source: '<string>',
source_bill_data: null,
external_ramp_id: '<string>',
currency: '<string>',
exchange_rate: 0,
exchange_rate_book: 0,
chat_id: -1,
payment_term: 123,
journal_entry: 123,
source_file: 123,
tax_rate: 123,
ap_account: 123,
voided_journal_entry: 123
})
};
fetch('https://api.meetcampfire.com/coa/api/v1/bill/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meetcampfire.com/coa/api/v1/bill/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lines' => [
[
'account' => 123,
'id' => 123,
'bill' => 123,
'description' => '<string>',
'amount' => 0,
'tax' => 0,
'tax_description' => '<string>',
'source' => '<string>',
'source_id' => '<string>',
'currency' => '<string>',
'tax_rate' => 123,
'bill_customer' => 123,
'department' => 123
]
],
'bill_number' => '<string>',
'bill_date' => '2023-12-25',
'due_date' => '2023-12-25',
'entity' => 123,
'vendor' => 123,
'item_date' => '2023-12-25',
'migrated_journal_id' => 123,
'chat_uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'mailing_address' => '<string>',
'paid_date' => '2023-12-25',
'message_on_bill' => '<string>',
'ita_allocation_number' => '<string>',
'source_id' => '<string>',
'source' => '<string>',
'source_bill_data' => null,
'external_ramp_id' => '<string>',
'currency' => '<string>',
'exchange_rate' => 0,
'exchange_rate_book' => 0,
'chat_id' => -1,
'payment_term' => 123,
'journal_entry' => 123,
'source_file' => 123,
'tax_rate' => 123,
'ap_account' => 123,
'voided_journal_entry' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meetcampfire.com/coa/api/v1/bill/"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meetcampfire.com/coa/api/v1/bill/")
.header("Content-Type", "application/json")
.body("{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meetcampfire.com/coa/api/v1/bill/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}"
response = http.request(request)
puts response.read_body{
"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,
"search_vector": null,
"search_text": null,
"mailing_address": "1234 Campground Road. San Francisco CA 98765",
"terms": null,
"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,
"payment_term": 1234,
"payment_term_name": "Net 30",
"journal_entry": 7491951,
"source_file": null,
"tax_rate": null,
"voided_journal_entry": null
}Accounts Payable
Create Accounting Bill
Creates a new accounting bill with line items and automatic journal entry generation.
This endpoint allows for complex bill creation with:
- Multiple line items with different accounts, departments, and vendor assignments
- Automatic accounts payable journal entry creation
- Tax calculations and tax account handling
- Exchange rate support for multi-currency transactions
- Custom field support for additional bill metadata
Requirements:
- All referenced accounts must exist and be active
- Vendor must exist
- Entity must exist
- Line items must have valid amounts and descriptions
- Currency must be valid for the entity
- Accounting date must be before closed book date
POST
/
coa
/
api
/
v1
/
bill
/
Create Accounting Bill
curl --request POST \
--url https://api.meetcampfire.com/coa/api/v1/bill/ \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"account": 123,
"id": 123,
"bill": 123,
"description": "<string>",
"amount": 0,
"tax": 0,
"tax_description": "<string>",
"source": "<string>",
"source_id": "<string>",
"currency": "<string>",
"tax_rate": 123,
"bill_customer": 123,
"department": 123
}
],
"bill_number": "<string>",
"bill_date": "2023-12-25",
"due_date": "2023-12-25",
"entity": 123,
"vendor": 123,
"item_date": "2023-12-25",
"migrated_journal_id": 123,
"chat_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "<string>",
"paid_date": "2023-12-25",
"message_on_bill": "<string>",
"ita_allocation_number": "<string>",
"source_id": "<string>",
"source": "<string>",
"source_bill_data": null,
"external_ramp_id": "<string>",
"currency": "<string>",
"exchange_rate": 0,
"exchange_rate_book": 0,
"chat_id": -1,
"payment_term": 123,
"journal_entry": 123,
"source_file": 123,
"tax_rate": 123,
"ap_account": 123,
"voided_journal_entry": 123
}
'import requests
url = "https://api.meetcampfire.com/coa/api/v1/bill/"
payload = {
"lines": [
{
"account": 123,
"id": 123,
"bill": 123,
"description": "<string>",
"amount": 0,
"tax": 0,
"tax_description": "<string>",
"source": "<string>",
"source_id": "<string>",
"currency": "<string>",
"tax_rate": 123,
"bill_customer": 123,
"department": 123
}
],
"bill_number": "<string>",
"bill_date": "2023-12-25",
"due_date": "2023-12-25",
"entity": 123,
"vendor": 123,
"item_date": "2023-12-25",
"migrated_journal_id": 123,
"chat_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mailing_address": "<string>",
"paid_date": "2023-12-25",
"message_on_bill": "<string>",
"ita_allocation_number": "<string>",
"source_id": "<string>",
"source": "<string>",
"source_bill_data": None,
"external_ramp_id": "<string>",
"currency": "<string>",
"exchange_rate": 0,
"exchange_rate_book": 0,
"chat_id": -1,
"payment_term": 123,
"journal_entry": 123,
"source_file": 123,
"tax_rate": 123,
"ap_account": 123,
"voided_journal_entry": 123
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
lines: [
{
account: 123,
id: 123,
bill: 123,
description: '<string>',
amount: 0,
tax: 0,
tax_description: '<string>',
source: '<string>',
source_id: '<string>',
currency: '<string>',
tax_rate: 123,
bill_customer: 123,
department: 123
}
],
bill_number: '<string>',
bill_date: '2023-12-25',
due_date: '2023-12-25',
entity: 123,
vendor: 123,
item_date: '2023-12-25',
migrated_journal_id: 123,
chat_uuid: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
mailing_address: '<string>',
paid_date: '2023-12-25',
message_on_bill: '<string>',
ita_allocation_number: '<string>',
source_id: '<string>',
source: '<string>',
source_bill_data: null,
external_ramp_id: '<string>',
currency: '<string>',
exchange_rate: 0,
exchange_rate_book: 0,
chat_id: -1,
payment_term: 123,
journal_entry: 123,
source_file: 123,
tax_rate: 123,
ap_account: 123,
voided_journal_entry: 123
})
};
fetch('https://api.meetcampfire.com/coa/api/v1/bill/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.meetcampfire.com/coa/api/v1/bill/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'lines' => [
[
'account' => 123,
'id' => 123,
'bill' => 123,
'description' => '<string>',
'amount' => 0,
'tax' => 0,
'tax_description' => '<string>',
'source' => '<string>',
'source_id' => '<string>',
'currency' => '<string>',
'tax_rate' => 123,
'bill_customer' => 123,
'department' => 123
]
],
'bill_number' => '<string>',
'bill_date' => '2023-12-25',
'due_date' => '2023-12-25',
'entity' => 123,
'vendor' => 123,
'item_date' => '2023-12-25',
'migrated_journal_id' => 123,
'chat_uuid' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'mailing_address' => '<string>',
'paid_date' => '2023-12-25',
'message_on_bill' => '<string>',
'ita_allocation_number' => '<string>',
'source_id' => '<string>',
'source' => '<string>',
'source_bill_data' => null,
'external_ramp_id' => '<string>',
'currency' => '<string>',
'exchange_rate' => 0,
'exchange_rate_book' => 0,
'chat_id' => -1,
'payment_term' => 123,
'journal_entry' => 123,
'source_file' => 123,
'tax_rate' => 123,
'ap_account' => 123,
'voided_journal_entry' => 123
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.meetcampfire.com/coa/api/v1/bill/"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.meetcampfire.com/coa/api/v1/bill/")
.header("Content-Type", "application/json")
.body("{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.meetcampfire.com/coa/api/v1/bill/")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"lines\": [\n {\n \"account\": 123,\n \"id\": 123,\n \"bill\": 123,\n \"description\": \"<string>\",\n \"amount\": 0,\n \"tax\": 0,\n \"tax_description\": \"<string>\",\n \"source\": \"<string>\",\n \"source_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"tax_rate\": 123,\n \"bill_customer\": 123,\n \"department\": 123\n }\n ],\n \"bill_number\": \"<string>\",\n \"bill_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"entity\": 123,\n \"vendor\": 123,\n \"item_date\": \"2023-12-25\",\n \"migrated_journal_id\": 123,\n \"chat_uuid\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"mailing_address\": \"<string>\",\n \"paid_date\": \"2023-12-25\",\n \"message_on_bill\": \"<string>\",\n \"ita_allocation_number\": \"<string>\",\n \"source_id\": \"<string>\",\n \"source\": \"<string>\",\n \"source_bill_data\": null,\n \"external_ramp_id\": \"<string>\",\n \"currency\": \"<string>\",\n \"exchange_rate\": 0,\n \"exchange_rate_book\": 0,\n \"chat_id\": -1,\n \"payment_term\": 123,\n \"journal_entry\": 123,\n \"source_file\": 123,\n \"tax_rate\": 123,\n \"ap_account\": 123,\n \"voided_journal_entry\": 123\n}"
response = http.request(request)
puts response.read_body{
"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,
"search_vector": null,
"search_text": null,
"mailing_address": "1234 Campground Road. San Francisco CA 98765",
"terms": null,
"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,
"payment_term": 1234,
"payment_term_name": "Net 30",
"journal_entry": 7491951,
"source_file": null,
"tax_rate": null,
"voided_journal_entry": null
}Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data
Show child attributes
Show child attributes
Maximum string length:
120custom- Customnet_5- Net 5net_7- Net 7net_10- Net 10net_15- Net 15net_20- Net 20net_30- Net 30net_40- Net 40net_45- Net 45net_60- Net 60net_90- Net 90net_105- Net 105net_120- Net 120due_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 Maximum string length:
9Pattern:
^\d{9}$Israel tax compliance: bill classification type
other- Otherequipment- Equipment
Available options:
other, equipment Maximum string length:
250partial- Partially Paidopen- Openpaid- Paidpayment_not_found- Payment Not Foundpayment_pending- Payment Pendingvoided- Voided
Available options:
partial, open, paid, payment_not_found, payment_pending, voided Maximum string length:
3Required range:
-100000000000000 < x < 100000000000000Required range:
-100000000000000 < x < 100000000000000inclusive- Inclusiveexclusive- Exclusive
Available options:
inclusive, exclusive BILL- BillPAYROLL- PayrollREIMBURSEMENT- Reimbursement
Available options:
BILL, PAYROLL, REIMBURSEMENT Required range:
-2147483648 <= x <= 2147483647Payment term for this bill
Accounts Payable account for this bill
Response
201 - application/json
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Return AP account name with number in 'number - name' format, similar to name_and_number.
Show child attributes
Show child attributes
Required range:
-1000000000000000000 < x < 1000000000000000000Required range:
-1000000000000000000 < x < 1000000000000000000Navan data region (US/EU) for a Navan-sourced bill, else None.
Mirrors ramp_use_sandbox: the frontend builds the "Open in Navan" deep
link from source_id and uses this to pick the web-app host
(US -> app.navan.com, EU -> app-fra.navan.com). Navan bills carry no FK to
their connection, so the region is resolved per customer and memoized to
avoid an N+1 lookup across a bill list.
Withholding context for the bill's entity (AP side).
estimated_withholding_amount covers only the remaining amount due (null once
fully paid); withheld_to_date is the signed sum of posted withholding (AP legs
are credits, reversals debits), so actuals replace the estimate as payments post.
Certificate-based schemes estimate from the vendor certificate's rate valid today
(falling back to the scheme default).
Show child attributes
Show child attributes
Maximum string length:
120custom- Customnet_5- Net 5net_7- Net 7net_10- Net 10net_15- Net 15net_20- Net 20net_30- Net 30net_40- Net 40net_45- Net 45net_60- Net 60net_90- Net 90net_105- Net 105net_120- Net 120due_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 Maximum string length:
9Pattern:
^\d{9}$Israel tax compliance: bill classification type
other- Otherequipment- Equipment
Available options:
other, equipment Maximum string length:
250partial- Partially Paidopen- Openpaid- Paidpayment_not_found- Payment Not Foundpayment_pending- Payment Pendingvoided- Voided
Available options:
partial, open, paid, payment_not_found, payment_pending, voided Maximum string length:
3Required range:
-100000000000000 < x < 100000000000000Required range:
-100000000000000 < x < 100000000000000inclusive- Inclusiveexclusive- Exclusive
Available options:
inclusive, exclusive BILL- BillPAYROLL- PayrollREIMBURSEMENT- Reimbursement
Available options:
BILL, PAYROLL, REIMBURSEMENT Required range:
-2147483648 <= x <= 2147483647Payment term for this bill
Accounts Payable account for this bill