Bill

A bill is an invoice received for products and services purchased from vendors. Bill object allows you to perform the following operations:

Retrieve a specific bill or a list of bills
Create a bill
Update a bill
Delete a bill

cURL
NODE.JS
PHP
C#
PYTHON
JAVA

Name	Description	Format	Attributes
date	Date when a bill is created in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time	Filterable, Sortable
number	This represents a bill number	string	Filterable, Sortable MaxLength = 50
vendorId	Identifier of a vendor	uuid	Filterable
accountingDate	Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
accountsPayableId	Identifier of the Accounts Payable account associated with the bill	uuid
accountSplits	Represents the account splits	AccountSplits Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
amount	Total amount of a bill	double
balance	The outstanding amount on a bill	double	Filterable, Sortable
createdById	Identifier of the user who created this object	uuid	Filterable
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time	Filterable, Sortable
customFields []Array: Parent object can have multiple instances of this nested object under it.	List of custom fields	CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
dueDate	The due date of a bill based on the payment terms set in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
expenseItems []Array: Parent object can have multiple instances of this nested object under it.	List of expense line items on a bill	BillExpenseItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
id	Object identifier	uuid	Filterable
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time	Filterable, Sortable
lastUpdatedById	Identifier of the user who last updated this object	uuid	Filterable
lineItems []Array: Parent object can have multiple instances of this nested object under it.	List of line items on a bill	BillLineItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
memo	Records any extra information or details about a bill	string
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectState Enumerated type: Click to see possible values and their descriptions.
paymentStatus	Payment status of a bill, whether paid, partially paid, or unpaid	BillPaymentStatus Enumerated type: Click to see possible values and their descriptions.	Filterable, Sortable
referenceNumber	Reference number used to track a bill	string	MaxLength = 200
reimbursable	Indicates whether the bill is an employee reimbursable expense	boolean	Filterable, Sortable
term	Payment term associated with a bill, e.g., Due Upon Receipt, Net 30, etc.	string
termId	Identifier of the payment term associated with a bill	uuid
token	Represents the token for update operations	int32
vendor	Name of a vendor	string
version	Implements concurrency on this object	byte
workflow []Array: Parent object can have multiple instances of this nested object under it.	Determines a list of workflow	WorkflowState Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.

Bill List

Use this method to retrieve a list of bills. You can optionally pass where, orderBy, and page as query parameters to filter the result. Use the fields parameter to request a subset of the model. By default, a complete model is returned. The expand parameter is used to request nested properties in the model.

Request URL

base_url/bill

/bill

Method Overview

HTTP Method:

GET

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

read:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
fields	Query	Specifies the model properties you want in the response body	string
where	Query	Specifies only those records that match an expression in the query.	string
orderBy	Query	Specifies the order of the records.	string
page	Query	Specifies the page number and number of records on each page.	string
expand	Query	Specifies the nested model properties you want in the response body	string

Response Body

Name	Description	Format
date	Date when a bill is created in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
number	This represents a bill number	string
vendorId	Identifier of a vendor	uuid
accountingDate	Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
accountsPayableId	Identifier of the Accounts Payable account associated with the bill	uuid
accountSplits	Represents the account splits	AccountSplits Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
amount	Total amount of a bill	double
balance	The outstanding amount on a bill	double
createdById	Identifier of the user who created this object	uuid
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
customFields []Array: Parent object can have multiple instances of this nested object under it.	List of custom fields	CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
dueDate	The due date of a bill based on the payment terms set in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
expenseItems []Array: Parent object can have multiple instances of this nested object under it.	List of expense line items on a bill	BillExpenseItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
id	Object identifier	uuid
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
lastUpdatedById	Identifier of the user who last updated this object	uuid
lineItems []Array: Parent object can have multiple instances of this nested object under it.	List of line items on a bill	BillLineItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
memo	Records any extra information or details about a bill	string
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectStateEnumerated type: Click to see possible values and their descriptions.
paymentStatus	Payment status of a bill, whether paid, partially paid, or unpaid	BillPaymentStatusEnumerated type: Click to see possible values and their descriptions.
referenceNumber	Reference number used to track a bill	string
reimbursable	Indicates whether the bill is an employee reimbursable expense	boolean
term	Payment term associated with a bill, e.g., Due Upon Receipt, Net 30, etc.	string
termId	Identifier of the payment term associated with a bill	uuid
token	Represents the token for update operations	int32
vendor	Name of a vendor	string
version	Implements concurrency on this object	byte
workflow []Array: Parent object can have multiple instances of this nested object under it.	Determines a list of workflow	WorkflowState Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.

