Get Handovers

Endpoint

GET https://integration-api.ram.syniotec.com/master-data/v1/handover-management/handovers

Authentication

Required: Authorization header with valid token

Query Parameters

Parameter	Type	Default	Description
`page`	number	1	Page number
`limit`	number	10	Items per page (max 100)
`handType`	string	-	Filter by hand type (`hand_in`, `hand_out`)
`entityId`	UUID	-	Filter by equipment or inventory ID contained in the handover
`bookingId`	UUID	-	Filter by booking ID contained in the handover
`bookingIds`	string	-	Filter by multiple booking IDs (comma-separated)

entityId, bookingId and bookingIds match a handover when any of its items matches.

See Handovers for full entity and field descriptions.

Response

Success (200):

{
  "content": [
    {
      "id": "6717a3c2e4b0f81d2c9a4e15",
      "handoverId": "SH4829105736",
      "organizationId": "0b7c3f4e-2d91-4a6b-9e8f-5c1d7a2b3e40",
      "rentalId": "a3f5c8d2-1b4e-4f7a-9c6d-2e8b5a1f7c34",
      "handType": "hand_out",
      "endCustomerType": "here",
      "status": "accepted",
      "pdfMediaId": "e2c4a6b8-3d5f-4e7a-8b9c-1d2e3f4a5b6c",
      "endDate": "2026-10-14T09:32:18.512Z",
      "giver": {
        "id": "4c2a8e6f-9b1d-4f3a-a7c5-8e2d6b4f1a93",
        "firstName": "Anna",
        "lastName": "Schmidt",
        "email": "[email protected]"
      },
      "receiver": {
        "id": "7d3b9f1e-5a2c-4e8d-b6f4-3a1c9e7d5b28",
        "firstName": "Lukas",
        "lastName": "Weber",
        "email": null
      },
      "transporter": null,
      "items": [
        {
          "entityId": "91e5f7a3-6c2b-4d8e-a1f9-4b3c7e5d2a61",
          "entityType": "equipment",
          "bookingId": "c8a2e4f6-7b9d-4c1e-9a3f-5d7b1e9c3a82"
        }
      ],
      "warehouseReturn": null,
      "createdAt": "2026-10-14T09:12:04.187Z",
      "updatedAt": "2026-10-14T09:32:18.512Z"
    }
  ],
  "total": 1
}

Error

Error Response

Example Usage

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/handover-management/handovers?page=1&limit=10&handType=hand_out" \
  -H "Authorization: Bearer YOUR_TOKEN"