---
title: "List invoices"
method: GET
path: "/vendor/invoices"
tags: ["Vendor — Invoices"]
---

# List invoices

`GET /vendor/invoices`

## Request

- Base URL: `https://app.zobrx.com/api/v1`
- URL: `https://app.zobrx.com/api/v1/vendor/invoices`
- Auth: HTTP bearer

Track invoice status (any source) incl. the Amazon submission result. Scope `vendor:invoices:read`.

## Query parameters

- `intakeStatus` 'received' | 'mapped' | 'validated' | 'submitted' | 'failed' | 'rejected'
- `poNumber` string

## Headers

- `X-Zobrx-Integration-Id` string

## Response `200`

Invoices.

- object
  - `items` Invoice[]
    - `invoiceId` string
    - `externalInvoiceId` string, nullable
    - `poNumber` string, nullable
    - `source` 'zobrx-generated' | 'erp-api' | 'erp-pull' | 'upload'
    - `intakeStatus` 'received' | 'mapped' | 'validated' | 'submitted' | 'failed' | 'rejected'
    - `status` 'submitted' | 'failed'
    - `validationErrors` string[]
    - `invoiceTotal` Money: Integer minor units (paise) + currency.
      - `minor` integer
      - `currency` string
    - `amazonTransactionId` string, nullable
    - `amazonProcessingStatus` 'Processing' | 'Success' | 'Failure', nullable: Confirmed outcome from the Amazon Vendor Transaction Status API. null until polled (typically minutes after submit). Success = Amazon accepted; Failure = rejected (see amazonProcessingErrors).
    - `amazonProcessingErrors` object[]
      - `code` string, nullable
      - `message` string, nullable
    - `submittedAt` string, date-time, nullable

## Other responses

- `401`: Missing/invalid API key.

---

[API](https://skmtc.dev/zobrx/apis/zobrx-api.md) · [All operations](https://skmtc.dev/zobrx/apis/zobrx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zobrx/apis/zobrx-api/revisions/af90eac50273?raw)