## 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 of `posted`)
- `total` (integer, required): Number of entries of the whole list.
- `nextCursor` (string): Pass as `cursor` for the next page; absent on the last one.

Example 200 answer:

```json
{
  "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

```bash
curl -X GET 'https://api.mbcom.cloud/api/trade/v1/goods-receipts' \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```
