ConnectCloud Developers

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:

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

View as Markdown · Interactive reference · OpenAPI