Certificates

List certificates

Changed on

List the organization's certificates, one row per issued certificate.

Required OAuth scope: certificates:read

get/v2/certificates/

Request

Query parameters

filter[domains]string nullable

Comma-separated domain names; matches any listed domain. Unknown names match nothing.

filter[status]'active' | 'expired' | 'all'

Expiry-state filter values for GET /v2/certificates.

Filter by expiry state: active (unexpired), expired, or all. Defaults to all.

filter[issued_gte]string date-time nullable

Return only certificates issued at or after this ISO 8601 timestamp.

filter[issued_lte]string date-time nullable

Return only certificates issued at or before this ISO 8601 timestamp.

filter[student.id]string nullable

Return only certificates for the student with this opaque id. Unknown ids match nothing.

filter[course.id]string nullable

Return only certificates for the course with this opaque id. Unknown ids match nothing.

page[size]integer

Maximum number of records to return.

page[cursor]string nullable

Opaque cursor from the previous page's links.next.

Response

OK

metaobject nullable

Pagination metadata, e.g. {"page_size": 25}.

includedobject[] nullable

Related resources requested via ?include=. Absent when no include was requested.

Changes

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added to the response property anyOf list for the response status

    • info

      removed subschema #1 from the response property anyOf list for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status

    • info

      media type application/json was changed to a more specific media type application/vnd.api+json for the response status