Create Expense

curl --request POST \
  --url https://api.rootfi.dev/v3/accounting/expenses \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "company_id": 123,
  "data": [
    {
      "platform_id": "<string>",
      "contact_id": "<string>",
      "account_id": "<string>",
      "document_number": "<string>",
      "posted_date": "<string>",
      "payment_mode": "<string>",
      "currency_id": "<string>",
      "currency_rate": 123,
      "total_discount": 123,
      "memo": "<string>",
      "line_items": [
        {
          "tracking_category_ids": [
            "<string>"
          ],
          "project_id": "<string>",
          "item_id": "<string>",
          "tax_id": "<string>",
          "account_id": "<string>",
          "description": "<string>",
          "quantity": 123,
          "unit_amount": 123,
          "total_discount": 123
        }
      ]
    }
  ],
  "run_async": true
}
'

{
  "data": {
    "rootfi_id": 157,
    "rootfi_created_at": "2024-01-22T05:07:31.465Z",
    "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
    "rootfi_company_id": 1089,
    "platform_id": "123456",
    "rootfi_deleted_at": "2023-11-07T05:31:56Z",
    "platform_unique_id": "<string>",
    "raw_data": {},
    "data_hash": "<string>",
    "contact_id": "<string>",
    "account_id": "<string>",
    "document_number": "<string>",
    "posted_date": "<string>",
    "payment_mode": "<string>",
    "currency_id": "<string>",
    "currency_rate": 123,
    "total_amount": 123,
    "sub_total": 123,
    "tax_amount": 123,
    "total_discount": 123,
    "memo": "<string>",
    "updated_at": "<string>",
    "line_items": [
      {
        "rootfi_id": 123,
        "platform_id": "<string>",
        "line_item_type": "BILLS",
        "line_item_type_id": "<string>",
        "tracking_category_ids": [
          "<string>"
        ],
        "project_id": "<string>",
        "item_id": "<string>",
        "item": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "description": "<string>",
          "status": "ACTIVE",
          "type": "INVENTORY",
          "code": "<string>",
          "quantity_on_hand": 123,
          "is_bill_item": true,
          "bill_item": {
            "tax_id": "<string>",
            "account_id": "<string>",
            "unit_price": 123,
            "description": "<string>"
          },
          "is_invoice_item": true,
          "invoice_item": {
            "tax_id": "<string>",
            "account_id": "<string>",
            "unit_price": 123,
            "description": "<string>"
          },
          "updated_at": "<string>"
        },
        "tax_id": "<string>",
        "tax": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "code": "<string>",
          "tax_type": "<string>",
          "effective_tax_rate": 123,
          "total_tax_rate": 123,
          "components": [
            {
              "name": "<string>",
              "rate": 123,
              "tax_agency": "<string>",
              "is_compound": true
            }
          ],
          "updated_at": "<string>"
        },
        "account_id": "<string>",
        "account": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "description": "<string>",
          "nominal_code": "<string>",
          "current_balance": 123,
          "updated_at": "<string>",
          "status": "<string>",
          "category": "ASSET",
          "sub_category": "<string>",
          "currency_id": "<string>",
          "parent_account_id": "<string>",
          "parent_account": {
            "rootfi_id": 157,
            "rootfi_created_at": "2024-01-22T05:07:31.465Z",
            "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
            "rootfi_company_id": 1089,
            "platform_id": "123456",
            "rootfi_deleted_at": "2023-11-07T05:31:56Z",
            "platform_unique_id": "<string>",
            "raw_data": {},
            "data_hash": "<string>",
            "name": "<string>",
            "description": "<string>",
            "nominal_code": "<string>",
            "current_balance": 123,
            "updated_at": "<string>",
            "status": "<string>",
            "category": "ASSET",
            "sub_category": "<string>",
            "currency_id": "<string>",
            "parent_account_id": "<string>"
          },
          "currency": {
            "rootfi_id": 157,
            "rootfi_created_at": "2024-01-22T05:07:31.465Z",
            "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
            "rootfi_company_id": 1089,
            "platform_id": "123456",
            "rootfi_deleted_at": "2023-11-07T05:31:56Z",
            "platform_unique_id": "<string>",
            "raw_data": {},
            "data_hash": "<string>",
            "name": "<string>",
            "code": "<string>",
            "symbol": "<string>",
            "is_base_currency": true,
            "exchange_rate": 123,
            "updated_at": "<string>"
          }
        },
        "description": "<string>",
        "quantity": 123,
        "unit_amount": 123,
        "total_amount": 123,
        "sub_total": 123,
        "tax_amount": 123,
        "total_discount": 123,
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "contact": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "contact_name": "<string>",
      "contact_type": "CUSTOMER",
      "currency_id": "<string>",
      "tax_number": "<string>",
      "registration_number": "<string>",
      "status": "ACTIVE",
      "updated_at": "<string>",
      "external_links": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "link": "<string>",
          "type": "EMAIL"
        }
      ],
      "phone_numbers": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "number": "<string>",
          "type": "MOBILE"
        }
      ],
      "addresses": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "street": "<string>",
          "locality": "<string>",
          "city": "<string>",
          "state": "<string>",
          "pincode": "<string>",
          "country": "<string>"
        }
      ]
    },
    "currency": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "code": "<string>",
      "symbol": "<string>",
      "is_base_currency": true,
      "exchange_rate": 123,
      "updated_at": "<string>"
    },
    "account": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "description": "<string>",
      "nominal_code": "<string>",
      "current_balance": 123,
      "updated_at": "<string>",
      "status": "<string>",
      "category": "ASSET",
      "sub_category": "<string>",
      "currency_id": "<string>",
      "parent_account_id": "<string>",
      "parent_account": {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "name": "<string>",
        "description": "<string>",
        "nominal_code": "<string>",
        "current_balance": 123,
        "updated_at": "<string>",
        "status": "<string>",
        "category": "ASSET",
        "sub_category": "<string>",
        "currency_id": "<string>",
        "parent_account_id": "<string>"
      },
      "currency": {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "name": "<string>",
        "code": "<string>",
        "symbol": "<string>",
        "is_base_currency": true,
        "exchange_rate": 123,
        "updated_at": "<string>"
      }
    },
    "documents": [
      {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "file_name": "<string>",
        "file_type": "<string>",
        "file_size": "<string>",
        "document_type_id": "<string>",
        "document_type": "<string>",
        "document_uploaded": true,
        "updated_at": "<string>"
      }
    ]
  },
  "sync_id": "<string>"
}

