Developers
Certificates

List a user's certificates

GET/users/{user_id}/certificates

Returns the certificates issued to the user, including revoked certificates. Deleted certificates are not included.

The collection can be filtered by product, status, and issue date, and is paginated with a cursor.

The fields object, which contains the document, address, and custom field values recorded at issuance, is included only when the credential has the users.read_personal permission.

Authorization

AuthorizationBearer <token>

Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.

In: header

Path Parameters

user_id*string

Query Parameters

limit?integer
Range1 <= value <= 200
cursor?string
sort?string

Value in

  • "id"
  • "-id"
product_id?string
status?string

Value in

  • "valid"
  • "revoked"
issued_after?string
Formatdate-time
issued_before?string
Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/users/string/certificates"
{  "data": [    {      "code": "string",      "deleted": true,      "fields": {},      "id": "string",      "issued_at": "2019-08-24T14:15:22Z",      "number": {        "instance": 0,        "product": 0      },      "object": "certificate",      "pdf_url": "string",      "product_id": "string",      "reissue": true,      "revision": "string",      "revoked": {        "at": "2019-08-24T14:15:22Z",        "by": {          "id": "string",          "kind": "admin"        },        "reason": "string"      },      "status": "valid",      "superseded_by_certificate_id": "string",      "supersedes_certificate_id": "string",      "user_id": "string",      "validation_url": "string"    }  ],  "page": {    "limit": 1,    "next_cursor": "string",    "prev_cursor": "string"  }}

Preview a certificate template POST

Renders a sample certificate from the product's current certificate template, using placeholder data. A preview is not an issued certificate: it does not appear in certificate listings or reports and cannot be verified through public validation. The response does not include a `file_id`; use `pdf_url` to access the rendered PDF. Templates of replicated products cannot be previewed.

Issue a certificate POST

Issues a certificate to the user for the specified product. If the user already holds a valid certificate for the product, the existing certificate is returned instead of a new one being issued. To reissue a certificate, set `supersedes_certificate_id` to the certificate being replaced. Reissuing requires the `certificates.reissue` permission in addition to `certificates.create`, and the replaced certificate is revoked with the reason `reissued`.