---
title: "Get a listing certificate"
method: GET
path: "/api/v1/certificates"
tags: ["Certificates"]
---

# Get a listing certificate

`GET /api/v1/certificates`

## Query parameters

- `certificate[listing_id]` integer, required

## Response `200`

certificate found

- object
  - `certificate` object, required
    - `id` integer, required — Certificate ID
    - `listing_id` integer, required — Corresponding listing ID
    - `name` string, required — Certificate name
    - `active` boolean, required — Whether the certificate is enabled
    - `template` string, required — HTML template used to generate issued certificates
    - `pdf_settings` object, required — Extra params for PDF generation
      - `orientation` string — 'Landscape' or 'Portrait'
    - `created_at` string, required — Creation timestamp (ISO 8601)
    - `updated_at` string, required — Last-updated timestamp (ISO 8601)
    - `days_to_expire` integer, nullable — Days until an issued certificate expires
    - `expires_at` string, nullable — Fixed datetime when issued certificates expire

---

[API](https://skmtc.net/instructure/apis/canvas-catalog-api.md) · [All operations](https://skmtc.net/instructure/apis/canvas-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instructure/canvas-catalog-api/revisions/78578cd3e37a/schema)