Certificate Types

A certificate type is a lightweight category that certificates can be grouped under (e.g. "Compliance", "Safety"). These endpoints manage the types themselves.

Required scope: read:certificatetypes, write:certificatetypes.

Endpoints

GET

/api/open/v1/certificatetypes

List certificate types (paginated)

GET

/api/open/v1/certificatetypes/{id}

Get a single certificate type

POST

/api/open/v1/certificatetypes

Create a certificate type (draft by default)

PUT|PATCH

/api/open/v1/certificatetypes/{id}

Update a certificate type

DELETE

/api/open/v1/certificatetypes/{id}

Soft delete a certificate type (returns 204)

List

curl "https://customer.monotree.com/api/open/v1/certificatetypes" \
  -H "Authorization: Bearer mono_your_token_here"

Query param	Notes
`is_published`	`true` returns published types only, `false` returns drafts only. Omit for all.
`since`	ISO 8601 — filter by `created_at`.
`page`, `per_page`	Standard pagination — `per_page` max 50.

Create

curl -X POST https://customer.monotree.com/api/open/v1/certificatetypes \
  -H "Authorization: Bearer mono_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Compliance", "is_published": true }'

Request body

Field	Type	Notes
`title`	string	Required.
`is_published`	boolean	Optional. `true` publishes immediately. Defaults to `false` (draft).

PUT and PATCH accept the same fields — all optional. Setting is_published toggles the published state.

Response

{
  "data": {
    "id": 3,
    "title": "Compliance",
    "is_published": true,
    "published_at": "2026-06-01T10:00:00+00:00",
    "created_at": "2026-06-01T10:00:00+00:00",
    "updated_at": "2026-06-01T10:00:00+00:00"
  }
}