Manufacturers

Manage manufacturers via the API

The Manufacturers API allows you to manage equipment and software manufacturers.

List Manufacturers

cURL

curl -X GET "https://your-domain.com/api/v1/manufacturers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

limit · integer · default: "50"

Number of results to return

offset · integer · default: "0"

Offset for pagination

search · string

Search string to filter results

sort · string · default: "created_at"

Column to sort by. Allowed values: id, name, url, support_url, support_email, support_phone, assets_count, licenses_count, consumables_count, accessories_count

order · string · default: "desc"

Sort order: asc or desc

deleted · string

Set to “true” to show only deleted manufacturers

total · integer

Total number of manufacturers

rows · array

Array of manufacturer objects

Show Manufacturer Object

id · integer

Manufacturer ID

name · string

Manufacturer name

url · string

Manufacturer website URL

support_url · string

Support website URL

warranty_lookup_url · string

Warranty lookup URL

support_email · string

Support email address

support_phone · string

Support phone number

assets_count · integer

Number of assets from this manufacturer

licenses_count · integer

Number of licenses from this manufacturer

consumables_count · integer

Number of consumables from this manufacturer

accessories_count · integer

Number of accessories from this manufacturer

notes · string

Manufacturer notes

image · string

Manufacturer logo URL

Get Manufacturer by ID

cURL

curl -X GET "https://your-domain.com/api/v1/manufacturers/{manufacturer_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

manufacturer_id · integer · required

The manufacturer ID

Create Manufacturer

cURL

curl -X POST "https://your-domain.com/api/v1/manufacturers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dell Inc.",
    "url": "https://www.dell.com",
    "support_url": "https://www.dell.com/support",
    "support_email": "[e-mail]",
    "support_phone": "1-800-624-9896"
  }'

name · string · required

Manufacturer name

url · string

Manufacturer website URL

support_url · string

Support website URL

warranty_lookup_url · string

Warranty lookup URL (use as placeholder for serial number)

support_email · string

Support email address

support_phone · string

Support phone number

notes · string

Manufacturer notes

image · string

Base64 encoded image or image file

Update Manufacturer

cURL

curl -X PATCH "https://your-domain.com/api/v1/manufacturers/{manufacturer_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Manufacturer Name",
    "support_phone": "1-800-555-0199"
  }'

manufacturer_id · integer · required

The manufacturer ID

Delete Manufacturer

cURL

curl -X DELETE "https://your-domain.com/api/v1/manufacturers/{manufacturer_id}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

manufacturer_id · integer · required

The manufacturer ID

A manufacturer cannot be deleted if it has associated assets, licenses, accessories, consumables, or components. You must first reassign or delete those items.

Restore Deleted Manufacturer

cURL

curl -X POST "https://your-domain.com/api/v1/manufacturers/{manufacturer_id}/restore" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

manufacturer_id · integer · required

The deleted manufacturer ID

Restores a soft-deleted manufacturer.