List bills

GET

bills

List bills

curl --request GET \
  --url https://api.slash.com/v2/bills \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/bills', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/bills"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/bills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "bill_2rj4l7hmrrrcv",
      "status": "draft",
      "source": "manual",
      "currency": "USD",
      "amounts": {
        "total": {
          "amount": 123,
          "currency": "<string>"
        },
        "tax": {
          "amount": 123,
          "currency": "<string>"
        },
        "discount": {
          "amount": 123,
          "currency": "<string>"
        },
        "outstanding": {
          "amount": 123,
          "currency": "<string>"
        }
      },
      "lineItems": [
        {
          "id": "bill_line_item_2rj4l7hmrrrcv",
          "name": "Hosting",
          "quantity": 1,
          "unitAmount": {
            "amount": 123,
            "currency": "<string>"
          },
          "total": {
            "amount": 123,
            "currency": "<string>"
          }
        }
      ],
      "documentIds": [
        "st_2rj4l7hmrrrcv"
      ],
      "payments": [
        {
          "id": "bill_payment_2rj4l7hmrrrcv",
          "status": "pending",
          "detailedStatus": "pending",
          "amount": {
            "amount": 123,
            "currency": "<string>"
          },
          "createdAt": "2023-11-07T05:31:56Z",
          "transferId": "transfer_intent_2rj4l7hmrrrcv",
          "transactionId": "agg_tx_2rj4l7hmrrrcv"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "vendorContactId": "le_c_2rj4l7hmrrrcv",
      "destinationId": "le_contact_destination_2rj4l7hmrrrcv",
      "ownerUserId": "u_2rj4l7hmrrrcv",
      "invoiceNumber": "INV-4471",
      "invoiceDate": "2026-09-01",
      "dueDate": "2026-10-01",
      "notes": "<string>"
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "<string>"
  },
  "summary": {
    "asOf": "2026-09-19",
    "currencies": [
      {
        "currency": "USD",
        "count": 12,
        "total": {
          "amount": 123,
          "currency": "<string>"
        },
        "outstanding": {
          "amount": 123,
          "currency": "<string>"
        },
        "aging": {
          "current": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "1_30": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "31_60": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "61_90": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "over_90": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          }
        }
      }
    ]
  }
}

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Query Parameters

cursor

string

The opaque metadata.nextCursor value from the previous page. It carries that page's filters, page size and ordering, so pass it on its own; see Pagination.

limit

integer

Number of items per page, from 1 to 100. The page size is carried inside metadata.nextCursor, so later pages keep the same size unless limit is passed again to change it.

Required range: 1 <= x <= 100

status

enum<string>[]

Return only bills in these statuses.

Available options:

draft,

pending_approval,

rejected,

scheduled,

payment_pending,

paid,

payment_failed,

partially_paid

vendorContactId

string

Return only bills for one vendor contact.

invoiceNumber

string

Return only bills with exactly this invoice number. Invoice numbers aren't unique, so combine it with vendorContactId to find one vendor's invoice.

Maximum string length: 255

ownerUserId

string

Return only bills owned by one user.

source

enum<string>

Return only bills that entered Slash this way.

Available options:

manual,

email,

carrier_account,

api

overdue

boolean

true returns only unpaid bills whose due date has passed; false excludes them.

hasDocument

boolean

true returns only bills with at least one document attached; false only bills without one.

dueFrom

string<date>

Return only bills due on or after this YYYY-MM-DD date.

dueTo

string<date>

Return only bills due on or before this YYYY-MM-DD date.

invoiceDateFrom

string<date>

Return only bills invoiced on or after this YYYY-MM-DD date.

invoiceDateTo

string<date>

Return only bills invoiced on or before this YYYY-MM-DD date.

amountMin

integer

Return only bills whose total is at least this many minor units.

Required range: x >= 0

amountMax

integer

Return only bills whose total is at most this many minor units.

Required range: x >= 0

includeSummary

boolean

true adds a summary with the count, total, outstanding balance, and aging buckets of every bill the filters match, not just the current page, one entry per currency.

Response

A page of bills.

items

Bill · object[]

required

Hide child attributes

items.id

string

required

Bill id with the bill_ prefix.

Example:

"bill_2rj4l7hmrrrcv"

items.status

enum<string>

required

Derived from the bill's payments. draft until a payment exists; pending_approval while a payment awaits approval; rejected when the latest approval was rejected; scheduled when a payment is scheduled; payment_pending while a payment is in flight; partially_paid when settled payments cover part of the total; paid when they cover all of it; payment_failed when the latest payment failed or was returned.

Available options:

draft,

pending_approval,

rejected,

scheduled,

payment_pending,

paid,

payment_failed,

partially_paid

items.source

enum<string>

required

