---
title: "Search Certificates"
method: GET
path: "/v1/certificate/"
tags: ["Certificates"]
---

# Search Certificates

`GET /v1/certificate/`

Search for certificates that match the provided search terms.

Keywords are search for in the _certificate name_, _certificate type_ and _certification provider_ fields.

Additional explicit filters are also supported

## Query parameters

- `query` string, nullable
- `skip` integer, nullable
- `limit` integer, nullable
- `sort_direction` 'asc' | 'desc' — Direction to sort the `sort_column` - ascending or descending.
- `date_start` string, date-time, nullable
- `date_cut_off` string, date-time, nullable
- `sort_column` 'updated_at' | 'created_at' | 'id' — Which column to sort on
- `name` string, nullable
- `certification_type` string, nullable
- `company_certification_type_id` integer, nullable
- `user_id` integer, nullable
- `offline` boolean, nullable
- `archived` boolean, nullable
- `approved` boolean, nullable
- `subcontractor_id` integer, nullable
- `expired` boolean, nullable
- `expiry_date_from` string, date-time, nullable
- `expiry_date_to` string, date-time, nullable
- `provider_id` integer, nullable
- `provider_name` string, nullable
- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable

## Response `200`

Successful Response

- ApiGenericListResponseCertificateSearchModel
  - `error` boolean — A boolean error indicator.
  - `message` string, nullable — Optional message.
  - `data` CertificateSearchModel[], nullable — The response data for any given request.
    - `id` integer, required — The certification identifier
    - `type` string, nullable — The name of the certificate
    - `userId` integer, required — The identifier of the user this certificate belongs to
    - `companyCertificationType` string, nullable — The type of certificate, assigned by the company; the company_certification_type_id field is the ID of the certificate type.
    - `companyCertificationTypeId` integer, nullable — The identifier of the type of certificate, this field is company specific.
    - `expiryDate` string, date-time, nullable — The certificate's expiry date, if one was provided.
    - `issueDate` string, date-time, nullable — The certificate's issue date, if one was provided.
    - `approved` boolean, nullable — Determines if the certificate has been approved by a company administrator.
    - `offline` boolean, nullable — Determines if offline mode is enabled, which means that mobile applications will automatically download the certificate on app login.
    - `provider` string, nullable — The provider of the certification, assigned by the company; the provider_id field is the ID of the provider.
    - `providerId` integer, nullable — The identifier of the provider of the certification, this field is company specific.
    - `userName` string, nullable — The full name of the user who holds this certificate.

## Other responses

- `400` — Business Logic Error
- `403` — Permission Error
- `404` — Records Not Found
- `409` — Integrity Error or Data Conflict
- `422` — Validation Error

---

[API](https://skmtc.dev/salussafety/apis/salus-developer-api.md) · [All operations](https://skmtc.dev/salussafety/apis/salus-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/salussafety/salus-developer-api/revisions/ef065f44da25/schema)