---
title: "Get All Invoices"
method: GET
path: "/invoices"
tags: ["Invoices"]
---

# Get All Invoices

`GET /invoices`

## Query parameters

- `status` string
- `user_id` string

## Headers

- `x-business-id` string, required

## Response `200`

Successful Response

- CreatedInvoice[]
  - `createdByUserId` string
  - `dateIssued` string, date, required — YYYY/MM/DD
  - `invoiceNumber` integer, required
  - `clientDetails` ClientDetails, required
    - `contactId` string
    - `billingName` string, required
    - `contactName` string
    - `phone` string
    - `email` string, required — The email address(es) to send the invoice to. Max 5
    - `address` union
      - string
      - Address
        - `addressLine1` string, required
        - `addressLine2` string
        - `city` string, required
        - `zipCode` string, required
        - `state` string
        - `country` string, required
  - `paymentTerms` PaymentTerms[]
    - `name` string, required
    - `description` string
    - `days` integer, required
    - `paymentDueDate` string, date — YYYY/MM/DD
    - `discount` number
    - `penalty` number
  - `paymentInstructions` object
  - `billingPeriodStart` string, date
  - `billingPeriodEnd` string, date
  - `lineItems` union[], required
    - union
      - CreatedLineItem
        - `id` string
        - `inventoryId` string
        - `name` string, required
        - `description` string
        - `price` number, required
        - `taxRate` number
        - `metadata` object
        - `quantity` number
        - `total` number, required
        - `serviceDate` string, date — YYYY/MM/DD
        - `tags` unknown[]
          - unknown
      - LineItem
        - `name` string, required
        - `description` string
        - `price` number, required
        - `taxRate` number
        - `taxable` boolean
        - `metadata` object
        - `inventoryId` string
        - `quantity` number
        - `total` number, required
        - `serviceDate` string, date — YYYY/MM/DD
        - `tags` unknown[]
          - unknown
  - `taxRate` number, required
  - `totalTax` number, required
  - `subTotal` number, required
  - `totalDue` number, required
  - `paymentDueDate` string, date, required — YYYY/MM/DD
  - `totalDiscount` number
  - `depositAmount` number
  - `depositDate` string, date — YYYY/MM/DD
  - `parentProjectId` string
  - `recurringFrequency` 'Weekly' | 'Bi-Weekly' | 'Monthly' | 'Bi-Monthly' | 'Quarterly' — An enumeration.
  - `status` 'draft' | 'issued' | 'paid' | 'partially paid' | 'overdue' | 'expired' | 'cancelled' | 'archived' | 'uncollectible' — An enumeration.
  - `metadata` object
  - `id` string — The ID of the invoice
  - `payments` InvoicePayment[]
    - `transactionId` string, required
    - `amount` number, required
    - `date` string, date — YYYY/MM/DD
    - `metadata` object
  - `totalPaid` number
  - `totalOutstanding` number

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/slickco/apis/slick-api.md) · [All operations](https://skmtc.net/slickco/apis/slick-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slickco/slick-api/revisions/90641b73f35e/schema)