How the bill entered Slash. api for bills created through this API, manual for the dashboard, email for the accounts-payable inbox, carrier_account for bills pulled from a connected carrier portal. Carrier bills are read-only over the API.

Available options:

manual,

email,

carrier_account,

api

items.currency

string

required

Uppercase ISO 4217 currency code shared by every amount on the bill.

Pattern: ^[A-Z]{3}$

Example:

"USD"

items.amounts

object

required

Every amount is in currency, in minor units.

Hide child attributes

items.amounts.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.amounts.total.amount

integer

required

Amount in the currency's minor units.

items.amounts.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.amounts.tax

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.amounts.tax.amount

integer

required

Amount in the currency's minor units.

items.amounts.tax.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.amounts.discount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.amounts.discount.amount

integer

required

Amount in the currency's minor units.

items.amounts.discount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.amounts.outstanding

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.amounts.outstanding.amount

integer

required

Amount in the currency's minor units.

items.amounts.outstanding.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.lineItems

BillLineItem · object[]

required

Line items in display order.

Hide child attributes

items.lineItems.id

string

required

Line item id with the bill_line_item_ prefix.

Example:

"bill_line_item_2rj4l7hmrrrcv"

items.lineItems.name

string

required

What the line is for, as printed on the invoice.

Example:

"Hosting"

items.lineItems.quantity

number

required

Number of units. Fractional quantities are allowed.

Example:

1

items.lineItems.unitAmount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.lineItems.unitAmount.amount

integer

required

Amount in the currency's minor units.

items.lineItems.unitAmount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.lineItems.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.lineItems.total.amount

integer

required

Amount in the currency's minor units.

items.lineItems.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.documentIds

string[]

required

Documents attached to the bill, readable at GET /v2/documents/{documentId}.

items.payments

BillPayment · object[]

required

Payments linked to the bill, oldest first.

Hide child attributes

items.payments.id

string

required

Payment link id with the bill_payment_ prefix. Unlink the payment with DELETE /v2/bills/{billId}/payments/{paymentId}.

Example:

"bill_payment_2rj4l7hmrrrcv"

items.payments.status

enum<string>

required

Coarse transaction state.

Available options:

pending,

posted,

failed

items.payments.detailedStatus

enum<string>

required

Exact transaction lifecycle state across every category.

Available options:

pending,

pending_destination,

pending_approval,

in_review,

scheduled,

canceled,

failed,

settled,

declined,

refund,

reversed,

returned,

dispute

items.payments.amount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

items.payments.amount.amount

integer

required

Amount in the currency's minor units.

items.payments.amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

items.payments.createdAt

string<date-time>

required

When the payment was linked to the bill.

items.payments.transferId

string

Id of the transfer that pays the bill, with the transfer_intent_ prefix, readable at GET /v2/transfers/{transferId}. Absent for payments that are not yet a transfer (a scheduled payment whose transfer has not been constructed) or that were made outside the transfer rails.

Example:

"transfer_intent_2rj4l7hmrrrcv"

items.payments.transactionId

string

Id of the transaction that moved the money, with the agg_tx_ prefix, readable at GET /v2/transactions/{transactionId}. For a card purchase it's the card transaction. Absent when the payment's only transactions are ones the transactions API doesn't return, such as a rejected or canceled approval request.

Example:

"agg_tx_2rj4l7hmrrrcv"

items.createdAt

string<date-time>

required

When the bill was created.

items.vendorContactId

string

The vendor contact, readable at GET /v2/contacts/{contactId}.

Example:

"le_c_2rj4l7hmrrrcv"

items.destinationId

string

The destination the bill is expected to be paid to, readable at GET /v2/destinations/{destinationId}.

Example:

"le_contact_destination_2rj4l7hmrrrcv"

items.ownerUserId

string

The user responsible for the bill. Absent for bills that arrived by email and have not been assigned.

Example:

"u_2rj4l7hmrrrcv"

items.invoiceNumber

string

The vendor's invoice number.

Example:

"INV-4471"

items.invoiceDate

string<date>

Invoice date as YYYY-MM-DD.

Example:

"2026-09-01"

items.dueDate

string<date>

Due date as YYYY-MM-DD.

Example:

"2026-10-01"

items.notes

string

Free-text notes visible to your organization.

metadata

PaginationMetadata · object

required

Hide child attributes

metadata.count

integer

required

Number of items in this page.

Required range: x >= 0

metadata.nextCursor

string

Opaque cursor for the next page. Omitted on the final page.

summary

BillSummary · object

Totals over every bill the list filters match, one entry per currency. Present only when includeSummary=true. The aging buckets are the accounts-payable aging report: outstanding balances grouped by whole days past due as of asOf. Bills with nothing outstanding are counted in count and total but not aged.

Hide child attributes

