Maintenance request categories

Get a maintenance request category

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

GET

https://services.magicdoor.com/maintenance/company-portal/maintenance-requests/categories/{maintenanceRequestCategoryId}

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

maintenanceRequestCategoryIdstringrequired

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

example: 1830472847398404096

Response

200 · The category.

idstringrequired

The category.

companyIdstringrequired

The company that owns the category.

namestringrequired

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

descriptionstring

A longer explanation of what belongs in the category. Absent when none was set.

createdstring · date-timerequired

When the category was created, in the company's timezone and without an offset.

updatedstring · date-timerequired

When the category was last changed, in the company's timezone and without an offset.

401 · The request carried no valid access token.

403 · The token is not a property manager token, or it lacks the `maintenance_request_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/maintenance-requests/categories/1830472847398404096' \
  --header 'Authorization: Bearer <token>'

Response

{
  "id": "1830472847398404096",
  "companyId": "1798203847291043840",
  "name": "Plumbing",
  "description": "Leaks, blockages, water heaters and fixtures.",
  "created": "2026-01-14T09:22:10",
  "updated": "2026-03-02T16:41:55"
}