Vendor categories

Get a vendor category

Fetches one vendor category by id. A category belonging to another company is reported as not found. Requires the vendor_categories:read permission.

GET

https://services.magicdoor.com/maintenance/company-portal/vendors/categories/{vendorCategoryId}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

vendorCategoryIdstringrequired

The category to fetch. A Snowflake id, sent as a decimal string.

example: 1829110384726355968

Response

200 · The category.

idstringrequired

The category.

namestringrequired

The category name shown to staff, for example "Electrical".

401 · The request carried no valid access token.

403 · The token is not a property manager token, or it lacks the `vendor_categories:read` permission.

404 · No such category, or it belongs to another company.

Request

curl --request GET \
  --url 'https://services.magicdoor.com/maintenance/company-portal/vendors/categories/1829110384726355968' \
  --header 'Authorization: Bearer <token>'

Response

{
  "id": "1829110384726355968",
  "name": "Electrical"
}