iotoms Docs

List a vendor's items

GET
/api/v1/procurement/vendors/{id}/items

Returns every item this vendor supplies, with the vendor's unit cost, lead time, minimum order quantity and preferred-supplier flag.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

id*string

ID of the record (UUID).

Formatuuid

Header Parameters

X-TenantID*string

Your merchant's tenant code — the value typed in the Domain field on the iotoms login screen. See Concepts.

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when it worked, ERROR when it failed.

message*string

Short human-readable message describing the outcome, for example "Vendor created". Do not parse it.

data?array<>|

Vendor item price records.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/procurement/vendors/497f6eca-6276-4993-bfeb-53cbbbba6f08/items' \  -H 'X-TenantID: your-tenant-code'
Example Response
{  "status": "string",  "message": "string",  "data": [    {      "id": 0,      "vendorId": "e9b57fab-1850-44d4-8499-71fd15c845a0",      "itemId": "string",      "itemName": "string",      "unitCost": 0,      "leadTimeDays": 0,      "minimumOrderQty": 0,      "isPreferred": true,      "notes": "string"    }  ]}