Bills
Create Bills
Scopes: bill:create
POST
/
v0
/
business
/
{business_id}
/
bills
Create Bills
curl --request POST \
--url https://api.sandbox.getasset.com/v0/business/{business_id}/bills \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"number": "BILL-001",
"description": "Office supplies",
"due_at": "2025-02-15T00:00:00Z",
"issued_at": "2025-01-15T00:00:00Z",
"vendor_id": "ven_WQMDNUHpBThYSNh4AprDBo",
"lines": [
{
"description": "Cleaning services",
"amount": 120.52,
"ledger_id": "<string>",
"metadata_": {}
}
],
"currency": "USD",
"tags": {
"Location": "NYC"
}
}
]
'import requests
url = "https://api.sandbox.getasset.com/v0/business/{business_id}/bills"
payload = [
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"number": "BILL-001",
"description": "Office supplies",
"due_at": "2025-02-15T00:00:00Z",
"issued_at": "2025-01-15T00:00:00Z",
"vendor_id": "ven_WQMDNUHpBThYSNh4AprDBo",
"lines": [
{
"description": "Cleaning services",
"amount": 120.52,
"ledger_id": "<string>",
"metadata_": {}
}
],
"currency": "USD",
"tags": { "Location": "NYC" }
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
business_id: 'biz_Pk2fNFDd8wj7EFeLWJywc7',
number: 'BILL-001',
description: 'Office supplies',
due_at: '2025-02-15T00:00:00Z',
issued_at: '2025-01-15T00:00:00Z',
vendor_id: 'ven_WQMDNUHpBThYSNh4AprDBo',
lines: [
{
description: 'Cleaning services',
amount: 120.52,
ledger_id: '<string>',
metadata_: {}
}
],
currency: 'USD',
tags: {Location: 'NYC'}
}
])
};
fetch('https://api.sandbox.getasset.com/v0/business/{business_id}/bills', 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.sandbox.getasset.com/v0/business/{business_id}/bills",
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([
[
'business_id' => 'biz_Pk2fNFDd8wj7EFeLWJywc7',
'number' => 'BILL-001',
'description' => 'Office supplies',
'due_at' => '2025-02-15T00:00:00Z',
'issued_at' => '2025-01-15T00:00:00Z',
'vendor_id' => 'ven_WQMDNUHpBThYSNh4AprDBo',
'lines' => [
[
'description' => 'Cleaning services',
'amount' => 120.52,
'ledger_id' => '<string>',
'metadata_' => [
]
]
],
'currency' => 'USD',
'tags' => [
'Location' => 'NYC'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.sandbox.getasset.com/v0/business/{business_id}/bills"
payload := strings.NewReader("[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.getasset.com/v0/business/{business_id}/bills")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.getasset.com/v0/business/{business_id}/bills")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"data": [
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"vendor_id": "ven_ErisumsAc7qgmbTctM7zKK",
"number": "BILL-001",
"description": "Cleaning services",
"total_amount": 123,
"total_paid": 123,
"due_at": "2023-11-07T05:31:56Z",
"issued_at": "2023-11-07T05:31:56Z",
"status": "open",
"id": "bil_WQMDNUHpBThYSNh4AprDBo",
"currency": "CAD",
"voided_at": "2023-11-07T05:31:56Z",
"metadata_": {},
"lines": [
{
"description": "Cleaning services",
"ledger_id": "ldg_ErisumsAc7qgmbTctM7zKK",
"amount": 120.52,
"id": "bln_GkBo16N66u2teKfFuFMMwf",
"bill_id": "bil_WxcM3ypJ5boFxsNQzcqRXe",
"metadata_": {}
}
],
"payments": [
{
"bill_id": "bil_WQMDNUHpBThYSNh4AprDBo",
"payment_id": "blp_WQMDNUHpBThYSNh4AprDBo",
"datetime": "2021-01-01T00:00:00Z",
"payment_amount": "89.23",
"id": "blp_WQMDNUHpBThYSNh4AprDBo",
"transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
"credit_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"vendor_credit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bill": "<unknown>"
}
],
"tags": {
"Job": [
{
"amount": "3000.00",
"value": "Maple Street Remodel"
},
{
"amount": "1500.00",
"value": "Downtown Office Rewire"
}
]
}
}
],
"errors": [
{
"error": "<string>",
"bill_number": "<string>"
}
]
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Headers
Optional external entity identifier that performed the action
Path Parameters
The id of the business
Example:
"biz_GA6EG2qFxA97NZHtxeLPUy"
Body
application/json
Maximum array length:
100The ID of the Business that the bill is associated with
Example:
"biz_Pk2fNFDd8wj7EFeLWJywc7"
The number of the bill
Example:
"BILL-001"
The description of the bill
Example:
"Office supplies"
The due date of the bill in ISO-8601 format
Example:
"2025-02-15T00:00:00Z"
The date the bill was issued in ISO-8601 format
Example:
"2025-01-15T00:00:00Z"
The ID of the Vendor that the bill is associated with
Example:
"ven_WQMDNUHpBThYSNh4AprDBo"
The lines of the bill
Show child attributes
Show child attributes
ISO 4217 currency code for this bill.
Maximum string length:
3Example:
"USD"
Inline tag input. Each field maps to either a single value (string, e.g. 'NYC') or a list of {value, amount} objects to allocate the bill across multiple values. The tag field must already exist; values are created automatically if missing. Per-field sum of amounts must not exceed the bill total.
Show child attributes
Show child attributes
Example:
{ "Location": "NYC" }
⌘I
Create Bills
curl --request POST \
--url https://api.sandbox.getasset.com/v0/business/{business_id}/bills \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"number": "BILL-001",
"description": "Office supplies",
"due_at": "2025-02-15T00:00:00Z",
"issued_at": "2025-01-15T00:00:00Z",
"vendor_id": "ven_WQMDNUHpBThYSNh4AprDBo",
"lines": [
{
"description": "Cleaning services",
"amount": 120.52,
"ledger_id": "<string>",
"metadata_": {}
}
],
"currency": "USD",
"tags": {
"Location": "NYC"
}
}
]
'import requests
url = "https://api.sandbox.getasset.com/v0/business/{business_id}/bills"
payload = [
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"number": "BILL-001",
"description": "Office supplies",
"due_at": "2025-02-15T00:00:00Z",
"issued_at": "2025-01-15T00:00:00Z",
"vendor_id": "ven_WQMDNUHpBThYSNh4AprDBo",
"lines": [
{
"description": "Cleaning services",
"amount": 120.52,
"ledger_id": "<string>",
"metadata_": {}
}
],
"currency": "USD",
"tags": { "Location": "NYC" }
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
business_id: 'biz_Pk2fNFDd8wj7EFeLWJywc7',
number: 'BILL-001',
description: 'Office supplies',
due_at: '2025-02-15T00:00:00Z',
issued_at: '2025-01-15T00:00:00Z',
vendor_id: 'ven_WQMDNUHpBThYSNh4AprDBo',
lines: [
{
description: 'Cleaning services',
amount: 120.52,
ledger_id: '<string>',
metadata_: {}
}
],
currency: 'USD',
tags: {Location: 'NYC'}
}
])
};
fetch('https://api.sandbox.getasset.com/v0/business/{business_id}/bills', 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.sandbox.getasset.com/v0/business/{business_id}/bills",
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([
[
'business_id' => 'biz_Pk2fNFDd8wj7EFeLWJywc7',
'number' => 'BILL-001',
'description' => 'Office supplies',
'due_at' => '2025-02-15T00:00:00Z',
'issued_at' => '2025-01-15T00:00:00Z',
'vendor_id' => 'ven_WQMDNUHpBThYSNh4AprDBo',
'lines' => [
[
'description' => 'Cleaning services',
'amount' => 120.52,
'ledger_id' => '<string>',
'metadata_' => [
]
]
],
'currency' => 'USD',
'tags' => [
'Location' => 'NYC'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"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.sandbox.getasset.com/v0/business/{business_id}/bills"
payload := strings.NewReader("[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
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.sandbox.getasset.com/v0/business/{business_id}/bills")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sandbox.getasset.com/v0/business/{business_id}/bills")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"business_id\": \"biz_Pk2fNFDd8wj7EFeLWJywc7\",\n \"number\": \"BILL-001\",\n \"description\": \"Office supplies\",\n \"due_at\": \"2025-02-15T00:00:00Z\",\n \"issued_at\": \"2025-01-15T00:00:00Z\",\n \"vendor_id\": \"ven_WQMDNUHpBThYSNh4AprDBo\",\n \"lines\": [\n {\n \"description\": \"Cleaning services\",\n \"amount\": 120.52,\n \"ledger_id\": \"<string>\",\n \"metadata_\": {}\n }\n ],\n \"currency\": \"USD\",\n \"tags\": {\n \"Location\": \"NYC\"\n }\n }\n]"
response = http.request(request)
puts response.read_body{
"data": [
{
"business_id": "biz_Pk2fNFDd8wj7EFeLWJywc7",
"vendor_id": "ven_ErisumsAc7qgmbTctM7zKK",
"number": "BILL-001",
"description": "Cleaning services",
"total_amount": 123,
"total_paid": 123,
"due_at": "2023-11-07T05:31:56Z",
"issued_at": "2023-11-07T05:31:56Z",
"status": "open",
"id": "bil_WQMDNUHpBThYSNh4AprDBo",
"currency": "CAD",
"voided_at": "2023-11-07T05:31:56Z",
"metadata_": {},
"lines": [
{
"description": "Cleaning services",
"ledger_id": "ldg_ErisumsAc7qgmbTctM7zKK",
"amount": 120.52,
"id": "bln_GkBo16N66u2teKfFuFMMwf",
"bill_id": "bil_WxcM3ypJ5boFxsNQzcqRXe",
"metadata_": {}
}
],
"payments": [
{
"bill_id": "bil_WQMDNUHpBThYSNh4AprDBo",
"payment_id": "blp_WQMDNUHpBThYSNh4AprDBo",
"datetime": "2021-01-01T00:00:00Z",
"payment_amount": "89.23",
"id": "blp_WQMDNUHpBThYSNh4AprDBo",
"transaction_id": "txn_WQMDNUHpBThYSNh4AprDBo",
"credit_journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"vendor_credit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"bill": "<unknown>"
}
],
"tags": {
"Job": [
{
"amount": "3000.00",
"value": "Maple Street Remodel"
},
{
"amount": "1500.00",
"value": "Downtown Office Rewire"
}
]
}
}
],
"errors": [
{
"error": "<string>",
"bill_number": "<string>"
}
]
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}{
"error": "<string>",
"data": "<unknown>"
}