Example Response

[
  {
    "date": "2025-09-04T05:19:36Z",
    "number": "173567",
    "vendorId": "23926c93-6502-4d36-89b0-cfd0f83e0f37",
    "accountingDate": "2025-09-04T05:19:36Z",
    "accountsPayableId": "f7a2ca25-694e-4085-a5d1-1d1805a1fc96",
    "accountSplits": {
      "accrual": [
        {
          "account": "account",
          "accountId": "cbf0609d-b65e-4abe-9082-1848b8434252",
          "amount": 1,
          "isDebit": true,
          "isParent": true,
          "transactionType": null
        }
      ],
      "cash": [
        {
          "account": "account",
          "accountId": "7f4b0ec6-923f-439d-9b6b-53d3382d15a4",
          "amount": 1,
          "isDebit": true,
          "isParent": true,
          "transactionType": null
        }
      ]
    },
    "amount": 1,
    "balance": 1,
    "createdById": "0bb5367f-0d4f-4935-af17-bd71f9aeb4d1",
    "createdOn": "2025-09-04T05:19:36Z",
    "customFields": [
      {
        "definitionId": "cd3f9670-cc85-4422-b997-d3cdaf0fcd6d",
        "createdById": "cabff027-7707-4a91-8a86-626d661e5bfe",
        "createdOn": "2025-09-04T05:19:36Z",
        "description": "CustomFieldData Description",
        "id": "ab0e6323-bcee-486a-9ff8-ce8e493bb818",
        "label": "label",
        "lastUpdated": "2025-09-04T05:19:36Z",
        "lastUpdatedById": "a1967c49-eaa9-45c0-a4e8-9c23b83be26c",
        "objectState": null,
        "token": 0,
        "type": null,
        "value": "value",
        "version": "U3dhZ2dlciByb2Nrcw=="
      }
    ],
    "dueDate": "2025-09-04T05:19:36Z",
    "expenseItems": [
      {
        "accountId": "ddee4445-5005-4263-94b9-9005494aceb5",
        "amount": 1,
        "account": "account",
        "class": "class",
        "classId": "68b3bc2d-744b-495f-b5ff-41b631f84ea5",
        "createdById": "ca201c91-6b3f-4808-9f41-573445bc56a4",
        "createdOn": "2025-09-04T05:19:36Z",
        "entity": "entity",
        "entityId": "08f6b74a-5184-430a-af52-481d1279999a",
        "entityType": null,
        "id": "f349ec5e-b40b-4ab7-865d-ecf99f1882bb",
        "lastUpdated": "2025-09-04T05:19:36Z",
        "lastUpdatedById": "de1f2116-1ccc-46fe-9c9f-3755cd63b64a",
        "memo": "memo",
        "objectState": null,
        "token": 0,
        "version": "U3dhZ2dlciByb2Nrcw=="
      }
    ],
    "id": "ae39b002-c3d9-44fb-ae4e-24e74beea80f",
    "lastUpdated": "2025-09-04T05:19:36Z",
    "lastUpdatedById": "808ce17e-aa0b-4249-9580-5c84b4f0d4e6",
    "lineItems": [
      {
        "itemId": "9dde78c2-914f-4c75-9718-13f7aae06a45",
        "itemType": null,
        "projectId": "d6d86821-c135-4b41-80be-67aa793101e9",
        "rate": 1,
        "units": 1,
        "amount": 1,
        "billable": true,
        "billRate": 1,
        "class": "class",
        "classId": "92de859b-d3bb-4fcd-acd7-f8e1602274b0",
        "createdById": "6c674fe9-7b66-4f7d-8b3f-e5b51d84981f",
        "createdOn": "2025-09-04T05:19:36Z",
        "description": "BillLineItem Description",
        "expenseAccount": "expenseAccount",
        "expenseAccountId": "12417ed0-1cf6-4708-b5f3-b5c6833fa0c5",
        "extra": true,
        "id": "560b78f5-0654-4bf0-b13e-9ade306f550d",
        "incomeAccount": "incomeAccount",
        "incomeAccountId": "28c27bf6-dd0c-467b-b10f-0cd20166e15b",
        "item": "item",
        "lastUpdated": "2025-09-04T05:19:36Z",
        "lastUpdatedById": "be392e90-5941-4124-b172-be76545402d0",
        "markup": 1,
        "memo": "memo",
        "objectState": null,
        "project": "project",
        "purchaseTaxRate": 1,
        "token": 0,
        "version": "U3dhZ2dlciByb2Nrcw=="
      }
    ],
    "memo": "memo",
    "objectState": null,
    "paymentStatus": null,
    "referenceNumber": "referenceNumber",
    "reimbursable": true,
    "term": "term",
    "termId": "cbef8ee0-cb0a-4560-9420-4d7ea8832100",
    "token": 0,
    "vendor": "vendor",
    "version": "U3dhZ2dlciByb2Nrcw==",
    "workflow": [
      {
        "actionById": "bbb6b2f3-bff8-41d3-a767-bdc641cc55d8",
        "action": null,
        "actionBy": "actionBy",
        "createdById": "41222c5a-6c70-473b-bcc9-3ba36704959d",
        "createdOn": "2025-09-04T05:19:36Z",
        "date": "2025-09-04T05:19:36Z",
        "id": "52cd7e52-714d-40e9-ae1e-9c6ee6dae895",
        "lastUpdated": "2025-09-04T05:19:36Z",
        "lastUpdatedById": "74944110-83b3-4e7c-a81d-278cde8c7509",
        "memo": "memo",
        "objectState": null,
        "sendTo": "sendTo",
        "sendToId": "ff44a9b5-8e5a-4571-8c4d-2d951dbc0137",
        "submitTo": null,
        "token": 0,
        "type": null,
        "version": "U3dhZ2dlciByb2Nrcw=="
      }
    ]
  }
]