POST

accounting

expenses

Create Expense

curl --request POST \
  --url https://api.rootfi.dev/v3/accounting/expenses \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "company_id": 123,
  "data": [
    {
      "platform_id": "<string>",
      "contact_id": "<string>",
      "account_id": "<string>",
      "document_number": "<string>",
      "posted_date": "<string>",
      "payment_mode": "<string>",
      "currency_id": "<string>",
      "currency_rate": 123,
      "total_discount": 123,
      "memo": "<string>",
      "line_items": [
        {
          "tracking_category_ids": [
            "<string>"
          ],
          "project_id": "<string>",
          "item_id": "<string>",
          "tax_id": "<string>",
          "account_id": "<string>",
          "description": "<string>",
          "quantity": 123,
          "unit_amount": 123,
          "total_discount": 123
        }
      ]
    }
  ],
  "run_async": true
}
'

{
  "data": {
    "rootfi_id": 157,
    "rootfi_created_at": "2024-01-22T05:07:31.465Z",
    "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
    "rootfi_company_id": 1089,
    "platform_id": "123456",
    "rootfi_deleted_at": "2023-11-07T05:31:56Z",
    "platform_unique_id": "<string>",
    "raw_data": {},
    "data_hash": "<string>",
    "contact_id": "<string>",
    "account_id": "<string>",
    "document_number": "<string>",
    "posted_date": "<string>",
    "payment_mode": "<string>",
    "currency_id": "<string>",
    "currency_rate": 123,
    "total_amount": 123,
    "sub_total": 123,
    "tax_amount": 123,
    "total_discount": 123,
    "memo": "<string>",
    "updated_at": "<string>",
    "line_items": [
      {
        "rootfi_id": 123,
        "platform_id": "<string>",
        "line_item_type": "BILLS",
        "line_item_type_id": "<string>",
        "tracking_category_ids": [
          "<string>"
        ],
        "project_id": "<string>",
        "item_id": "<string>",
        "item": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "description": "<string>",
          "status": "ACTIVE",
          "type": "INVENTORY",
          "code": "<string>",
          "quantity_on_hand": 123,
          "is_bill_item": true,
          "bill_item": {
            "tax_id": "<string>",
            "account_id": "<string>",
            "unit_price": 123,
            "description": "<string>"
          },
          "is_invoice_item": true,
          "invoice_item": {
            "tax_id": "<string>",
            "account_id": "<string>",
            "unit_price": 123,
            "description": "<string>"
          },
          "updated_at": "<string>"
        },
        "tax_id": "<string>",
        "tax": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "code": "<string>",
          "tax_type": "<string>",
          "effective_tax_rate": 123,
          "total_tax_rate": 123,
          "components": [
            {
              "name": "<string>",
              "rate": 123,
              "tax_agency": "<string>",
              "is_compound": true
            }
          ],
          "updated_at": "<string>"
        },
        "account_id": "<string>",
        "account": {
          "rootfi_id": 157,
          "rootfi_created_at": "2024-01-22T05:07:31.465Z",
          "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
          "rootfi_company_id": 1089,
          "platform_id": "123456",
          "rootfi_deleted_at": "2023-11-07T05:31:56Z",
          "platform_unique_id": "<string>",
          "raw_data": {},
          "data_hash": "<string>",
          "name": "<string>",
          "description": "<string>",
          "nominal_code": "<string>",
          "current_balance": 123,
          "updated_at": "<string>",
          "status": "<string>",
          "category": "ASSET",
          "sub_category": "<string>",
          "currency_id": "<string>",
          "parent_account_id": "<string>",
          "parent_account": {
            "rootfi_id": 157,
            "rootfi_created_at": "2024-01-22T05:07:31.465Z",
            "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
            "rootfi_company_id": 1089,
            "platform_id": "123456",
            "rootfi_deleted_at": "2023-11-07T05:31:56Z",
            "platform_unique_id": "<string>",
            "raw_data": {},
            "data_hash": "<string>",
            "name": "<string>",
            "description": "<string>",
            "nominal_code": "<string>",
            "current_balance": 123,
            "updated_at": "<string>",
            "status": "<string>",
            "category": "ASSET",
            "sub_category": "<string>",
            "currency_id": "<string>",
            "parent_account_id": "<string>"
          },
          "currency": {
            "rootfi_id": 157,
            "rootfi_created_at": "2024-01-22T05:07:31.465Z",
            "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
            "rootfi_company_id": 1089,
            "platform_id": "123456",
            "rootfi_deleted_at": "2023-11-07T05:31:56Z",
            "platform_unique_id": "<string>",
            "raw_data": {},
            "data_hash": "<string>",
            "name": "<string>",
            "code": "<string>",
            "symbol": "<string>",
            "is_base_currency": true,
            "exchange_rate": 123,
            "updated_at": "<string>"
          }
        },
        "description": "<string>",
        "quantity": 123,
        "unit_amount": 123,
        "total_amount": 123,
        "sub_total": 123,
        "tax_amount": 123,
        "total_discount": 123,
        "updated_at": "2023-11-07T05:31:56Z"
      }
    ],
    "contact": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "contact_name": "<string>",
      "contact_type": "CUSTOMER",
      "currency_id": "<string>",
      "tax_number": "<string>",
      "registration_number": "<string>",
      "status": "ACTIVE",
      "updated_at": "<string>",
      "external_links": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "link": "<string>",
          "type": "EMAIL"
        }
      ],
      "phone_numbers": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "number": "<string>",
          "type": "MOBILE"
        }
      ],
      "addresses": [
        {
          "rootfi_id": 123,
          "platform_id": "<string>",
          "street": "<string>",
          "locality": "<string>",
          "city": "<string>",
          "state": "<string>",
          "pincode": "<string>",
          "country": "<string>"
        }
      ]
    },
    "currency": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "code": "<string>",
      "symbol": "<string>",
      "is_base_currency": true,
      "exchange_rate": 123,
      "updated_at": "<string>"
    },
    "account": {
      "rootfi_id": 157,
      "rootfi_created_at": "2024-01-22T05:07:31.465Z",
      "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
      "rootfi_company_id": 1089,
      "platform_id": "123456",
      "rootfi_deleted_at": "2023-11-07T05:31:56Z",
      "platform_unique_id": "<string>",
      "raw_data": {},
      "data_hash": "<string>",
      "name": "<string>",
      "description": "<string>",
      "nominal_code": "<string>",
      "current_balance": 123,
      "updated_at": "<string>",
      "status": "<string>",
      "category": "ASSET",
      "sub_category": "<string>",
      "currency_id": "<string>",
      "parent_account_id": "<string>",
      "parent_account": {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "name": "<string>",
        "description": "<string>",
        "nominal_code": "<string>",
        "current_balance": 123,
        "updated_at": "<string>",
        "status": "<string>",
        "category": "ASSET",
        "sub_category": "<string>",
        "currency_id": "<string>",
        "parent_account_id": "<string>"
      },
      "currency": {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "name": "<string>",
        "code": "<string>",
        "symbol": "<string>",
        "is_base_currency": true,
        "exchange_rate": 123,
        "updated_at": "<string>"
      }
    },
    "documents": [
      {
        "rootfi_id": 157,
        "rootfi_created_at": "2024-01-22T05:07:31.465Z",
        "rootfi_updated_at": "2024-01-22T05:07:31.000Z",
        "rootfi_company_id": 1089,
        "platform_id": "123456",
        "rootfi_deleted_at": "2023-11-07T05:31:56Z",
        "platform_unique_id": "<string>",
        "raw_data": {},
        "data_hash": "<string>",
        "file_name": "<string>",
        "file_type": "<string>",
        "file_size": "<string>",
        "document_type_id": "<string>",
        "document_type": "<string>",
        "document_uploaded": true,
        "updated_at": "<string>"
      }
    ]
  },
  "sync_id": "<string>"
}

