List certificates

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

Required OAuth scope: certificates:read

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}.

linksobject nullable

Pagination links, e.g. {"self": "...", "next": "...", "prev": null}.

has_moreboolean required

Whether additional pages exist after this one.

next_cursorstring nullable

Opaque cursor to pass as page[cursor] for the next page; null on the last page.

includedobject[] nullable

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