# Docs

- API Reference: API endpoints, parameters and examples

  - **Getting Started**
  - [Introduction](/docs/api-reference): Introduction to the Certifier API
  - [Quickstart](/docs/api-reference/quickstart): Authenticate and make your first request to the Certifier API
  - [MCP Server](/docs/api-reference/mcp-server): Connect MCP-compatible clients to Certifier with OAuth

  - **Core Concepts**
  - [Pagination](/docs/api-reference/pagination): Understanding how pagination works in the Certifier API
  - [Rate Limits](/docs/api-reference/rate-limits): Understanding request limits and how to handle them
  - [Versioning](/docs/api-reference/versioning): How API versioning works in the Certifier API
  - [Error Handling](/docs/api-reference/error-handling): Understanding error responses in the Certifier API
  - [Changelog](/docs/api-reference/changelog): API version history and breaking changes
  - [Webhooks](/docs/api-reference/webhooks): Receive real-time event notifications from Certifier

  - **API Reference**
  - Credentials: Endpoints for creating, managing, issuing, and sending credentials
    - [List credentials](/docs/api-reference/credentials/list-credentials): Use this endpoint to list credentials.
    - [Get a credential](/docs/api-reference/credentials/get-a-credential): Use this endpoint to get a specific credential.
    - [Get credential design templates](/docs/api-reference/credentials/get-credential-design-templates): Use this endpoint to list the ordered design templates used by a credential and their available previews. Preview URLs are immutable and versioned by a digest (hash) derived from the design template's last update timestamp and the resolved values of all rendered credential attributes.
    - [Create a credential](/docs/api-reference/credentials/create-a-credential): Use this endpoint to create a new credential. The credential will be created with status `draft`.
    - [Create, issue, and send a credential](/docs/api-reference/credentials/create-issue-and-send-a-credential): Use this endpoint to issue a credential. It is an all-in-one solution that simultaneously creates, issues, and sends a credential. This endpoint covers most of the basic scenarios.
    - [Issue a credential](/docs/api-reference/credentials/issue-a-credential): Use this endpoint to issue a draft credential and change the status from `draft` to `issued`. You can only issue credentials with `status = "draft"`.
    - [Search credentials](/docs/api-reference/credentials/search-credentials): 1. [Introduction](#introduction) * [Example Request](#example-request) 2. [Filtering](#filtering) * [Logical Operators](#logical-operators) * [AND](#and) * [OR](#or) * [NOT](#not) * [Field Types & Comparison Operators](#field-types--comparison-operators) * [String Fields](#string-fields) * [UUID Fields](#uuid-fields) * [Enum Fields](#enum-fields) * [Date Fields (YYYY-MM-DD)](#date-fields-yyyy-mm-dd) * [DateTime Fields (ISO 8601)](#datetime-fields-iso-8601) * [Handling Null Values](#handling-null-values) * [In Operator Limitation for Null Values](#in-operator-limitation-for-null-values) 3. [Credentials Searchable Fields](#credentials-searchable-fields) * [Core Fields](#core-fields) * [Recipient Fields](#recipient-fields) * [Temporal Fields](#temporal-fields) 4. [Sorting](#sorting) * [Credentials Sortable Properties](#credentials-sortable-properties) 5. [Pagination](#pagination) 6. [Complete Example](#complete-example) 7. [Tips and Advanced Use](#tips-and-advanced-use) * [Implicit AND](#implicit-and) * [Top-Level Logical Operators](#top-level-logical-operators) * [Filter Condition Objects](#filter-condition-objects) * [Comparison Operator Expressions](#comparison-operator-expressions)
    - [Send a credential](/docs/api-reference/credentials/send-a-credential): Use this endpoint to send a published credential to a recipient. You can only send credentials with `status = "issued"`.
    - [Update a credential](/docs/api-reference/credentials/update-a-credential): Use this endpoint to update a credential.
    - [Delete a credential](/docs/api-reference/credentials/delete-a-credential): Use this endpoint to permanently delete a credential. This cannot be undone.
  - Credential Interactions: Endpoints for tracking and managing credential interaction events
    - [List credential interactions](/docs/api-reference/credential-interactions/list-credential-interactions): Returns a list of credential interactions, optionally filtered by credential ID.
    - [Create a credential interaction](/docs/api-reference/credential-interactions/create-a-credential-interaction): Creates a new credential interaction event.
  - Credential Templates: Endpoints for managing credential templates (groups)
    - [List credential templates](/docs/api-reference/credential-templates/list-credential-templates): Use this endpoint to list credential templates (groups).
    - [Get a credential template](/docs/api-reference/credential-templates/get-a-credential-template): Use this endpoint to get a specific credential template (group).
    - [Create a credential template](/docs/api-reference/credential-templates/create-a-credential-template): Use this endpoint to create a credential template (group).
    - [Update a credential template](/docs/api-reference/credential-templates/update-a-credential-template): Updates the specified credential template (group) by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
    - [Delete a credential template](/docs/api-reference/credential-templates/delete-a-credential-template): Permanently deletes a credential template (group). This cannot be undone.
  - Design Templates: Endpoints for managing certificate and badge design templates
    - [Get a design template](/docs/api-reference/design-templates/get-a-design-template): Retrieves the details of an existing design template by its ID.
    - [List design templates](/docs/api-reference/design-templates/list-design-templates): Returns a list of all design templates (certificates and badges) available in your workspace.