Expenses are Payment made by a business at the time of purchase (ex. a credit card payment)

Authorizations

api_key

string

header

required

Body

application/json

company_id

integer

required

The ID of the company in the accounting platform

data

accountingUpdateExpenseFields · object[]

required

The data of the Expense to create

Show child attributes

data.platform_id

string | null

The platform ID of the Expense. Can we used to update the Expense

data.contact_id

string | null

The contact ID of the Expense

data.account_id

string | null

The account ID of the Expense

data.document_number

string | null

The document number of the Expense

data.posted_date

string | null

The posted date of the Expense

data.payment_mode

string | null

The payment mode of the Expense

data.currency_id

string | null

The ISO-4217 currency code of the Expense

data.currency_rate

number<double> | null

The currency rate of the Expense

data.total_discount

number<double> | null

The total discount of the Expense

data.memo

string | null

The memo of the Expense

data.line_items

CreateLineItemFields · object[] | null

The line items of the Expense

Show child attributes

data.line_items.tracking_category_ids

string[] | null

The tracking category ids of the line item

data.line_items.project_id

string | null

The project id of the line item

data.line_items.item_id

string | null

The item id of the line item

data.line_items.tax_id

string | null

The tax id of the line item

data.line_items.account_id

string | null

The account id of the line item

data.line_items.description

