General
Server Side SDKs
Core API
- Companies
- Invite Links
- Integrations
- Sync
- Jobs
- Passthrough
Unified API
- Accounting
- Accounts
- Bank Accounts
- Bank Transactions
- Bills
- Bill Payments
- Bill Credit Notes
- Contacts
- Company Info
- Currencies
- Documents
- Expenses
- Invoice Credit Notes
- Invoices
- Invoice Payments
- Items
- Journal Entries
- Purchase Orders
- Sales Orders
- Goods Receipt Notes
- Projects
- Tax Rates
- Tracking Categories
- Balance Sheet
- Cash Flow Statements
- Income Statements
Invoices
Get Invoices
Retrieve invoice from the database based on the ID
POST
/
accounting
/
invoices
/
all
curl --request POST \
--url https://api.rootfi.dev/accounting/invoices/all \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"take": 10,
"skip": 0,
"orderBy": {
"contact_id": "asc"
},
"filter": {
"status": {
"eq": "PAID"
}
}
}'
{
"data": {
"data": [
{
"rootfi_id": 1395686,
"rootfi_company_id": 1760,
"rootfi_organisation_id": 1,
"rootfi_integration_type": "ZOHO_BOOKS",
"rootfi_updated_at": "2023-10-27T05:05:28.522Z",
"rootfi_created_at": "2023-10-27T05:05:28.551Z",
"platform_id": "1234567890123456789",
"contact_id": "1234567890123456789",
"currency_id": null,
"document_number": "INVT136",
"posted_date": "2023-03-17T00:00:00.000Z",
"due_date": "2024-03-19T00:00:00.000Z",
"memo": "Test Invoice",
"currency_rate": null,
"status": "PAID",
"tax_amount": 19,
"total_discount": null,
"total_amount": 219,
"sales_order_ids": null,
"sub_total": 200,
"amount_due": 0,
"updated_at": "2023-10-26T00:00:00.000Z",
"currency": {
"data": {
"platform_id": null,
"name": null,
"code": null,
"symbol": null,
"is_base_currency": null,
"exchange_rate": null,
"updated_at": null
}
},
"payments": {
"data": [
{
"platform_id": "3770712000000080515",
"payment_id": "3770712000000080513",
"invoice_id": "3770712000000080288",
"account_id": "3770712000000000388",
"contact_id": "3770712000000080069",
"amount": 120,
"currency_id": "3770712000000000099",
"currency": {
"data": {
"platform_id": "3770712000000000099",
"name": "Indian Rupee",
"code": "INR",
"symbol": "₹",
"is_base_currency": true,
"exchange_rate": 0,
"updated_at": null
}
},
"payment_date": "2022-10-21T00:00:00.000Z",
"payment_mode": "Cash",
"memo": null,
"currency_rate": 1,
"document_number": "AO-000001",
"updated_at": null
}
]
},
"line_items": {
"data": [
{
"platform_id": "1_793",
"line_item_type": "INVOICES",
"line_item_type_id": "793",
"tracking_category_ids": [
"5000000000000279513"
],
"item_id": "19",
"tax_id": "7",
"account_id": null,
"description": "Item 111 testtt",
"quantity": 10,
"unit_amount": 20,
"total_amount": 200,
"sub_total": null,
"tax_amount": null,
"total_discount": null,
"updated_at": null
}
]
},
"documents": {
"data": [
{
"platform_id": "3770712000000203032_3770712000000080288",
"file_name": "sample_upload.xlsx",
"file_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"file_size": 6019.53,
"document_type_id": "3770712000000080288",
"document_type": "Invoices",
"document_uploaded": false,
"download_link": "https://books.zoho.com/api/v3/documents/3770712000000203032_3770712000000080288",
"updated_at": "2022-09-28T00:00:00.000Z"
}
]
}
}
],
"total_count": 1
},
"request_timestamp": "2023-10-27T05:05:28.522Z",
"response_timestamp": "2023-10-27T05:05:28.522Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}
An invoice is an itemized record of goods sold or services provided to a customer.
curl --request POST \
--url https://api.rootfi.dev/accounting/invoices/all \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"take": 10,
"skip": 0,
"orderBy": {
"contact_id": "asc"
},
"filter": {
"status": {
"eq": "PAID"
}
}
}'
Authorizations
Body
application/json
Response
200 - application/json
The response is of type object
.
curl --request POST \
--url https://api.rootfi.dev/accounting/invoices/all \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '{
"take": 10,
"skip": 0,
"orderBy": {
"contact_id": "asc"
},
"filter": {
"status": {
"eq": "PAID"
}
}
}'
{
"data": {
"data": [
{
"rootfi_id": 1395686,
"rootfi_company_id": 1760,
"rootfi_organisation_id": 1,
"rootfi_integration_type": "ZOHO_BOOKS",
"rootfi_updated_at": "2023-10-27T05:05:28.522Z",
"rootfi_created_at": "2023-10-27T05:05:28.551Z",
"platform_id": "1234567890123456789",
"contact_id": "1234567890123456789",
"currency_id": null,
"document_number": "INVT136",
"posted_date": "2023-03-17T00:00:00.000Z",
"due_date": "2024-03-19T00:00:00.000Z",
"memo": "Test Invoice",
"currency_rate": null,
"status": "PAID",
"tax_amount": 19,
"total_discount": null,
"total_amount": 219,
"sales_order_ids": null,
"sub_total": 200,
"amount_due": 0,
"updated_at": "2023-10-26T00:00:00.000Z",
"currency": {
"data": {
"platform_id": null,
"name": null,
"code": null,
"symbol": null,
"is_base_currency": null,
"exchange_rate": null,
"updated_at": null
}
},
"payments": {
"data": [
{
"platform_id": "3770712000000080515",
"payment_id": "3770712000000080513",
"invoice_id": "3770712000000080288",
"account_id": "3770712000000000388",
"contact_id": "3770712000000080069",
"amount": 120,
"currency_id": "3770712000000000099",
"currency": {
"data": {
"platform_id": "3770712000000000099",
"name": "Indian Rupee",
"code": "INR",
"symbol": "₹",
"is_base_currency": true,
"exchange_rate": 0,
"updated_at": null
}
},
"payment_date": "2022-10-21T00:00:00.000Z",
"payment_mode": "Cash",
"memo": null,
"currency_rate": 1,
"document_number": "AO-000001",
"updated_at": null
}
]
},
"line_items": {
"data": [
{
"platform_id": "1_793",
"line_item_type": "INVOICES",
"line_item_type_id": "793",
"tracking_category_ids": [
"5000000000000279513"
],
"item_id": "19",
"tax_id": "7",
"account_id": null,
"description": "Item 111 testtt",
"quantity": 10,
"unit_amount": 20,
"total_amount": 200,
"sub_total": null,
"tax_amount": null,
"total_discount": null,
"updated_at": null
}
]
},
"documents": {
"data": [
{
"platform_id": "3770712000000203032_3770712000000080288",
"file_name": "sample_upload.xlsx",
"file_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"file_size": 6019.53,
"document_type_id": "3770712000000080288",
"document_type": "Invoices",
"document_uploaded": false,
"download_link": "https://books.zoho.com/api/v3/documents/3770712000000203032_3770712000000080288",
"updated_at": "2022-09-28T00:00:00.000Z"
}
]
}
}
],
"total_count": 1
},
"request_timestamp": "2023-10-27T05:05:28.522Z",
"response_timestamp": "2023-10-27T05:05:28.522Z",
"request_id": "7a1c0e42-9f85-4d6e-bb5d-358a72913c0b"
}