Retrieve a Bill

Use this method to retrieve a specific bill. Pass id as the parameter.

Request URL

base_url/bill/{id}

/bill/{id}

Method Overview

HTTP Method:

GET

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

read:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
id	Path	Bill identifier	string

Response Body

Name	Description	Format
date	Date when a bill is created in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
number	This represents a bill number	string
vendorId	Identifier of a vendor	uuid
accountingDate	Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
accountsPayableId	Identifier of the Accounts Payable account associated with the bill	uuid
accountSplits	Represents the account splits	AccountSplits Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
amount	Total amount of a bill	double
balance	The outstanding amount on a bill	double
createdById	Identifier of the user who created this object	uuid
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
customFields []Array: Parent object can have multiple instances of this nested object under it.	List of custom fields	CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
dueDate	The due date of a bill based on the payment terms set in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
expenseItems []Array: Parent object can have multiple instances of this nested object under it.	List of expense line items on a bill	BillExpenseItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
id	Object identifier	uuid
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
lastUpdatedById	Identifier of the user who last updated this object	uuid
lineItems []Array: Parent object can have multiple instances of this nested object under it.	List of line items on a bill	BillLineItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
memo	Records any extra information or details about a bill	string
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectStateEnumerated type: Click to see possible values and their descriptions.
paymentStatus	Payment status of a bill, whether paid, partially paid, or unpaid	BillPaymentStatusEnumerated type: Click to see possible values and their descriptions.
referenceNumber	Reference number used to track a bill	string
reimbursable	Indicates whether the bill is an employee reimbursable expense	boolean
term	Payment term associated with a bill, e.g., Due Upon Receipt, Net 30, etc.	string
termId	Identifier of the payment term associated with a bill	uuid
token	Represents the token for update operations	int32
vendor	Name of a vendor	string
version	Implements concurrency on this object	byte
workflow []Array: Parent object can have multiple instances of this nested object under it.	Determines a list of workflow	WorkflowState Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.

Example Response