string | null

The description of the line item

data.line_items.quantity

number<double> | null

The quantity of the line item

data.line_items.unit_amount

number<double> | null

The unit amount of the line item

data.line_items.total_discount

number<double> | null

The total discount for the line item

run_async

boolean | null

Run the request asynchronously

Response

data

accountingExpenseObject · object

The data of the created Expense

Show child attributes

data.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.data_hash

string | null

The hash of the data

data.contact_id

string | null

The contact ID of the Expense

data.account_id

string | null

The account ID of the Expense

data.document_number

string | null

The document number of the Expense

data.posted_date

string | null

The posted date of the Expense

data.payment_mode

string | null

The payment mode of the Expense

data.currency_id

string | null

The ISO-4217 currency code of the Expense

data.currency_rate

number<double> | null

The currency rate of the Expense

data.total_amount

number<double> | null

The total amount of the Expense

data.sub_total

number<double> | null

The sub total of the Expense

data.tax_amount

number<double> | null

The tax amount of the Expense

data.total_discount

number<double> | null

The total discount of the Expense

data.memo

string | null

The memo of the Expense

data.updated_at

string | null

The updated at of the Expense

data.line_items

LineItemFields · object[] | null

The line items of the Expense

Show child attributes

data.line_items.rootfi_id

number<double> | null

