iotoms Docs

List vendors for an item

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

Returns every vendor that supplies the given item, with each vendor's price. Useful for choosing a supplier when reordering.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

itemId*string

Item code, from List items.

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/items/string/vendors' \  -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"    }  ]}