List goods receipts (tenant:trade:purchasing:read)
GET /api/trade/v1/goods-receipts
Module: Trade · operationId: listGoodsReceipts · Tag: Procurement · Auth: access token (Authorization: Bearer <accessToken>)
Pages by keyset in creation order (newest first, then id; nextCursor), a page shown newest receipt first, without lines; total counts all matches.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
poId |
query | string (uuid) | Only receipts of this purchase order. | |
limit |
query | integer | Page size; at most 500. (default 50; max 500) |
|
cursor |
query | string | The nextCursor of the previous page; omit for the first page. A cursor of another list is 400 invalid. |
Responses
- 200 Goods receipts (
application/json) - 400 Error (
application/json) - 401 No valid session or bearer token (no body).
Fields of the 200 answer:
items(array of GoodsReceipt, required): The goods receipts of the page.createdAt(string (date-time)): When the goods receipt was created.grNumber(string): Number of the goods receipt.id(string (uuid)): Id of the goods receipt.lines(array of object): Empty in lists.description(string): Description of the line.id(string (uuid)): Id of the line.poLineId(string (uuid)): Id of the purchase order line.position(integer): Position of the line.receivedQty(number): Quantity received.
note(string): Free-text note.poId(string (uuid)): Purchase order the goods were received for.poNumber(string): Number of the purchase order.receivedAt(string (date-time)): When the goods were received.status(string): Status of the goods receipt (posted). (one ofposted)
total(integer, required): Number of entries of the whole list.nextCursor(string): Pass ascursorfor the next page; absent on the last one.
Example 200 answer:
{
"items": [
{
"createdAt": "2026-11-18T10:15:00Z",
"grNumber": "WE-2026-00052",
"id": "3d6e7f8a-9b0c-4d1e-8f2a-4b5c6d7e8f52",
"lines": [],
"poId": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d68",
"poNumber": "BE-2026-00068",
"receivedAt": "2026-11-18T10:15:00Z",
"status": "posted"
},
{
"createdAt": "2026-11-14T09:30:00Z",
"grNumber": "WE-2026-00050",
"id": "3d6e7f8a-9b0c-4d1e-8f2a-4b5c6d7e8f21",
"lines": [],
"poId": "1b4c5d6e-7f8a-4b9c-8d0e-2f3a4b5c6d73",
"poNumber": "BE-2026-00073",
"receivedAt": "2026-11-14T09:30:00Z",
"status": "posted"
}
],
"nextCursor": "Y3JlYXRlZHwyMDI2LTExLTE0VDA5OjMwOjAwWnwzZDZlN2Y4YS05YjBjLTRkMWUtOGYyYS00YjVjNmQ3ZThmMjE",
"total": 11
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/goods-receipts' \
-H "Authorization: Bearer $ACCESS_TOKEN"