The unique ID we assign for that data's information

data.line_items.platform_id

string | null

The platform id of the line item

data.line_items.line_item_type

enum<string> | null

The line item type of the line item

Available options:

BILLS,

INVOICES,

BILL_CREDIT_NOTES,

INVOICE_CREDIT_NOTES,

EXPENSES,

PURCHASE_ORDERS,

SALES_ORDERS

data.line_items.line_item_type_id

string | null

The line item type id of the line item

data.line_items.tracking_category_ids

string[] | null

The tracking category ids of the line item

data.line_items.project_id

string | null

The project id of the line item

data.line_items.item_id

string | null

The item id of the line item

data.line_items.item

accountingItemObject · object

The item of the line item

Show child attributes

data.line_items.item.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.line_items.item.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.line_items.item.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.line_items.item.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.line_items.item.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.line_items.item.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.line_items.item.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.line_items.item.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.line_items.item.data_hash

string | null

The hash of the data

data.line_items.item.name

string | null

Name of the item

data.line_items.item.description

string | null

Description of the item

data.line_items.item.status

enum<string> | null

Status of the item. Values are ACTIVE, ARCHIVED, UNKNOWN

Available options:

ACTIVE,

ARCHIVED,

UNKNOWN

data.line_items.item.type

enum<string> | null

Type of the item. Values are INVENTORY, NON_INVENTORY, SERVICE, UNKNOWN

Available options:

INVENTORY,

NON_INVENTORY,

SERVICE,

UNKNOWN

data.line_items.item.code

string | null

Reference code of the item

data.line_items.item.quantity_on_hand

integer | null

Quantity on hand

data.line_items.item.is_bill_item

boolean | null

Check if there are details (bill_item) of this item getting purchased

data.line_items.item.bill_item

accountingItemDetail · object

Item details of this item getting purchased

Show child attributes

data.line_items.item.bill_item.tax_id

string | null

Tax id of the item

data.line_items.item.bill_item.account_id

string | null

data.line_items.item.bill_item.unit_price

number<double> | null

Unit price of the item

data.line_items.item.bill_item.description

string | null

Description of the item

data.line_items.item.is_invoice_item

boolean | null

Check if there are details (invoice_item) of this item getting sold

data.line_items.item.invoice_item

accountingItemDetail · object

Item details of this item getting sold

Show child attributes

data.line_items.item.invoice_item.tax_id

string | null

Tax id of the item

data.line_items.item.invoice_item.account_id

string | null

data.line_items.item.invoice_item.unit_price

number<double> | null

Unit price of the item

data.line_items.item.invoice_item.description

string | null

Description of the item

data.line_items.item.updated_at

string | null

The date the item was last updated

data.line_items.tax_id

string | null

The tax id of the line item

data.line_items.tax

accountingTaxRateObject · object

The tax of the line item

Show child attributes

data.line_items.tax.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.line_items.tax.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.line_items.tax.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.line_items.tax.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.line_items.tax.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.line_items.tax.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.line_items.tax.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.line_items.tax.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.line_items.tax.data_hash

string | null

The hash of the data

data.line_items.tax.name

string | null

Display name

data.line_items.tax.code

string | null

Simple ID for the tax rate