{
  "date": "2025-09-04T05:19:36Z",
  "number": "173567",
  "vendorId": "5164d991-1f14-4f03-bfe1-81e42044a5c8",
  "accountingDate": "2025-09-04T05:19:36Z",
  "accountsPayableId": "bd156da0-5e53-45a1-af79-954dc46c2ea8",
  "accountSplits": {
    "accrual": [
      {
        "account": "account",
        "accountId": "7dee001a-5c12-4103-aaf8-40816cc53bea",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ],
    "cash": [
      {
        "account": "account",
        "accountId": "088b08f8-f90c-49ee-86cb-4d169d5dbc41",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ]
  },
  "amount": 1,
  "balance": 1,
  "createdById": "5b00508c-f2e7-42dc-8605-d2988d842302",
  "createdOn": "2025-09-04T05:19:36Z",
  "customFields": [
    {
      "definitionId": "cbe6a56c-0234-4a77-867c-0d5989deda8f",
      "createdById": "98e9777f-3a4d-4541-aceb-3435618f6d4b",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "CustomFieldData Description",
      "id": "90df3c11-4c37-4570-abd5-d6f5179cc520",
      "label": "label",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "e78fd9d1-76b2-45c6-8e0f-88e03f4c01a4",
      "objectState": null,
      "token": 0,
      "type": null,
      "value": "value",
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "dueDate": "2025-09-04T05:19:36Z",
  "expenseItems": [
    {
      "accountId": "c06e9946-d04c-447c-aaba-2bb3c10ab5ca",
      "amount": 1,
      "account": "account",
      "class": "class",
      "classId": "051f4456-dd0b-4cf0-bef5-47c6c6e8923c",
      "createdById": "e02741f6-85b5-43f7-ae4f-dc982f456b96",
      "createdOn": "2025-09-04T05:19:36Z",
      "entity": "entity",
      "entityId": "0acdaaf3-00c1-440b-9019-bd3aa4d8bf59",
      "entityType": null,
      "id": "8bd25ce9-a56d-4203-b5ea-3d51371c3e7d",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "c3ae0986-8cf8-40de-9f45-c810cce833b2",
      "memo": "memo",
      "objectState": null,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "id": "e1555a78-9178-483a-9dcf-9a30152bd169",
  "lastUpdated": "2025-09-04T05:19:36Z",
  "lastUpdatedById": "8529b162-c78d-4089-a5be-c7de6c641eee",
  "lineItems": [
    {
      "itemId": "3066e7cc-cced-4486-8231-6108e24c7e59",
      "itemType": null,
      "projectId": "357f45e2-ccd7-450f-8e97-f6f1abec3ca3",
      "rate": 1,
      "units": 1,
      "amount": 1,
      "billable": true,
      "billRate": 1,
      "class": "class",
      "classId": "bfd696e6-85c8-4d63-a934-436e063e7fb4",
      "createdById": "6c4a7f4a-b64b-4f44-b6fe-6d04530ae966",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "BillLineItem Description",
      "expenseAccount": "expenseAccount",
      "expenseAccountId": "d9a29507-c2e6-4b90-953d-e7c9c8d84d54",
      "extra": true,
      "id": "be8dd94a-68cd-4d06-bd4f-a8994fe64716",
      "incomeAccount": "incomeAccount",
      "incomeAccountId": "32484753-539d-4bdb-bc5c-699bde378822",
      "item": "item",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "2f3395a5-a794-4476-8764-534ed6ce2a74",
      "markup": 1,
      "memo": "memo",
      "objectState": null,
      "project": "project",
      "purchaseTaxRate": 1,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "memo": "memo",
  "objectState": null,
  "paymentStatus": null,
  "referenceNumber": "referenceNumber",
  "reimbursable": true,
  "term": "term",
  "termId": "9ef2811f-74e4-4a9c-ba97-96cf17f5cded",
  "token": 0,
  "vendor": "vendor",
  "version": "U3dhZ2dlciByb2Nrcw==",
  "workflow": [
    {
      "actionById": "daffa222-14f0-429b-8641-24e5c2bf090b",
      "action": null,
      "actionBy": "actionBy",
      "createdById": "5b2c521b-fd31-496b-abe4-51570cff7b15",
      "createdOn": "2025-09-04T05:19:36Z",
      "date": "2025-09-04T05:19:36Z",
      "id": "bfe65f9a-6295-46c0-83b1-86f52305e2e9",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "164ff7d0-0dc6-4c76-bc1a-518c01019dec",
      "memo": "memo",
      "objectState": null,
      "sendTo": "sendTo",
      "sendToId": "f49782a5-3066-4fa5-a3ee-09fb4fcbc680",
      "submitTo": null,
      "token": 0,
      "type": null,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ]
}

Create a Bill

Use this method to save a bill. Pass bill as the parameter.

Request URL

base_url/bill

/bill

Method Overview

HTTP Method:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

readwrite:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
body	Body	Bill object	Bill

Response Body

Name	Description	Format
date	Date when a bill is created in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
number	This represents a bill number	string
vendorId	Identifier of a vendor	uuid
accountingDate	Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
accountsPayableId	Identifier of the Accounts Payable account associated with the bill	uuid
accountSplits	Represents the account splits	AccountSplits Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
amount	Total amount of a bill	double
balance	The outstanding amount on a bill	double
createdById	Identifier of the user who created this object	uuid
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
customFields []Array: Parent object can have multiple instances of this nested object under it.	List of custom fields	CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
dueDate	The due date of a bill based on the payment terms set in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
expenseItems []Array: Parent object can have multiple instances of this nested object under it.	List of expense line items on a bill	BillExpenseItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
id	Object identifier	uuid
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
lastUpdatedById	Identifier of the user who last updated this object	uuid
lineItems []Array: Parent object can have multiple instances of this nested object under it.	List of line items on a bill	BillLineItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
memo	Records any extra information or details about a bill	string
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectStateEnumerated type: Click to see possible values and their descriptions.
paymentStatus	Payment status of a bill, whether paid, partially paid, or unpaid	BillPaymentStatusEnumerated type: Click to see possible values and their descriptions.
referenceNumber	Reference number used to track a bill	string
reimbursable	Indicates whether the bill is an employee reimbursable expense	boolean
term	Payment term associated with a bill, e.g., Due Upon Receipt, Net 30, etc.	string
termId	Identifier of the payment term associated with a bill	uuid
token	Represents the token for update operations	int32
vendor	Name of a vendor	string
version	Implements concurrency on this object	byte
workflow []Array: Parent object can have multiple instances of this nested object under it.	Determines a list of workflow	WorkflowState Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.

Example Response

{
  "date": "2025-09-04T05:19:36Z",
  "number": "173567",
  "vendorId": "34c297f4-3ba6-46fb-a588-a2116edd98da",
  "accountingDate": "2025-09-04T05:19:36Z",
  "accountsPayableId": "e052e2fd-bcac-4848-b10d-3f7a7e81b238",
  "accountSplits": {
    "accrual": [
      {
        "account": "account",
        "accountId": "03e73e80-09cf-4b42-89cd-2b45522f0df4",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ],
    "cash": [
      {
        "account": "account",
        "accountId": "1d3956a4-e3e9-4b8d-861b-d26fadf948ba",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ]
  },
  "amount": 1,
  "balance": 1,
  "createdById": "04006f65-7d80-4cb2-ac51-4387c1c199af",
  "createdOn": "2025-09-04T05:19:36Z",
  "customFields": [
    {
      "definitionId": "40e58612-1335-45aa-b4bf-e0e3eaed2dfc",
      "createdById": "484aafa0-a26c-4397-9a9c-46149ac1eb56",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "CustomFieldData Description",
      "id": "33967885-1f1b-4981-8ed5-1bbe89196268",
      "label": "label",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "c5891c06-7c2a-467b-96d8-c68ced215138",
      "objectState": null,
      "token": 0,
      "type": null,
      "value": "value",
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "dueDate": "2025-09-04T05:19:36Z",
  "expenseItems": [
    {
      "accountId": "710f501e-d496-4a1b-a603-cbeb12291f93",
      "amount": 1,
      "account": "account",
      "class": "class",
      "classId": "5403e86c-72e3-4f61-9626-b4207e496ff1",
      "createdById": "f1dffc2f-7874-48f6-894b-27a78afdbc28",
      "createdOn": "2025-09-04T05:19:36Z",
      "entity": "entity",
      "entityId": "2d33480b-ef7b-44c9-a829-3435d380feba",
      "entityType": null,
      "id": "b1dd2738-e55c-409d-ab3c-f03981a8e6cd",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "afce4599-340c-4fa5-88f9-3b264e0a8d0c",
      "memo": "memo",
      "objectState": null,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "id": "39e3731d-a3d2-42a3-9fd4-6ae32f76f704",
  "lastUpdated": "2025-09-04T05:19:36Z",
  "lastUpdatedById": "c3340717-47cd-4657-96bc-381c74ff8e82",
  "lineItems": [
    {
      "itemId": "dbea3ecd-4324-496d-8286-e78025687920",
      "itemType": null,
      "projectId": "4d77f291-a6b7-404f-9399-9410605ee952",
      "rate": 1,
      "units": 1,
      "amount": 1,
      "billable": true,
      "billRate": 1,
      "class": "class",
      "classId": "85509ce7-36e5-4832-b539-ca0f7e738d7f",
      "createdById": "46cb54fe-3f3d-4aad-ae71-deee94faaac1",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "BillLineItem Description",
      "expenseAccount": "expenseAccount",
      "expenseAccountId": "e4c4bb0a-5a95-4a7e-8e4f-e28e73a0f7e5",
      "extra": true,
      "id": "a7e57c0a-bc05-429b-ac63-8ea90bd0c320",
      "incomeAccount": "incomeAccount",
      "incomeAccountId": "73f5039f-6a52-482f-9d15-bd05a67d745d",
      "item": "item",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "89bd51f9-4289-4ec3-8bd1-c925f57432f3",
      "markup": 1,
      "memo": "memo",
      "objectState": null,
      "project": "project",
      "purchaseTaxRate": 1,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "memo": "memo",
  "objectState": null,
  "paymentStatus": null,
  "referenceNumber": "referenceNumber",
  "reimbursable": true,
  "term": "term",
  "termId": "cc0a628c-c385-43ea-8dbe-8137d67b3925",
  "token": 0,
  "vendor": "vendor",
  "version": "U3dhZ2dlciByb2Nrcw==",
  "workflow": [
    {
      "actionById": "37fb9ebe-37c4-466d-b1e2-ddc800ab30d1",
      "action": null,
      "actionBy": "actionBy",
      "createdById": "45952d34-e217-422a-bc8e-1cb220a5167d",
      "createdOn": "2025-09-04T05:19:36Z",
      "date": "2025-09-04T05:19:36Z",
      "id": "3d31d206-bbac-4511-9f68-73bdd47ddbe1",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "e89c8637-327d-4509-8e0b-ca844589d3bc",
      "memo": "memo",
      "objectState": null,
      "sendTo": "sendTo",
      "sendToId": "98473a9b-265c-4f46-9433-15aa7927febe",
      "submitTo": null,
      "token": 0,
      "type": null,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ]
}

Create a Bill List

Use this method to save multiple bill. Pass model as the parameter.

As saving multiple records in a batch takes time, this endpoint returns a Job object that shows the progress of the batch operation. To check the status of the operation at any time, use the job endpoint.

Request URL

base_url/bill/batch

/bill/batch

Method Overview

HTTP Method:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

readwrite:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
body	Body	Bill object	BillBatchRequest

Response Body

Name	Description	Format
batchSize	Represents the number of entities in a batch	int64
createdById	Identifier of the user who created this object	uuid
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
id	Object identifier	uuid
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
lastUpdatedById	Identifier of the user who last updated this object	uuid
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectStateEnumerated type: Click to see possible values and their descriptions.
progress	Represents the total number of entities processed	int64
status	Represents the status of a job e.g., ready, running, completed, or terminated	string
token	Represents the token for update operations	int32
type	Represents the type of a job e.g., create, update, or delete	string
version	Implements concurrency on this object	byte

Example Response

{
  "batchSize": 0,
  "createdById": "aa0ea9cb-5aaa-4fed-b085-cd267e656c86",
  "createdOn": "2025-09-04T05:19:36Z",
  "id": "5253527a-692f-473a-8917-53916f965594",
  "lastUpdated": "2025-09-04T05:19:36Z",
  "lastUpdatedById": "5e0af6c0-5830-4d10-bde3-6b2d520b98dc",
  "objectState": null,
  "progress": 0,
  "status": "status",
  "token": 0,
  "type": "type",
  "version": "U3dhZ2dlciByb2Nrcw=="
}

Update a Bill

Use this method to update a bill. Pass id and bill as the parameters.

Request URL

base_url/bill/{id}

/bill/{id}

Method Overview

HTTP Method:

PUT

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

readwrite:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
id	Path	Bill identifier	string
body	Body	Bill object	Bill

Response Body

Name	Description	Format
date	Date when a bill is created in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
number	This represents a bill number	string
vendorId	Identifier of a vendor	uuid
accountingDate	Date that determines the accounting period to which the transaction belongs in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
accountsPayableId	Identifier of the Accounts Payable account associated with the bill	uuid
accountSplits	Represents the account splits	AccountSplits Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
amount	Total amount of a bill	double
balance	The outstanding amount on a bill	double
createdById	Identifier of the user who created this object	uuid
createdOn	Date and time when this object was created (UTC Now), in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
customFields []Array: Parent object can have multiple instances of this nested object under it.	List of custom fields	CustomFieldData Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
dueDate	The due date of a bill based on the payment terms set in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
expenseItems []Array: Parent object can have multiple instances of this nested object under it.	List of expense line items on a bill	BillExpenseItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
id	Object identifier	uuid
lastUpdated	Last updated date and time value of this object in ISO 8601 date-time format, such as YYYY-MM-DDThh:mm:ss	date-time
lastUpdatedById	Identifier of the user who last updated this object	uuid
lineItems []Array: Parent object can have multiple instances of this nested object under it.	List of line items on a bill	BillLineItem Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.
memo	Records any extra information or details about a bill	string
objectState	Represents the state of the object. e.g., new, unchanged, modified or deleted	ObjectStateEnumerated type: Click to see possible values and their descriptions.
paymentStatus	Payment status of a bill, whether paid, partially paid, or unpaid	BillPaymentStatusEnumerated type: Click to see possible values and their descriptions.
referenceNumber	Reference number used to track a bill	string
reimbursable	Indicates whether the bill is an employee reimbursable expense	boolean
term	Payment term associated with a bill, e.g., Due Upon Receipt, Net 30, etc.	string
termId	Identifier of the payment term associated with a bill	uuid
token	Represents the token for update operations	int32
vendor	Name of a vendor	string
version	Implements concurrency on this object	byte
workflow []Array: Parent object can have multiple instances of this nested object under it.	Determines a list of workflow	WorkflowState Nested object: Click to see its details. To retrieve the details of this object via list endpoints, you must use the Expand parameter.

Example Response

{
  "date": "2025-09-04T05:19:36Z",
  "number": "173567",
  "vendorId": "73d32f78-fcac-46e4-93ec-a61ba2b1a372",
  "accountingDate": "2025-09-04T05:19:36Z",
  "accountsPayableId": "0fe37d49-faed-418d-be19-b9228c632d8b",
  "accountSplits": {
    "accrual": [
      {
        "account": "account",
        "accountId": "eca837cf-60e0-47ab-aae8-fd5daaf41118",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ],
    "cash": [
      {
        "account": "account",
        "accountId": "3a0ebb23-f85e-4bcf-adb3-d4a19888bacb",
        "amount": 1,
        "isDebit": true,
        "isParent": true,
        "transactionType": null
      }
    ]
  },
  "amount": 1,
  "balance": 1,
  "createdById": "082b749e-2915-4be5-bada-00e6027c95a0",
  "createdOn": "2025-09-04T05:19:36Z",
  "customFields": [
    {
      "definitionId": "8519247d-2234-4c51-a07f-c081b8176df8",
      "createdById": "559511aa-1271-428b-bee8-17e2450d3eb7",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "CustomFieldData Description",
      "id": "5d1821fd-f6ec-4107-beff-77ed9bee628e",
      "label": "label",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "96c23534-8eec-4c0f-8fc7-f6952bec9bd5",
      "objectState": null,
      "token": 0,
      "type": null,
      "value": "value",
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "dueDate": "2025-09-04T05:19:36Z",
  "expenseItems": [
    {
      "accountId": "22e0931d-2e91-4fe8-b7ea-b7eb17f0e0ba",
      "amount": 1,
      "account": "account",
      "class": "class",
      "classId": "17ed0539-ad6a-42ad-a2e1-d026f893733a",
      "createdById": "e1027c4c-867d-46f0-9c1f-7ff08f9101b4",
      "createdOn": "2025-09-04T05:19:36Z",
      "entity": "entity",
      "entityId": "8681ba40-5dd4-41af-8c0c-a9607967cf23",
      "entityType": null,
      "id": "ef9432ad-48a4-45c7-92c7-eef458d27afe",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "71c4b7a4-32e0-4223-821a-24301bef9c05",
      "memo": "memo",
      "objectState": null,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "id": "819ed012-cbc4-42a1-b22f-dab3a095cd10",
  "lastUpdated": "2025-09-04T05:19:36Z",
  "lastUpdatedById": "5ee84dbf-a1ba-47a5-893d-7be30d17ce66",
  "lineItems": [
    {
      "itemId": "106bdf36-7e11-49de-9207-6cb569310c7c",
      "itemType": null,
      "projectId": "e8fe80eb-fe59-45eb-9063-26ebd47ca991",
      "rate": 1,
      "units": 1,
      "amount": 1,
      "billable": true,
      "billRate": 1,
      "class": "class",
      "classId": "ffe97a5a-1f67-4edf-968f-860e5593a5d7",
      "createdById": "025bd30a-71b3-48da-9c30-ed6f3cd88f54",
      "createdOn": "2025-09-04T05:19:36Z",
      "description": "BillLineItem Description",
      "expenseAccount": "expenseAccount",
      "expenseAccountId": "3236a845-645e-4844-957a-7511c455c7d6",
      "extra": true,
      "id": "87982a3d-8e8e-49b6-b554-f96f09223a65",
      "incomeAccount": "incomeAccount",
      "incomeAccountId": "19d59f48-34a6-432b-9b7e-0d01bef9fb85",
      "item": "item",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "165c81b9-2a2c-46e0-8819-fccc42e9a233",
      "markup": 1,
      "memo": "memo",
      "objectState": null,
      "project": "project",
      "purchaseTaxRate": 1,
      "token": 0,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ],
  "memo": "memo",
  "objectState": null,
  "paymentStatus": null,
  "referenceNumber": "referenceNumber",
  "reimbursable": true,
  "term": "term",
  "termId": "f224a25e-9a27-4ddc-a40f-84cfe6093e6c",
  "token": 0,
  "vendor": "vendor",
  "version": "U3dhZ2dlciByb2Nrcw==",
  "workflow": [
    {
      "actionById": "44d6a019-41a0-4bc0-b445-022bca151b44",
      "action": null,
      "actionBy": "actionBy",
      "createdById": "1da09455-a4da-4f0c-bd8b-8b5544095a4c",
      "createdOn": "2025-09-04T05:19:36Z",
      "date": "2025-09-04T05:19:36Z",
      "id": "dc514456-22d5-4aa4-a0ed-28e388098282",
      "lastUpdated": "2025-09-04T05:19:36Z",
      "lastUpdatedById": "16fc9229-5df8-4419-8457-aada7d9dcb05",
      "memo": "memo",
      "objectState": null,
      "sendTo": "sendTo",
      "sendToId": "26f017d7-5db8-43e2-8506-bf2b5bc23d2c",
      "submitTo": null,
      "token": 0,
      "type": null,
      "version": "U3dhZ2dlciByb2Nrcw=="
    }
  ]
}

Delete a Bill

Use this method to delete a bill. Pass id as the parameter.

Request URL

base_url/bill/{id}

/bill/{id}

Method Overview

HTTP Method:

DELETE

Content Type:

application/json

Response Format:

N/A

Requires Authentication?

Yes

Headers:

Access Token

Required Scopes:

readwrite:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
id	Path	Bill identifier	string

Patch a Bill

Use this method to perform partial modifications to a bill. Pass id and patch document as parameters.

Request URL

base_url/bill/{id}

/bill/{id}

Method Overview

HTTP Method:

PATCH

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Headers:

Access Token

Module:

Bill

Required Scopes:

readwrite:core

Required Subscription:

View Subscription

Request Parameters asterisk denotes required

Name	Parameter Type	Description	Format
id	Path	Bill identifier	string
body	Body	A document containing an array of objects with each object representing a single operation to be performed	BillPatchDocument

Response Body

Name	Description	Format

Bill

The Bill Object

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body

Request URL

Method Overview

Request Parameters asterisk denotes required

Request URL

Method Overview

Request Parameters asterisk denotes required

Response Body