---
title: "Get all your invoices"
method: GET
path: "/v2/user/customer/invoices"
tags: ["Customer - Invoices"]
---

# Get all your invoices

`GET /v2/user/customer/invoices`

## Headers

- `If-None-Match` string

## Response `200`

Get all invoices of a customer

- InvoiceList
  - `links` InvoiceListLinks, required
    - `self` LinksGetInvoicesLink, required
      - `label` string — The label corresponding to the link. This label is automatically translated based on the Accept-Language http header.
      - `docUrl` string, uri — The documentation related to this operation.
      - `description` string — The description of the link
      - `href` string, required — Indicate the relative uri for this link
      - `operationId` string — The operationId to call.
      - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE' | 'PUT' | 'HEAD' — Indicate the http method to use on this link
      - `parameters` object
      - `urlTemplated` boolean — indicates whether the href is templated or not
      - `allRequiredParamsProvided` boolean — indicates whether all required params have been provided
      - `allOptionalParamsProvided` boolean — indicates whether all optionals params have been provided
      - `info` BeezUPCommonInfoSummaries
        - `successes` BeezUPCommonSuccessSummary[]
          - `successCode` string
          - `successMessage` string
          - `successArguments` object
          - `propertyName` string
          - `propertyValue` string
          - `objectName` string
        - `errors` BeezUPCommonErrorSummary[]
          - `utcDate` string, date-time
          - `errorGuid` string, uuid
          - `errorCode` string
          - `errorMessage` string
          - `technicalErrorMessage` string
          - `exceptionDetail` BeezUPCommonExceptionDetail
            - `helpLink` string
            - `message` string
            - `stackTrace` string
            - `type` string
          - `errorArguments` object
          - `propertyName` string
          - `propertyValue` string
          - `objectName` string
          - `source` string
        - `warnings` BeezUPCommonWarningSummary[]
          - `technicalErrorMessage` string
          - `warningMessage` string
          - `warningCode` string
          - `warningArguments` object
        - `informations` BeezUPCommonInfoSummary[]
          - `informationCode` string
          - `informationMessage` string
          - `informationArguments` object
          - `propertyName` string
          - `propertyValue` string
          - `objectName` string
  - `invoices` Invoice[], required
    - `invoiceDate` string, date, required — The invoice date
    - `contractId` string, guid, required — Your contract identifier
    - `invoiceNumber` string, required — Your invoice number
    - `amount` number, double, required — The amount of your invoice
    - `amountToBePaid` number, double, required — The remaining amount to be paid for this invoice
    - `currencyCode` string, required — The currency code <a href="https://en.wikipedia.org/wiki/ISO_4217">(ISO 4217)</a>
    - `paymentStatus` 'Paid' | 'NotPaid' | 'PartiallyPaid' | 'Loss', required — The payment status
    - `dueDate` string, date, required
    - `invoiceUrl` string, uri — The url of the invoice document

## Other responses

- `304` — The ETag sent in the http header If-None-Match did not change. So you are up to date !
- `default` — Occurs when something goes wrong

---

[API](https://skmtc.net/beezup/apis/beezup-merchant-api.md) · [All operations](https://skmtc.net/beezup/apis/beezup-merchant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beezup/beezup-merchant-api/revisions/557b7feddf8a/schema)