Get Distributor

Returns the details of a single distributor.

Required license

This endpoint requires the Stock management add-on.

Request

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

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

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

Response

Success (200 OK)

{
  "data": {
    "id": "a7b8c9d0-e1f2-3456-abcd-456789012345",
    "name": "Sanitätshaus Muster GmbH",
    "contactPerson": "Max Mustermann",
    "street": "Musterstraße 1",
    "zip": "1010",
    "city": "Wien",
    "country": "Österreich",
    "telCode": "+43",
    "tel": "1 2345678",
    "email": "kontakt@muster-sanitaet.at",
    "description": null,
    "color": "#df3a7f",
    "deleted": false
  }
}

Note: A deleted distributor still returns 200 — deleted is true then.

Response fields

See List Distributors 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/distributors/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	Distributor not found