---
title: "Get payables list from accounting system"
method: GET
path: "/accounting/payables"
tags: ["Accounting data pull"]
---

# Get payables list from accounting system

`GET /accounting/payables`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/accounting/payables`
- Auth: HTTP bearer

Returns a list of accounts payable invoices (bills) that exist in the entity's accounting system. This requires that an accounting connection has been previously established. Refer to the [Accounting integration guide](https://docs.monite.com/accounting/integration/index) for details.

This endpoint only provides read-only access to the accounting system's data but does not pull those payables into Monite. You can use it to review the data in the accounting system and find out which of those payables already exist or do not exist in Monite.

Data is actual as of the date and time of the last accounting synchronization, which is specified by the `last_pull` value in the response from `GET /accounting_connections/{connection_id}`. To make sure you are accessing the most up-to-date accounting data, you can use `POST /accounting_connections/{connection_id}/sync` to trigger on-demand synchronization before getting the list of payables.

## Query parameters

- `limit` integer
- `offset` integer

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Response `200`

Successful Response

- AccountingPayableList
  - `data` AccountingPayable[], required
    - `id` string, required: An internal identifier of the payable in the accounting system.
    - `amount_due` number, double: Remaining amount to be paid.
    - `currency` string: ISO-4217 currency code of the payable.
    - `currency_rate` number, double: Rate to convert the total amount of the transaction into the entity's base currency at the time of the transaction.
    - `due_date` union: The payable's due date.
      - string, date-time
      - string
    - `invoice_number` string: Invoice number of the payable.
    - `lines` AccountingLineItem[]
      - `description` string: The name or description of the product or service being invoiced.
      - `discount_amount` number, double: Discount amount for this line item (if any).
      - `discount_percentage` number, double: Discount percentage for this line item (if any).
      - `ledger_account_id` string: ID of the ledger account associated with this line item. You can use `GET /ledger_accounts/{ledger_account_id}` to get further details about this ledger account.
      - `quantity` number, double: The quantity of the product or service.
      - `tax_rate_ref` AccountingRefObject
        - `id` string: An internal ID of the tax rate in the accounting system.
      - `unit_amount` number, double: The cost per unit of the product or service.
    - `memo` string: Any additional information or business notes about the payable.
    - `posted_date` string, date: Date when the payable was added to the accounting service. This may differ from the payable creation date.
    - `purchase_order_refs` AccountingPurchaseOrderRef[]: A list of purchase orders linked to the payable, if any.
      - `id` string, required: An internal ID of the purchase order in the accounting system.
      - `name` string: Reference number of the purchase order.
    - `status` string, required: The status of the payable in the accounting system. Possible values: `open`, `draft`, `partially_paid`, `paid`, `unknown`, `void`.
    - `subtotal` number, double: Amount payable, including discounts but excluding VAT/taxes.
    - `tax_amount` number, double: Total VAT or tax amount.
    - `total_amount` number, double, required: The total amount payable, including discounts and VAT/taxes.
    - `vendor_ref` AccountingVendorRefObject
      - `id` string, required: A unique identifier of the vendor in the accounting system.
      - `name` string: Vendor name in the accounting system.

## Other responses

- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)