Read a certificate holder

Request

Returns one issue of a certificate to a user: who holds it, the label printed on it, and when it was issued.

The holder's user record is always included under relations. meta.entities lists the records the certificate was issued in connection with - an event, shift, role offer or training module - whose details can be printed on the certificate. Any of them may be null.

The record must belong to the certificate in the URL; a mismatched pair returns a 404.

Security

default

Path

certificate_idintegerrequired

The ID of the certificate.

idintegerrequired

The ID of the certificate holder record.

Rosterfy-Platformstring

curl -i -X GET \
  'https://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/certificate/{certificate_id}/user/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Rosterfy-Platform: admin'

Responses

Bodyapplication/json

objectobject

niceArray of any

relationsobject

permissionsobject

Response

{
  "object": {
    "id": 1,
    "certificate_id": 1,
    "user_id": 23453479,
    "label": null,
    "meta": { … },
    "created_at": "2026-10-20T00:11:41.000000Z",
    "updated_at": "2026-10-20T00:11:41.000000Z"
  },
  "nice": [],
  "relations": {
    "user": { … }
  },
  "permissions": {
    "read": true,
    "update": true,
    "delete": true
  }
}