---
title: "Get certificate"
method: GET
path: "/v2/certificates/{id}"
tags: ["Certificates"]
---

# Get certificate

`GET /v2/certificates/{id}`

Retrieve a single certificate by ID.

**Required OAuth scope:** `certificates:read`

## Path parameters

- `id` string, required

## Response `200`

OK

- CertificateDetailResponse — JSON:API single-resource response for GET /v2/certificates/{id}/.
  - `data` CertificateResource, required — JSON:API resource object for a certificate.
    - `type` string — Always "certificates".
    - `id` string, required — Opaque certificate ID.
    - `attributes` CertificateAttributes, required — Attributes of a certificate resource.
      - `code` string, required — Unique code identifying the certificate.
      - `issued_at` string, date-time, required — Timestamp the certificate was issued.
      - `expires_at` string, date-time, nullable — Timestamp the certificate expires, or null when it does not expire.
      - `score_as_percent` integer, nullable — Student's course score as a percentage, or null when not recorded.
    - `relationships` CertificateRelationships, required — Relationships of a certificate resource.
      - `student` StudentRelationship, required — To-one linkage to a student; ``data`` is null when there is no student.
        - `data` StudentIdentifier — JSON:API resource identifier for a student.
          - `type` string — Always "students".
          - `id` string, required — Opaque student ID.
      - `course` CourseRelationship, required — To-one linkage to the course being published.
        - `data` CourseIdentifier, required — JSON:API resource identifier for a course.
          - `type` 'courses', required — Must be "courses".
          - `id` string, required — Opaque course id.
    - `links` object, nullable — Self link.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/skilljar/apis/skilljar-api-v2.md) · [All operations](https://skmtc.net/skilljar/apis/skilljar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skilljar/skilljar-api-v2/revisions/f8025de20169/schema)