---
title: "Get a list of receipts for purchase and sales orders"
method: POST
path: "/api/receiving/receipts/list"
tags: ["Receiving Receipt"]
---

# Get a list of receipts for purchase and sales orders

`POST /api/receiving/receipts/list`

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending' — Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- ReceivingRequestListFindParameters — Parameters used for searching/finding receipts.
  - `salesOrderIds` string[], nullable — Include receipts for specific sales order ids
  - `purchaseOrderIds` string[], nullable — Include receipts for specific purchase order ids
  - `receiptIds` string[], nullable — Include receipts with specific ids
  - `includeReceiptLines` boolean — If set to true, receipt line items will be included in the results
  - `externalReference` CommonExternalReferenceFindDto — Search parameter for identifier record(s) via their external identifiers.
    - `key` string, required — Specifies the group name (key) that this external reference originates from (e.g. an external application name)
    - `type` string, nullable — Arbitrary sub-key that can be used to qualify the value
    - `externalId` string, nullable — The external identifier
  - `receivedDateFrom` string, date-time, nullable — Inclusive lower bound on the receipt's effective received date, which is its received-date override when one is set and its recorded received date otherwise. A whole day in the shop's timezone; any time of day supplied is ignored.
  - `receivedDateTo` string, date-time, nullable — Inclusive upper bound on that same effective received date. A whole day in the shop's timezone; any time of day supplied is ignored.

## Response `200`

List of receipts

- ReceivingReceiptDto[]
  - `id` string, required — Unique id associated to this entity.
  - `receivedBy` string, nullable — Id of the user who received the item(s)
  - `number` number, double, nullable — Number
  - `date` string, date-time, nullable — Received date
  - `dateOriginal` string, date-time, nullable — Original received date
  - `dateOverride` string, date-time, nullable — Override received date
  - `accountingHeldUtc` string, date-time, nullable — Set while the receipt's accounting events are withheld because it contains material held for incoming inspection (tenant invoice timing = after-inspection). Held receipts are excluded from the receipt list until their inspections resolve; cleared when the deferred events fire.
  - `orderType` 'purchaseOrder' | 'salesOrder' — Order type enum
  - `orderId` string, nullable — Id of parent order to which this receipt belongs
  - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this receipt object.
  - `lines` ReceivingLineItemReceiptLineItemDto[] — Receipt Line item data.
    - `id` string, required — Unique id associated to this entity.
    - `lineItemId` string, required — Id of the purchase order line item corresponding to this update
    - `fullyReceived` boolean, required — Indicates whether the entire quantity of this line item have been received
    - `rolledBack` boolean, required — Indicates whether this update is active.
    - `quantityReceived` number, double, nullable — Quantity of the associated item that has been received on this update in the specified unit of measure (non-cumulative)
    - `unitOfMeasureMultiplier` number, double — If the receipt has a different unit of measure than the item is stored in fulcrum, you would use this multiplier with the QuantityReceived to get the amount you received into Fulcrum.
    - `convertedQuantityReceived` number, double — Quantity of the associated item that has been received in Fulcrum's unit of measure
    - `externalReferences` object, nullable — Arbitrary key-value-pair like data that can be used to later on search for this line item.
    - `unitPrice` number, double, nullable — Price of the purchase order line received against, per Fulcrum's unit of measure, so it multiplies directly with `convertedQuantityReceived`. Null means there is no price, not a price of zero. Supplied only by the receipts list endpoint.
    - `lineItemType` 'part' | 'outsideProcessing' | 'tax' | 'discount' | 'fee' | 'vendorCredit' — Purchase order line item type
  - `customFields` object, nullable — Custom fields that have been defined on this entity.
  - `invoiceNumber` string, nullable — The vendor invoice invoice number associated to the receipt.

## Changes

- **2026-09-22** `ad309c11f954` — 12 info
  - added the new optional request property `receivedDateFrom` (media type: application/json-patch+json)
  - added the new optional request property `receivedDateFrom` (media type: application/json)
  - added the new optional request property `receivedDateFrom` (media type: text/json)
  - added the new optional request property `receivedDateFrom` (media type: application/*+json)
  - …8 more
- **2026-08-08** `1b5649cff14a` — 2 info
  - added the optional property `items/accountingHeldUtc` to the response with the `200` status (media type: application/json)
  - added the optional property `items/accountingHeldUtc` to the response with the `200` status (media type: application/problem+json)

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/receiving/receipts/list/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/e584a13d530a?raw)