Order a background check on a candidate via the Certn API and retrieve results via webhook or polling
domain: centric-api-docs.certn.co · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Authenticate with an API key in the Authorization header, created in the Client Portal under Integrations settings
Use the correct regional base URL for the account's data domicile (Certn operates separate regional API hosts)
Order a case for the candidate via the cases endpoint, specifying the checks or package to run
Register a webhook subscriber for case- and check-status-change events instead of polling
If polling is required, retrieve the case for status, then fetch the generated report once the case completes
Stay within the account's documented rate limit and back off on throttling responses
Known gotchas
Certn's original public API (docs.certn.co) is being retired in favor of the newer CertnCentric API — new integrations should target the current API rather than legacy docs
Certn is multi-region, so using the wrong regional base URL for the account's data domicile will fail
Case and check results are asynchronous, so webhooks are the documented preferred pattern over polling
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?