Get Purchase Order

Returns the details of a single purchase order.

Required license

This endpoint requires the Stock management add-on.

Request

GET /api/oauth/v2/resource/wares/purchases/{uuid}

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string (UUID)	Yes	Unique ID of the purchase order

Response

Success (200 OK)

{
  "data": {
    "id": "e5f6a7b8-c9d0-1234-efab-234567890123",
    "amount": 50,
    "notice": "Nachbestellung Q3",
    "createdAt": "2026-08-10T08:30:00+02:00",
    "updatedAt": "2026-08-10T08:30:00+02:00",
    "createdBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "updatedBy": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "ware": "c3d4e5f6-a7b8-9012-cdef-012345678901"
  }
}

Note: A completed purchase order is deleted and no longer exists — this endpoint then returns 404, not 200 with a status. See List Purchase Orders for full sync details.

Response fields

See List Purchase Orders for the full field reference — the data object here has the same fields as one entry of data[] there.

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/wares/purchases/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope wares not present, or Stock management add-on not licensed
404	not_found	Purchase order not found, already completed, or not permitted for the related ware