summary.asOf

string<date>

required

The UTC date the aging buckets were computed against, as YYYY-MM-DD.

Example:

"2026-09-19"

summary.currencies

object[]

required

One entry per currency with at least one matching bill, ordered by currency code.

Hide child attributes

summary.currencies.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

Example:

"USD"

summary.currencies.count

integer

required

Number of matching bills in this currency.

Example:

12

summary.currencies.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.outstanding

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.outstanding.amount

integer

required

Amount in the currency's minor units.

summary.currencies.outstanding.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.aging

object

required

Outstanding balances by days past due. A bill without a due date is current.

Hide child attributes

summary.currencies.aging.current

BillAgingBucket · object

required

Hide child attributes

summary.currencies.aging.current.count

integer

required

Number of bills with an outstanding balance in the bucket.

Example:

3

summary.currencies.aging.current.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.aging.current.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.aging.current.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.aging.1_30

BillAgingBucket · object

required

Hide child attributes

summary.currencies.aging.1_30.count

integer

required

Number of bills with an outstanding balance in the bucket.

Example:

3

summary.currencies.aging.1_30.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.aging.1_30.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.aging.1_30.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.aging.31_60

BillAgingBucket · object

required

Hide child attributes

summary.currencies.aging.31_60.count

integer

required

Number of bills with an outstanding balance in the bucket.

Example:

3

summary.currencies.aging.31_60.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.aging.31_60.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.aging.31_60.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.aging.61_90

BillAgingBucket · object

required

Hide child attributes

summary.currencies.aging.61_90.count

integer

required

Number of bills with an outstanding balance in the bucket.

Example:

3

summary.currencies.aging.61_90.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.aging.61_90.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.aging.61_90.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

summary.currencies.aging.over_90

BillAgingBucket · object

required

Hide child attributes

summary.currencies.aging.over_90.count

integer

required

Number of bills with an outstanding balance in the bucket.

Example:

3

summary.currencies.aging.over_90.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

summary.currencies.aging.over_90.total.amount

integer

required

Amount in the currency's minor units.

summary.currencies.aging.over_90.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

⌘I

List bills

curl --request GET \
  --url https://api.slash.com/v2/bills \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>'

const options = {
  method: 'GET',
  headers: {'x-legal-entity': '<x-legal-entity>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.slash.com/v2/bills', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/bills"

headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/bills"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "items": [
    {
      "id": "bill_2rj4l7hmrrrcv",
      "status": "draft",
      "source": "manual",
      "currency": "USD",
      "amounts": {
        "total": {
          "amount": 123,
          "currency": "<string>"
        },
        "tax": {
          "amount": 123,
          "currency": "<string>"
        },
        "discount": {
          "amount": 123,
          "currency": "<string>"
        },
        "outstanding": {
          "amount": 123,
          "currency": "<string>"
        }
      },
      "lineItems": [
        {
          "id": "bill_line_item_2rj4l7hmrrrcv",
          "name": "Hosting",
          "quantity": 1,
          "unitAmount": {
            "amount": 123,
            "currency": "<string>"
          },
          "total": {
            "amount": 123,
            "currency": "<string>"
          }
        }
      ],
      "documentIds": [
        "st_2rj4l7hmrrrcv"
      ],
      "payments": [
        {
          "id": "bill_payment_2rj4l7hmrrrcv",
          "status": "pending",
          "detailedStatus": "pending",
          "amount": {
            "amount": 123,
            "currency": "<string>"
          },
          "createdAt": "2023-11-07T05:31:56Z",
          "transferId": "transfer_intent_2rj4l7hmrrrcv",
          "transactionId": "agg_tx_2rj4l7hmrrrcv"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "vendorContactId": "le_c_2rj4l7hmrrrcv",
      "destinationId": "le_contact_destination_2rj4l7hmrrrcv",
      "ownerUserId": "u_2rj4l7hmrrrcv",
      "invoiceNumber": "INV-4471",
      "invoiceDate": "2026-09-01",
      "dueDate": "2026-10-01",
      "notes": "<string>"
    }
  ],
  "metadata": {
    "count": 1,
    "nextCursor": "<string>"
  },
  "summary": {
    "asOf": "2026-09-19",
    "currencies": [
      {
        "currency": "USD",
        "count": 12,
        "total": {
          "amount": 123,
          "currency": "<string>"
        },
        "outstanding": {
          "amount": 123,
          "currency": "<string>"
        },
        "aging": {
          "current": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "1_30": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "31_60": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "61_90": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          },
          "over_90": {
            "count": 3,
            "total": {
              "amount": 123,
              "currency": "<string>"
            }
          }
        }
      }
    ]
  }
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Documents

Bills

Accounting

Authorizations

Headers

Query Parameters

Response