data.line_items.tax.tax_type

string | null

The type of tax as mentioned in the accounting platform

data.line_items.tax.effective_tax_rate

number<double> | null

The total tax rate after accounting for the compounding effects of the all tax components

data.line_items.tax.total_tax_rate

number<double> | null

The sum of all the tax rate components

data.line_items.tax.components

accountingTaxRateComponent · object[] | null

The list of tax rate components

Show child attributes

data.line_items.tax.components.name

string | null

Display name

data.line_items.tax.components.rate

number<double> | null

The total tax rate after accounting for the compounding effects of the all tax components

data.line_items.tax.components.tax_agency

string | null

The tax agency of the tax rate component

data.line_items.tax.components.is_compound

boolean | null

Whether the tax rate component is compound

data.line_items.tax.updated_at

string | null

The last time the tax rate was updated

data.line_items.account_id

string | null

The account id of the line item

data.line_items.account

accountingAccountObject · object

The account of the line item

Show child attributes

data.line_items.account.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.line_items.account.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.line_items.account.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.line_items.account.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.line_items.account.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.line_items.account.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.line_items.account.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.line_items.account.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.line_items.account.data_hash

string | null

The hash of the data

data.line_items.account.name

string | null

Name of the account

data.line_items.account.description

string | null

Description of the account

data.line_items.account.nominal_code

string | null

The nominal code of the account

data.line_items.account.current_balance

number<double> | null

The current balance of the account

data.line_items.account.updated_at

string | null

The date the account was last updated

data.line_items.account.status

string | null

The status of the account

data.line_items.account.category

enum<string> | null

The category of the account

Available options:

ASSET,

EXPENSE,

LIABILITY,

EQUITY,

INCOME,

BANK,

UNKNOWN

data.line_items.account.sub_category

string | null

The sub category of the account

data.line_items.account.currency_id

string | null

The currency id of the account

data.line_items.account.parent_account_id

string | null

The parent account id of the account

data.line_items.account.parent_account

accountingAccountAllFields · object

The parent account of the account.

Show child attributes

data.line_items.account.parent_account.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.line_items.account.parent_account.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.line_items.account.parent_account.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.line_items.account.parent_account.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.line_items.account.parent_account.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.line_items.account.parent_account.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.line_items.account.parent_account.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.line_items.account.parent_account.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.line_items.account.parent_account.data_hash

string | null

The hash of the data

data.line_items.account.parent_account.name

string | null

Name of the account

data.line_items.account.parent_account.description

string | null

Description of the account

data.line_items.account.parent_account.nominal_code

string | null

The nominal code of the account

data.line_items.account.parent_account.current_balance

number<double> | null

The current balance of the account

data.line_items.account.parent_account.updated_at

string | null

The date the account was last updated

data.line_items.account.parent_account.status

string | null

The status of the account

data.line_items.account.parent_account.category

enum<string> | null

The category of the account

Available options:

ASSET,

EXPENSE,

LIABILITY,

EQUITY,

INCOME,

BANK,

UNKNOWN

data.line_items.account.parent_account.sub_category

string | null

The sub category of the account

data.line_items.account.parent_account.currency_id

string | null

The currency id of the account

data.line_items.account.parent_account.parent_account_id

string | null

The parent account id of the account

data.line_items.account.currency

accountingCurrencyObject · object

The currency of the account.

Show child attributes

data.line_items.account.currency.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.line_items.account.currency.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.line_items.account.currency.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.line_items.account.currency.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.line_items.account.currency.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.line_items.account.currency.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.line_items.account.currency.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.line_items.account.currency.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.line_items.account.currency.data_hash

string | null

The hash of the data

data.line_items.account.currency.name

string | null

The name of the currency

data.line_items.account.currency.code

string | null

The currency code.

data.line_items.account.currency.symbol

string | null

The symbol that represents the currency. Not applicable for many currencies.

data.line_items.account.currency.is_base_currency

boolean | null

Whether the currency is the base currency for the company.

data.line_items.account.currency.exchange_rate

number<double> | null

The exchange rate for the currency.

