Initiate a background check via the GoodHire API candidate invitation flow
domain: recruiting · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Contact GoodHire sales to obtain API credentials and agree to the required integration fee — there is no instant self-serve signup for the report API, unlike some competitors
Create a report request with a POST call to the report/queue endpoint (under /company/:company_id/requestor/:requestor_id/report/queue) including candidate identifying info and the desired background check package
Use the response to either redirect the employer to GoodHire's hosted checkout/report-selection flow, or trigger GoodHire's candidate invitation email so the candidate can authorize and complete required FCRA disclosures/consent themselves
Register a webhook endpoint in the GoodHire developer dashboard to receive real-time order status change notifications instead of polling
When a completion notification arrives (or by polling the report resource), fetch the report to read the final adjudicated status/result
Known gotchas
API access is sales-led and fee-gated — you talk to GoodHire sales and pay an integration fee to get credentials, you can't just self-register for API keys
FCRA-compliant candidate consent must be captured before/along with the report request; the invitation flow exists specifically because you cannot skip candidate authorization
GoodHire is now a Checkr company, but its API, credentials, and docs (help.goodhire.com) are separate from Checkr's own API — don't assume shared auth or endpoints between the two
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?