RetailHardHat Developer docs

REST API documentation

Vendors

Vendor/contractor companies that provide services

Supported operations

MethodPathDescription
GET/api/v1/vendorsList all vendors
GET/api/v1/vendors/:idGet a vendor by ID
POST/api/v1/vendorsCreate a new vendor
PATCH/api/v1/vendors/:idUpdate a vendor
DELETE/api/v1/vendors/:idDelete a vendor

Example request

Replace YOUR_API_KEY with a private key stored in your environment. Replace path parameters with records from your organization.

curl --request GET "/api/v1/vendors" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json"

Field reference

Required means required by the underlying data model, not necessarily caller-supplied. The server derives protected identity and ownership fields; endpoint validation controls which fields are accepted. Sensitive credential fields are omitted here.

FieldTypeModel requirementDescription
idstringOptionalUnique identifier (auto-generated)
namestringRequiredname
categorystringOptionalcategory
contactNamestringOptionalcontact Name
contactEmailstringOptionalcontact Email
contactPhonestringOptionalcontact Phone
addressstringOptionaladdress
citystringOptionalcity
statestringOptionalstate
zipCodestringOptionalzip Code
websitestringOptionalwebsite
notesstringOptionalnotes
statusenumOptionalstatus

Values: active, inactive, pending

createdAtdatetimeOptionalCreation timestamp (auto)
updatedAtdatetimeOptionalLast update timestamp (auto)