Run Certn background checks via API

Steps

1. Obtain API credentials from Certn; authenticate by acquiring a token from the Certn token endpoint and including it as a token authorization header on all requests to https://api.certn.co (production) or https://demo-api.certn.co (development)
2. List available screening packages via the packages endpoint to identify the package_id for the check type you need (e.g., criminal record, soft check, credit)
3. Create a new applicant/screening request via the applicants or screenings endpoint with the candidate's name, email, and the selected package_id; the candidate will receive an email to complete their portion of the process
4. Poll the screening status endpoint using the returned screening ID; Certn enforces a burst rate limit of 120 requests per minute and a sustained limit of 14400 requests per 24 hours — stay within these bounds
5. When the screening status transitions to complete, retrieve the full result report via the results endpoint; results include component-level pass/fail indicators
6. Use the development base URL (demo-api.certn.co) for all integration testing; production orders trigger real checks and billing