Three endpoints
List the packages, place an order, and check its status. There is nothing else to learn.
ACE Connect - API
Submit a background check straight from your HR or applicant-tracking system. It follows the same package, searches, review, and report workflow as an order entered through the portal.
What the integration gives you
List the packages, place an order, and check its status. There is nothing else to learn.
An order sent by mistake can be rejected by ACE before it reaches a provider and before it costs anything.
A consumer report is not something to hand out on an API key, so it is collected by a signed-in user.
The contract
The applicant, the package, and where to search. What returns is the order object your system polls until it is finished.
{
"package": "Employment Background Screening",
"first_name": "Jordan",
"last_name": "Sample",
"date_of_birth": "1987-05-15",
"ssn": "123-45-6789",
"address": "123 Example St, Canton, OH 44714",
"reference": "HR-2026-0042",
"jurisdictions": {
"county_criminal_record": {
"state": "OH",
"county": "Stark"
}
}
}{
"message": "Order received. It will be reviewed and accepted by ACE before searches are run.",
"order": {
"id": "01a0866b-5e58-730c-a8e5-1a5e911535eb",
"number": "ACE-000562",
"status": "pending_acceptance",
"status_label": "Awaiting acceptance",
"package": "Employment Background Screening",
"subject": "Jordan Sample",
"reference": "HR-2026-0042",
"submitted_at": "2026-10-07T12:04:11+00:00",
"completed_at": null,
"documents": 0,
"searches": []
}
}After you submit
An order reports one of these on every poll. Six run in sequence; rejected is the branch ACE takes when it cannot proceed.
pending_acceptanceReceived. Waiting for ACE to accept it — no search has run, nothing is billed.+Nothing has been sent to a provider. An order submitted in error can still be rejected at no cost.
newAccepted. Searches have not started.+The order is accepted and searches are now billable, whether or not they have started.
processingSearches are running at the providers.+Providers are working and charges are already committed.
under_reviewResults are in. ACE is reviewing each record.+No further charge is added while ACE decides what each record means.
readyReview finished. The report is being produced.+No further charge is added unless a search is added during review.
completedFinished. The report is available in the portal.+The final order is available in the portal and appears on the next invoice.
rejectedACE could not proceed.+The order is not billed. ACE could not proceed and nothing was searched.
Live demonstration
The sample uses the documented request and response shapes. It is a browser-only demonstration: no applicant information leaves this page, no search is run, and nothing is billed.
{
"package": "Employment Background Screening",
"first_name": "Jordan",
"last_name": "Sample",
"reference": "HR-2026-0042"
}{
"status": "Awaiting request",
"endpoint": "POST /v1/orders"
}Order progress
Sample order is waiting to be submitted.
API reference · Version 1
JSON in, JSON out, over HTTPS. Three endpoints, one key, and a status to poll until the order is finished.
| Production | https://clientportal.acebackgroundcheck.com/api/v1 |
|---|---|
| Staging | https://clientportal-dd.acebackgroundcheck.com/api/v1 |
| Auth | Authorization: Bearer <key> or X-Api-Key: <key> |
| Rate limit | 120 requests per minute |
/packagesRead packages at integration time. The key for each search is what your system uses to send a jurisdiction.
/ordersA successful request returns 201 with pending_acceptance and an empty search list until ACE accepts it.
/orders/{id}Poll while status is anything other than completed or rejected. Collect the final report through the signed-in portal.
Keys
The key is shown once when created and stored only as a hash, so it can be replaced but never retrieved. Revoking takes effect immediately. Every accepted, rejected, or unauthorized call is recorded in the portal.
Errors
401 missing, unknown, or revoked key · 404 no such order on this account · 422 request understood but a field is wrong · 429 rate limit exceeded.
Before you build
Submitting the same applicant twice creates two orders. Use your own reference to guard against duplicate submission.
Searches are billable from the moment ACE accepts the order, not when it is submitted.
Social Security numbers are stored encrypted and redacted in the intake log.