# List certifications

URL: /en/docs/api/v1/certifications/get
Last Updated: 2026-07-30T21:15:44.918Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/certifications

**List certifications**

Retrieve all certifications (compliance category documents) for the current tenant with badge and file URLs.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Query parameters:**

| Name | Type | Required | Description |
|---|---|---|---|
| `search` | string | No | Search certifications by title or description |
| `state` | enum: valid \| expired | No | Filter by certification state |
| `featured` | boolean | No | Filter by featured status |
| `template` | string (uuid) | No | Filter by template ID |

**Responses:**

- `200` - List of certifications for the current tenant
  - `certifications` (array of Certification (object))
    - `id` (string (uuid)): Unique certification identifier
    - `title` (string): Certification title
    - `slug` (string): URL-friendly certification identifier
    - `description` (string): Certification description
    - `description_markdown` (string): Markdown-formatted description
    - `category` (object): Always "Compliance" category for certifications
      - `id` (string (uuid))
      - `title` (string)
    - `issue_date` (string (date)): Certificate issue date in YYYY-MM-DD format
    - `expiry_date` (string (date)): Certificate expiry date in YYYY-MM-DD format
    - `validity_months` (integer): Certificate validity period in months
    - `state` (enum: valid | expired): Current certification state
    - `featured` (boolean): Whether certification is featured
    - `show_validity_period_on_card` (boolean): Show validity period on card display
    - `badge` (string): URL to certification badge image
    - `file` (string): URL to certification document file
    - `date_created` (string (date-time)): Creation timestamp

  Example (Successful response):
  
  ```json
  {
  "certifications": [
    {
      "id": "cert-123",
      "title": "ISO 27001 Certificate",
      "slug": "iso-27001",
      "description": "Information Security Management System",
      "state": "valid",
      "featured": true,
      "issue_date": "2025-01-01",
      "expiry_date": "2026-01-01",
      "validity_months": 12,
      "badge": "https://directus.example.com/assets/badge-456",
      "file": "https://directus.example.com/assets/file-789",
      "category": {
        "title": "Compliance"
      }
    }
  ]
}
  ```
- `401` - Unauthorized
- `500` - Internal server error - Failed to load certifications

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/certifications" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json"
```