Company logoTrust Center Documentation
API v1 Reference/Certifications

List certifications

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

GET
/api/v1/certifications
AuthorizationBearer <token>

In: header

Query Parameters

search?string

Search certifications by title or description

state?string

Filter by certification state

Value in"valid" | "pending" | "expired" | "inactive"
featured?boolean

Filter by featured status

template?string

Filter by template ID

Formatuuid

Response Body

fetch("https://app.orbiqhq.com/api/v1/certifications?search=string&state=valid&featured=true&template=497f6eca-6276-4993-bfeb-53cbbbba6f08")

{
  "certifications": [
    {
      "id": "cert-123",
      "title": "ISO 27001 Certificate",
      "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"
      }
    }
  ]
}
Empty
Empty

How is this guide?