data.line_items.account.currency.updated_at

string | null

The last ISO 8601 timestamp that the data was updated at.

data.line_items.description

string | null

The description of the line item

data.line_items.quantity

number<double> | null

The quantity of the line item

data.line_items.unit_amount

number<double> | null

The unit amount of the line item

data.line_items.total_amount

number<double> | null

The total amount of the line item

data.line_items.sub_total

number<double> | null

The sub total of the line item

data.line_items.tax_amount

number<double> | null

The tax amount of the line item

data.line_items.total_discount

number<double> | null

The total discount of the line item

data.line_items.updated_at

string<date-time> | null

The last ISO 8601 timestamp that the data was updated at

data.contact

accountingContactAllFields · object

The contact of the Expense

Show child attributes

data.contact.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.contact.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.contact.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.contact.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.contact.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.contact.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.contact.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.contact.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.contact.data_hash

string | null

The hash of the data

data.contact.name

string | null

Name of the contact

data.contact.contact_name

string | null

Name of the contact person for the contact

data.contact.contact_type

enum<string> | null

The type of contact. Values are either CUSTOMER or VENDOR

Available options:

CUSTOMER,

VENDOR

data.contact.currency_id

string | null

The ISO-4217 currency code

data.contact.tax_number

string | null

Contact’s tax number

data.contact.registration_number

string | null

Contact’s identifying number

data.contact.status

enum<string> | null

The status of the contact. Values are ACTIVE, ARCHIVED, UNKNOWN

Available options:

ACTIVE,

ARCHIVED,

UNKNOWN

data.contact.updated_at

string | null

The date the contact was last updated

data.contact.external_links

ExternalLinks · object[] | null

External links for the contact

Show child attributes

data.contact.external_links.rootfi_id

integer | null

The RootFi ID of the contact

data.contact.external_links.platform_id

string | null

The platform ID of the contact

data.contact.external_links.link

string | null

The link to the contact

data.contact.external_links.type

enum<string> | null

The type of the link.

Available options:

EMAIL,

WEBSITE

data.contact.phone_numbers

PhoneNumbers · object[] | null

Phone numbers for the contact

Show child attributes

data.contact.phone_numbers.rootfi_id

integer | null

The RootFi ID of the contact

data.contact.phone_numbers.platform_id

string | null

The platform ID of the contact

data.contact.phone_numbers.number

string | null

The number to the contact

data.contact.phone_numbers.type

enum<string> | null

The type of the link.

Available options:

MOBILE,

TELEPHONE,

FAX

data.contact.addresses

Addresses · object[] | null

Addresses for the contact

Show child attributes

data.contact.addresses.rootfi_id

integer | null

The RootFi ID of the contact

data.contact.addresses.platform_id

string | null

The platform ID of the contact

data.contact.addresses.street

string | null

The street of the address

data.contact.addresses.locality

string | null

The locality of the address

data.contact.addresses.city

string | null

The city of the address

data.contact.addresses.state

string | null

The state of the address

data.contact.addresses.pincode

string | null

The pincode of the address

data.contact.addresses.country

string | null

The country of the address

data.currency

accountingCurrencyObject · object

The currency of the Expense

Show child attributes

data.currency.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.currency.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.currency.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.currency.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.currency.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.currency.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.currency.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.currency.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.currency.data_hash

string | null

The hash of the data

data.currency.name

string | null

The name of the currency

data.currency.code

string | null

The currency code.

data.currency.symbol

string | null

The symbol that represents the currency. Not applicable for many currencies.

data.currency.is_base_currency

boolean | null

Whether the currency is the base currency for the company.

data.currency.exchange_rate

number<double> | null

The exchange rate for the currency.

data.currency.updated_at

string | null

The last ISO 8601 timestamp that the data was updated at.

data.account

accountingAccountObject · object

The account of the Expense

Show child attributes

data.account.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.account.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.account.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.account.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.account.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.account.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.account.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.account.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.account.data_hash

string | null

The hash of the data

data.account.name

string | null

Name of the account

data.account.description

string | null

Description of the account

data.account.nominal_code

