- Updated on 19 Feb 2020
Partner API Overview
The GoodHire API is a web service that allows customers to order employment background checks on candidates and view the results of these checks.
There are two types of integrations in the GoodHire API, each with its own getting started guide:
- Customer - If you are a single company that will be ordering background reports on a single account and user.
- Partner - If you are an HR platform that will act as a partner to GoodHire and allow the employers on your platform to order GoodHire background reports, or if you're an employer needing to place reports on multiple locations and/or users, see our partner guide.
This guide will walk you through the process of setting up a company, a user, and a report via the GoodHire API.
Create a developer account
Send an email to firstname.lastname@example.org to request to speak to our partners team. Once ready, they'll create your account, and you’ll see your test API key displayed on the dashboard. Use this value in your API calls as you build your integration.
The API is accessed via HTTPS, and resources are operated upon using the GET and POST methods.
There are two base endpoints for the API that all methods are appended to:
The test endpoint can be used while you are building your application, and all background checks ordered via its methods will return dummy data. When you are ready to begin ordering real background checks, change your base endpoint to the production endpoint above and work with your GoodHire partner contact to receive your production API key.
The GoodHire API uses HTTP Basic Auth. Your API key consists of a token passed in the Authorization header of your requests:
curl -i -H "Authorization: ApiKey YOUR_API_KEY" \ https://api-sandbox.goodhire.com \
Where YOUR_API_KEY is your test or production API key.