# Manage customer invoices

> Find your customers' invoices, read their lines and payments, and mark an invoice paid when the money reached you another way.

Source: https://www.coritan.com/docs/organizations/billing/invoices/

In the dashboard:

- /dashboard/organizations/…/billing/invoices: https://www.coritan.com/dashboard/organizations

The **Invoices** section of the **Billing** tab lists every invoice your organization has raised for its customers, newest first. Use it to see what is owed, to read an invoice's lines, and to record a payment that reached you outside Coritan, such as a bank transfer.

## Before you begin

You need the owner, admin or billing role.

## Find an invoice

1. In the [dashboard](https://www.coritan.com/dashboard/organizations), open the organization, then **Billing**. The tab opens on **Invoices**.
2. Choose a status in the list above the table: **Unpaid or overdue**, **Unpaid**, **Overdue**, **Paid**, **Cancelled** or **Refunded**. The toolbar also shows what your open invoices still owe, per currency.
3. To see one customer's invoices, open the customer on the **Customers** tab and select **View invoices**. Clear the customer filter with the cross next to its name.
4. Select an invoice to open it.

The invoice shows its **Status**, **Customer**, **Subtotal**, **Tax**, **Total**, what has been **Paid**, the **Due** date, when it was paid and issued, and its **Line items**.

## Invoice statuses

| Status | Meaning |
| --- | --- |
| `draft` | Not yet issued. |
| `unpaid` | Issued and waiting for payment. |
| `overdue` | Past its due date and still unpaid. |
| `paid` | Settled in full. |
| `cancelled` | Withdrawn. Nothing is owed. |
| `refunded` | Paid, then refunded. |

## Mark an invoice paid

Mark an invoice paid when the customer paid you another way, for example by bank transfer or in cash. Card and gateway payments settle their invoices on their own.

1. Open the invoice and select **Mark as paid**.
2. Confirm with **Mark as paid**.

The invoice becomes `paid` for its full amount, and its services renew as they would after any payment. Coritan did not receive this money, so it is not part of a [payout](/docs/organizations/billing/payouts/).

## Troubleshooting

`Invoice already paid`
: The invoice is settled. Nothing more is needed.

The **Billing** tab says it is not open to your role
: Ask an owner or admin to give you the billing role.

## Related

- [Organization billing](/docs/organizations/billing/)
- [Track your payouts](/docs/organizations/billing/payouts/)
- [Handle billing in the staff console](/docs/organizations/staff-console/billing/)

## With the API

List invoices, newest first. `status_filter` takes a status or `open` for unpaid and overdue together, `customer_id` narrows the list to one customer, and `limit` and `offset` page it. With `with_total=true` the answer is `{items, total, limit, offset, counts, outstanding}`, where `outstanding` is what the open invoices owe in each currency.

```bash
curl "https://api.coritan.com/api/v1/orgs/acme/invoices?status_filter=open&with_total=true" \
  -H "Authorization: Bearer $CORITAN_TOKEN"
```

Read one invoice, with its line items, with `GET /invoices/{invoice_id}`. Mark it paid with an empty `POST`:

```bash
curl -X POST https://api.coritan.com/api/v1/orgs/acme/invoices/3051/mark-paid \
  -H "Authorization: Bearer $CORITAN_TOKEN"
```

```json
{"message": "Invoice marked as paid"}
```

## API

- `GET /api/v1/orgs/{org_slug}/invoices`: The org's invoices, newest first, each naming its customer (https://www.coritan.com/docs/api/reference/organizations/billing-payouts/invoices/#op-get-api-v1-orgs-org-slug-invoices)
- `GET /api/v1/orgs/{org_slug}/invoices/{invoice_id}`: Get invoice (https://www.coritan.com/docs/api/reference/organizations/billing-payouts/invoices/#op-get-api-v1-orgs-org-slug-invoices-invoice-id)
- `POST /api/v1/orgs/{org_slug}/invoices/{invoice_id}/mark-paid`: Mark invoice paid (https://www.coritan.com/docs/api/reference/organizations/billing-payouts/invoices/#op-post-api-v1-orgs-org-slug-invoices-invoice-id-mark-paid)