string | null

The nominal code of the account

data.account.current_balance

number<double> | null

The current balance of the account

data.account.updated_at

string | null

The date the account was last updated

data.account.status

string | null

The status of the account

data.account.category

enum<string> | null

The category of the account

Available options:

ASSET,

EXPENSE,

LIABILITY,

EQUITY,

INCOME,

BANK,

UNKNOWN

data.account.sub_category

string | null

The sub category of the account

data.account.currency_id

string | null

The currency id of the account

data.account.parent_account_id

string | null

The parent account id of the account

data.account.parent_account

accountingAccountAllFields · object

The parent account of the account.

Show child attributes

data.account.parent_account.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.account.parent_account.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.account.parent_account.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.account.parent_account.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.account.parent_account.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.account.parent_account.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.account.parent_account.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.account.parent_account.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.account.parent_account.data_hash

string | null

The hash of the data

data.account.parent_account.name

string | null

Name of the account

data.account.parent_account.description

string | null

Description of the account

data.account.parent_account.nominal_code

string | null

The nominal code of the account

data.account.parent_account.current_balance

number<double> | null

The current balance of the account

data.account.parent_account.updated_at

string | null

The date the account was last updated

data.account.parent_account.status

string | null

The status of the account

data.account.parent_account.category

enum<string> | null

The category of the account

Available options:

ASSET,

EXPENSE,

LIABILITY,

EQUITY,

INCOME,

BANK,

UNKNOWN

data.account.parent_account.sub_category

string | null

The sub category of the account

data.account.parent_account.currency_id

string | null

The currency id of the account

data.account.parent_account.parent_account_id

string | null

The parent account id of the account

data.account.currency

accountingCurrencyObject · object

The currency of the account.

Show child attributes

data.account.currency.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.account.currency.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.account.currency.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.account.currency.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.account.currency.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.account.currency.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.account.currency.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.account.currency.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.account.currency.data_hash

string | null

The hash of the data

data.account.currency.name

string | null

The name of the currency

data.account.currency.code

string | null

The currency code.

data.account.currency.symbol

string | null

The symbol that represents the currency. Not applicable for many currencies.

data.account.currency.is_base_currency

boolean | null

Whether the currency is the base currency for the company.

data.account.currency.exchange_rate

number<double> | null

The exchange rate for the currency.

data.account.currency.updated_at

string | null

The last ISO 8601 timestamp that the data was updated at.

data.documents

accountingDocumentObject · object[] | null

The documents of the Expense

Show child attributes

data.documents.rootfi_id

number<double>

required

The unique ID we assign for that data's information

Example:

157

data.documents.rootfi_created_at

string<date-time>

required

The date at which RootFi first synced this data

Example:

"2024-01-22T05:07:31.465Z"

data.documents.rootfi_updated_at

string<date-time>

required

The latest date at which RootFi updated this data

Example:

"2024-01-22T05:07:31.000Z"

data.documents.rootfi_company_id

number<double>

required

The ID of the company in the accounting platform

Example:

1089

data.documents.platform_id

string

required

An unique custom RootFi ID made from platform's unique_id.

Example:

"123456"

data.documents.rootfi_deleted_at

string<date-time> | null

The date at which the data was deleted in the accounting platform

data.documents.platform_unique_id

string | null

The ID of the data in the accounting platform.

data.documents.raw_data

object

A JSON containing fields that you can directly get from the accounting platform.

data.documents.data_hash

string | null

The hash of the data

data.documents.file_name

string | null

The file name of the document

data.documents.file_type

string | null

The file type of the document

data.documents.file_size

string | null

The file size of the document

data.documents.document_type_id

string | null

The platform_id of the voucher to which the file will be linked to.

data.documents.document_type

string | null

The document type of the document

data.documents.document_uploaded

boolean | null

The document uploaded of the document

data.documents.updated_at

string | null

The updated date of the document

sync_id

string | null

The sync id of the request

Retrieve expenses Create an expense

⌘I

General

Server Side SDKs

Core API

Unified API

Create Expense

Authorizations

Body

Response