Certn API Documentation

Certn API DocumentationThis document helps you get started with Certn's API and provides an overview of the concepts you need to understand to interact with the API.Getting Started

Introduction

Quickstart

Authentication

Webhooks

IntroductionIntroduction.QuickstartQuickstart.Guides

Check FinderCheck Finder.GlossaryGlossary.Case LifecycleCase Lifecycle.Ordering a CaseOrdering a Case.ATS IntegrationsATS Integrations.Error HandlingError Handling.PaginationPagination.Legacy API MigrationLegacy API Migration.Cases

Cases List

Cases Retrieve

Cases Cancel

Cases Generate Report

Cases Supplementary Files Retrieve

Cases Supplementary Information Retrieve

Cases Order

Cases Order Package

Cases Report Files Retrieve

Cases ListCases List.Cases RetrieveCases Retrieve.Cases CancelCases Cancel.Cases Generate ReportCases Generate Report.Cases Supplementary Files RetrieveCases Supplementary Files Retrieve.Cases Supplementary Information RetrieveCases Supplementary Information Retrieve.Cases OrderCases Order.Cases Order PackageCases Order Package.Cases Report Files RetrieveCases Report Files Retrieve.Events

Events List

Events ListEvents List.Tags

Tags List

Tags Create

Tags ListTags List.Tags CreateTags Create.Groups

Groups List

Groups Retrieve

Groups Deactivate

Groups List Bundles Retrieve

Groups Create

Groups ListGroups List.Groups RetrieveGroups Retrieve.Groups DeactivateGroups Deactivate.Groups List Bundles RetrieveGroups List Bundles Retrieve.Groups CreateGroups Create.Packages

Packages ListPackages List.Packages ActivatePackages Activate.Packages CreatePackages Create.Packages DeactivatePackages Deactivate.Files

Files List

Files Retrieve

Files Content Retrieve

Files Upload

Files ListFiles List.Files RetrieveFiles Retrieve.Files Content RetrieveFiles Content Retrieve.Files UploadFiles Upload.Invoices

Invoices List

Invoices Retrieve

Invoices ListInvoices List.Invoices RetrieveInvoices Retrieve.Users

Users List

Users Retrieve

Users ListUsers List.Users RetrieveUsers Retrieve.Questionnaires

Questionnaires List

Questionnaires ListQuestionnaires List.Templates

Templates Credential Verification List

Templates Criminal Record List

Templates Employment Verification List

Templates Credential Verification ListTemplates Credential Verification List.Templates Criminal Record ListTemplates Criminal Record List.Templates Employment Verification ListTemplates Employment Verification List.Available Background ChecksCertn offers a wide range of background checks including:

Criminal Record Checks (Canadian, US, UK, Australian)

Identity Verification

Credit Reports

Employment Verification

Education Verification

Reference Checks

Motor Vehicle Records

Global Watchlist and Sanctions

Right to Work Verification

AuthenticationCertn uses API keys to authenticate requests. Include your API key in the Authorization header:Authorization: Api-Key YOUR_API_KEYAPI keys can be created in the Client Portal under Settings → Integrations → API Keys.Data DomicilingCertn's platform is globally distributed with isolated servers in multiple regions:

North America (CA): https://api.ca.certn.co

Europe, Middle East and Africa (UK): https://api.uk.certn.co

Asia Pacific (AU): https://api.au.certn.co

Sandbox URLs are available for testing: https://api.sandbox.certn.coRate LimitingThe Certn API enforces rate limits: 60 requests per minute, 7,220 requests per day.WebhooksCertn can notify your systems when events occur:

CASE_STATUS_CHANGED - The status of a case has changed

CHECK_STATUS_CHANGED - The status of an individual check has changed

CASE_REPORT_READY - The case report is ready to retrieve

ContactFor more information, visit certn.co