Material Suppliers

Get all material suppliers

get

The API gives the ability to get all existing suppliers in the company.

Authorizations

x-api-keystringRequired

Query parameters

company_namestringOptional

The name of the company that supplies materials.

emailstringOptional

The supplier’s e-mail address.

phonestringOptional

The supplier’s phone number.

skipnumberOptional

takenumberOptional

Header parameters

x-tenant-idstring · uuidOptional

Tenant id (uuid v4)

Responses

200Success

application/json

429

Returned when the rate limit is exceeded

get/api/v1/public/material-suppliers

GET /api/v1/public/material-suppliers HTTP/1.1
Host: api-stage.hesh.tech
x-api-key: YOUR_API_KEY
Accept: */*

{
  "meta": {
    "total": 1,
    "lastPage": 1,
    "currentPage": 1,
    "perPage": 1,
    "prev": 1,
    "next": 1
  },
  "data": [
    {
      "id": "b86fa12a-76fc-46f5-8a3e-bf39e7be4c4e",
      "company_name": "ABC Materials Co.",
      "country": "United States",
      "first_name": "John",
      "last_name": "Smith",
      "phone": "[phone]",
      "email": "[e-mail]",
      "created_at": "2025-01-23T17:01:31.692Z",
      "updated_at": "2025-01-24T10:30:45.123Z"
    }
  ]
}

Create material supplier

post

The API gives the ability to create a new supplier.

Authorizations

x-api-keystringRequired

Header parameters

x-tenant-idstring · uuidOptional

Tenant id (uuid v4)

Body

company_namestringRequired

Company name of the material supplier

Example: ABC Materials Co.

countrystringOptional

Country where the supplier is located

Example: United States

first_namestringOptional

First name of the supplier contact person

Example: John

last_namestringOptional

Last name of the supplier contact person

Example: Smith

phonestringOptional

Phone number of the supplier

Example: [phone]

emailstringOptional

Email address of the supplier

Example: [e-mail]

Responses

201Success

application/json

idstring · uuidRequired

Unique identifier of the material supplier

Example: b86fa12a-76fc-46f5-8a3e-bf39e7be4c4e

company_namestringRequired

Company name of the material supplier

Example: ABC Materials Co.

countrystring · nullableOptional

Country where the supplier is located

Example: United States

first_namestring · nullableOptional

First name of the supplier contact person

Example: John

last_namestring · nullableOptional

Last name of the supplier contact person

Example: Smith

phonestring · nullableOptional

Phone number of the supplier

Example: [phone]

emailstring · nullableOptional

Email address of the supplier

Example: [e-mail]

created_atstring · date-timeRequired

Timestamp when the supplier was created

Example: 2025-01-23T17:01:31.692Z

updated_atstring · date-time · nullableOptional

Timestamp when the supplier was last updated

Example: 2025-01-24T10:30:45.123Z

429

Returned when the rate limit is exceeded

post/api/v1/public/material-suppliers

POST /api/v1/public/material-suppliers HTTP/1.1
Host: api-stage.hesh.tech
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 163

{
  "company_name": "ABC Materials Co.",
  "country": "United States",
  "first_name": "John",
  "last_name": "Smith",
  "phone": "[phone]",
  "email": "[e-mail]"
}

{
  "id": "b86fa12a-76fc-46f5-8a3e-bf39e7be4c4e",
  "company_name": "ABC Materials Co.",
  "country": "United States",
  "first_name": "John",
  "last_name": "Smith",
  "phone": "[phone]",
  "email": "[e-mail]",
  "created_at": "2025-01-23T17:01:31.692Z",
  "updated_at": "2025-01-24T10:30:45.123Z"
}

Update material supplier

patch

The API gives the ability to update an existing supplier's information.

Authorizations

x-api-keystringRequired

Path parameters

idstringRequired

Header parameters

x-tenant-idstring · uuidOptional

Tenant id (uuid v4)

Body

company_namestringOptional

Company name of the material supplier

Example: XYZ Materials Inc.

countrystringOptional

Country where the supplier is located

Example: Canada

first_namestringOptional

First name of the supplier contact person

Example: Jane

last_namestringOptional

Last name of the supplier contact person

Example: Doe

phonestringOptional

Phone number of the supplier

Example: [phone]

emailstringOptional

Email address of the supplier

Example: [e-mail]

Responses

200Success

application/json

messagestringRequired

Message returned from API confirming the operation

Example: The operation was done successfully

429

Returned when the rate limit is exceeded

patch/api/v1/public/material-suppliers/{id}

PATCH /api/v1/public/material-suppliers/{id} HTTP/1.1
Host: api-stage.hesh.tech
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "company_name": "XYZ Materials Inc.",
  "country": "Canada",
  "first_name": "Jane",
  "last_name": "Doe",
  "phone": "[phone]",
  "email": "[e-mail]"
}

{
  "message": "The operation was done successfully"
}