---
title: "Retrieve List of Receipts"
method: GET
path: "/v1/integrations/receipts-list"
tags: ["Receivings"]
---

# Retrieve List of Receipts

`GET /v1/integrations/receipts-list`

## Query parameters

- `page` integer
- `pageSize` integer
- `sortOrder` 'DESC' | 'ASC'
- `asn` string, nullable
- `warehouseId` integer, nullable
- `completedAt` string, date-time

## Response `200`

Success

- object
  - `paginator` ShipMonkApiOutputPaginatorOutput, required
    - `total` integer, required
    - `pages` integer, required
    - `page` integer, required
  - `status` integer, required
  - `data` ShipMonkOMSReceivingApiResourcePublicApiReceivingReceiptOutput[], required
    - `receipt_id` integer, required — Unique numeric identifier of the receipt.
    - `receiving_id` integer, required — Unique numeric identifier of the receiving (the inbound shipment) the receipt was generated for.
    - `warehouse` string, required — Short warehouse code (e.g., CA1) where the goods were received.
    - `receiving_key` string, nullable, required — Caller-provided reference key of the associated receiving (inbound shipment), or null if none was supplied.
    - `asn` string, required — Advance Ship Notice (ASN) number of the associated receiving (inbound shipment).
    - `receipt_created_at` string, date-time, required — ISO 8601 timestamp indicating when the receipt was created.
    - `receipt_completed_at` string, date-time, required — ISO 8601 timestamp indicating when the receipt was completed.
    - `items` ShipMonkOMSReceivingApiResourcePublicApiReceivingReceiptItemOutput[], required — List of received items aggregated by product.
      - `product` FulfillmentIntegrationsBundleCrateReturnOrReceivingItemProductPublicApiOutput, required
        - `id` integer, required — Server-assigned numeric identifier of the product.
        - `sku` string, required — Stock Keeping Unit (SKU), the client's unique product code.
        - `name` string, required — Human-readable name of the product.
      - `received_quantity` integer, required — Total number of units received for this product across all detail entries.
      - `receiving_details` ShipMonkOMSReceivingApiResourcePublicApiReceivingReceiptItemDetailOutput[], required — Per-batch breakdown of how many units were received, when, and against which lot.
        - `line_key` string, nullable, required — Caller-supplied line key of the receiving line this detail belongs to; null if no key was provided.
        - `received_quantity` integer, required — Number of units received in this detail entry.
        - `received_at` string, date-time, nullable, required — Timestamp when this batch was received at the warehouse, in ISO 8601 format. Null if not yet received.
        - `lot` ShipMonkOMSReceivingApiResourcePublicApiLotControlOutput, required
          - `lot_number` string, nullable, required — Lot number assigned to the product batch, or null if the lot is identified only by expiration date.
          - `expiration_date` string, date, nullable, required — Lot expiration date in ISO 8601 format (YYYY-MM-DD), or null if not applicable.
    - `receiving_lines` ShipMonkOMSReceivingApiResourcePublicApiReceivingReceiptLineQuantityOutput[], required — Received quantities broken down by receiving line and lot.
      - `line_key` string, nullable, required — Caller-supplied line key of the receiving line this quantity belongs to; null if no key was provided.
      - `product` FulfillmentIntegrationsBundleCrateReturnOrReceivingItemProductPublicApiOutput, required
        - `id` integer, required — Server-assigned numeric identifier of the product.
        - `sku` string, required — Stock Keeping Unit (SKU), the client's unique product code.
        - `name` string, required — Human-readable name of the product.
      - `received_quantity` integer, required — Number of units received for this receiving line.
      - `lot` ShipMonkOMSReceivingApiResourcePublicApiLotControlOutput, required
        - `lot_number` string, nullable, required — Lot number assigned to the product batch, or null if the lot is identified only by expiration date.
        - `expiration_date` string, date, nullable, required — Lot expiration date in ISO 8601 format (YYYY-MM-DD), or null if not applicable.
    - `custom_data` FulfillmentCommonBundleApiResourceIntegrationDataOutput[], required — Arbitrary key-value metadata copied from the associated receiving.
      - `name` string, required — Key of the custom data entry.
      - `value` object, required — Value of the custom data entry; may be any JSON-serializable structure.

---

[API](https://skmtc.net/shipmonk/apis/shipmonk-api.md) · [All operations](https://skmtc.net/shipmonk/apis/shipmonk-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipmonk/shipmonk-api/versions/59ec2621d98d/schema)