---
title: "Retrieve catalog-matched invoice lines as receiver/quantity export"
method: GET
path: "/invoices/receiver-export"
tags: ["invoices"]
---

# Retrieve catalog-matched invoice lines as receiver/quantity export

`GET /invoices/receiver-export`

Returns a paginated list of exported invoices with their catalog-matched line items. Only invoices in exported state, from vendors with item validation enabled, are returned. Fringe catalog entries and unmatched lines are excluded. If an invoice has zero qualifying lines after filtering it is omitted entirely.

## Query parameters

- `ottimate_company_id` integer, required
- `ottimate_location_id` integer, required
- `exported_after` string, date-time
- `exported_after_utc` string, date-time
- `exported_before` string, date-time
- `exported_before_utc` string, date-time
- `vendor_id` string
- `page` integer
- `limit` integer

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Paginated list of receiver export invoices

- InvoicesGetInvoicesReceiverExportResponse200
  - `version` string — API version
  - `count` integer — Total number of invoices matching the query
  - `page` integer — Current page number
  - `limit` integer — Number of results per page
  - `results` InvoicesReceiverExportGetResponsesContentApplicationJsonSchemaResultsItems[]
    - `ottimate_invoice_id` string — Unique invoice identifier in Ottimate
    - `ottimate_company_id` integer — Ottimate company identifier this invoice belongs to
    - `ottimate_location_id` integer — Ottimate location identifier this invoice was received against
    - `invoice_number` string, nullable — Invoice number as it appears on the vendor document
    - `vendor_name` string — Name of the vendor in Ottimate
    - `vendor_id` string, nullable — Vendor identifier for the inventory system (e.g. LOCSMS). Sourced from the vendor configuration on the location, not the invoice vendor object. Identical for every line on the invoice
    - `invoice_date` string, date, nullable — Date the invoice was issued by the vendor
    - `exported_at` string, date-time, nullable — Timestamp when the invoice was exported from Ottimate to the ERP system
    - `exported_at_utc` string, date-time, nullable — UTC equivalent of exported_at. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z".
    - `receiver_status` string — 'success' for all returned records. Only invoices that are exported and have at least one catalog-matched non-fringe line are returned, so all results are by definition in a valid receivable state
    - `receiver_lines` InvoicesReceiverExportGetResponsesContentApplicationJsonSchemaResultsItemsReceiverLinesItems[] — Catalog-matched line items from this invoice. Unmatched lines and fringe catalog lines are excluded. Invoices with zero qualifying lines are omitted entirely.
      - `catalog_unique_key` string, nullable — Unique key identifying the matched catalog entry, suitable for cross-referencing with your catalog system
      - `upc` string — Universal Product Code from the catalog entry, zero-padded to 13 digits (EAN-13 / GTIN-13). Empty string if no UPC is on file
      - `description` string — Item name sourced from the matched catalog entry
      - `uom` string — Catalog-normalized unit of measure (e.g. CS, EA, LB). Always reflects the catalog UOM, not the raw invoice UOM
      - `case_pack` number, double — Number of units per case as defined in the catalog entry
      - `quantity_received` number, double — UOM-normalized received quantity. For unit-matched lines billed per unit (UNIT_PRICE), the raw quantity is divided by case_pack to convert to cases. For all other matches the raw invoice quantity is returned as-is
      - `unit_price` number, double — Absolute unit price from the invoice line item
      - `extended_price` number, double — Absolute extended (total) price for this line item
      - `pack_size` string, nullable — Human-readable pack size description from the catalog entry (e.g. '25 LB', '6 CT')
      - `ottimate_catalog_id` string — Ottimate-internal catalog entry identifier for audit and lookup. Not recognized by LOCSMS or servicers

## Other responses

- `400` — Bad request - missing or invalid required parameters
- `403` — Token not authorized for the requested company/location

---

[API](https://skmtc.dev/ottimate/apis/api-reference.md) · [All operations](https://skmtc.dev/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ottimate/api-reference/revisions/ba91ff4c6969/schema)