> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bills

> Track what you owe vendors and pay it from Slash.

A bill is an invoice your business owes a vendor. Record bills from your AP
system, pay them from Slash, and Slash keeps each bill's status and balance up
to date as the money moves.

<CardGroup cols={3}>
  <Card title="Managing bills" icon="file-invoice" href="/docs/v2/bills/creating-and-ingesting">
    Create, edit, void and find bills.
  </Card>

  <Card title="Receive bills by email" icon="inbox" href="/docs/v2/bills/inbox">
    Let vendors email invoices in.
  </Card>

  <Card title="Pay bills" icon="money-bill-transfer" href="/docs/v2/bills/paying-bills">
    Pay with a transfer.
  </Card>
</CardGroup>

## What's on a bill

| Field | What it is |
| - | - |
| `vendorContactId` | The vendor, a [contact](/docs/v2/concepts/contacts-and-destinations) on your legal entity, usually one with `recipientType: vendor`. |
| `destinationId` | The bank account the vendor wants to be paid to. |
| `lineItems` | What the invoice charges for. Slash adds up the total. |
| `documentIds` | The invoice files, uploaded as [documents](/docs/v2/concepts/documents) with purpose `bill_invoice`. |
| `payments` | The transfers and transactions that pay the bill down. |
| `amounts.outstanding` | What is still owed. It drops when a payment settles. |

Only the line items are required, so you can record a bill before you know
who the vendor is or how they want to be paid.

## Status

You never set a bill's `status`. Slash works it out from the bill's payments
and updates it whenever one of them changes.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/slash-9da6c7e7/iQrNr-l_pA8n5N2d/images/charts/bill-lifecycle.light.svg?fit=max&auto=format&n=iQrNr-l_pA8n5N2d&q=85&s=a12a242b3acf841f9d38f17bd222b3c4" alt="Bill lifecycle" width="1275" height="954" data-path="images/charts/bill-lifecycle.light.svg" />

  <img className="hidden dark:block" src="https://mintcdn.com/slash-9da6c7e7/iQrNr-l_pA8n5N2d/images/charts/bill-lifecycle.dark.svg?fit=max&auto=format&n=iQrNr-l_pA8n5N2d&q=85&s=145a003ba605a930c55ad9dad2ee6d08" alt="Bill lifecycle" width="1275" height="954" data-path="images/charts/bill-lifecycle.dark.svg" />
</Frame>

| Status | Meaning |
| - | - |
| `draft` | Not paid yet. Everything can be edited. |
| `pending_approval` | A payment is waiting for an approver. |
| `rejected` | The approver rejected the payment. Edit the bill or pay it again. |
| `scheduled` | A payment is set to go out on a future date. |
| `payment_pending` | A payment is on its way. |
| `partially_paid` | Settled payments cover part of the total. |
| `paid` | Settled payments cover the total. |
| `payment_failed` | The latest payment failed or was returned. Pay it again or void it. |

Amounts and line items can only change while a bill is `draft` or `rejected`.
Everything else, such as the due date, notes and documents, can be edited at
any time.

## Where bills come from

`source` records how a bill was created:

* `api`: created with [Create a bill](/api-reference/bills/create).
* `manual`: entered in the Slash dashboard.
* `email`: sent to your [bill inbox](/docs/v2/bills/inbox).
* `carrier_account`: pulled from a connected carrier portal. These are read-only.

All of them appear in the same list, with the same fields.

## Aging report

Add `includeSummary=true` to [List bills](/api-reference/bills/list) to get
totals and an accounts payable aging report (current, 1–30, 31–60, 61–90 and
over 90 days past due) for every bill that matches your filters.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.