{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab","admonition","cards","card"]},"type":"markdown"},"seo":{"title":"Check report status","description":"Checkr developer documentation for background check APIs, embeds, and partner integrations."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"check-report-status","__idx":0},"children":["Check report status"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"report-status-values","__idx":1},"children":["Report status values"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report is in progress. Screenings are still running."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["suspended"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report is on hold — the candidate needs to provide additional information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paused"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report is awaiting a Review Action decision to continue or skip the remaining screenings."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Report processing has finished — at least one screening completed. The overall result is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clear"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consider"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All screenings in the report were canceled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dispute"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The candidate has disputed one or more results."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-1-poll-the-reports-endpoint","__idx":2},"children":["Option 1: Poll the Reports endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve the current status of a report at any time by calling the Reports endpoint."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"cURL","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -u YOUR_API_KEY: \\\n  https://api.checkr-staging.com/v1/reports/REPORT_ID\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Python","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import requests\n\nresponse = requests.get(\n    'https://api.checkr-staging.com/v1/reports/REPORT_ID',\n    auth=('YOUR_API_KEY', '')\n)\nreport = response.json()\nprint(report['status'])  # pending, complete, suspended, etc.\nprint(report['result'])  # clear or consider\n","lang":"python"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"JavaScript","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"const response = await fetch('https://api.checkr-staging.com/v1/reports/REPORT_ID', {\n  headers: {\n    'Authorization': 'Basic ' + btoa('YOUR_API_KEY:'),\n  },\n});\nconst report = await response.json();\nconsole.log(report.status); // pending, complete, suspended, etc.\nconsole.log(report.result); // clear or consider\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Go","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"go","header":{"controls":{"copy":{}}},"source":"package main\n\nimport (\n  \"fmt\"\n  \"io\"\n  \"net/http\"\n)\n\nfunc main() {\n  req, _ := http.NewRequest(\"GET\", \"https://api.checkr-staging.com/v1/reports/REPORT_ID\", nil)\n  req.SetBasicAuth(\"YOUR_API_KEY\", \"\")\n\n  resp, _ := http.DefaultClient.Do(req)\n  defer resp.Body.Close()\n  body, _ := io.ReadAll(resp.Body)\n  fmt.Println(string(body)) // Contains status and result fields\n}\n","lang":"go"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Java","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"java","header":{"controls":{"copy":{}}},"source":"import java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.util.Base64;\n\npublic class Main {\n  public static void main(String[] args) throws Exception {\n    String credentials = Base64.getEncoder().encodeToString(\"YOUR_API_KEY:\".getBytes());\n\n    HttpRequest request = HttpRequest.newBuilder()\n      .uri(URI.create(\"https://api.checkr-staging.com/v1/reports/REPORT_ID\"))\n      .header(\"Authorization\", \"Basic \" + credentials)\n      .GET()\n      .build();\n\n    HttpResponse<String> response = HttpClient.newHttpClient()\n      .send(request, HttpResponse.BodyHandlers.ofString());\n    System.out.println(response.body()); // Contains status and result fields\n  }\n}\n","lang":"java"},"children":[]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Ruby","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"ruby","header":{"controls":{"copy":{}}},"source":"require 'net/http'\nrequire 'json'\n\nuri = URI('https://api.checkr-staging.com/v1/reports/REPORT_ID')\nhttp = Net::HTTP.new(uri.host, uri.port)\nhttp.use_ssl = true\n\nrequest = Net::HTTP::Get.new(uri)\nrequest.basic_auth('YOUR_API_KEY', '')\n\nresponse = http.request(request)\nreport = JSON.parse(response.body)\nputs report['status'] # pending, complete, suspended, etc.\nputs report['result'] # clear or consider\n","lang":"ruby"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," field along with individual screening statuses."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Polling is straightforward but not recommended for production applications. Use webhooks instead."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-2-use-webhooks-recommended","__idx":3},"children":["Option 2: Use webhooks (recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure a webhook endpoint to receive real-time status updates. Checkr sends a POST request to your endpoint whenever a report or screening status changes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key webhook events:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event"},"children":["Event"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report.updated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report changed while processing — sent as individual screenings within the report complete."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report.suspended"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report has been suspended."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["report.completed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The report has finished processing."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To set up webhooks, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dashboard → Developer → Webhooks"]}," and add your endpoint URL."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"option-3-query-with-customer-mcp","__idx":4},"children":["Option 3: Query with Customer MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp/customer/introduction"},"children":["Checkr's Customer MCP"]}," to query report status using Claude or another AI assistant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example queries:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"What's the status of the report for John Smith?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Which reports are still pending?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Show me all reports with a 'consider' status this week.\""]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customer MCP is particularly useful for ad hoc lookups during development or support investigations."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":5},"children":["Further reading"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Checkr API docs","icon":"code","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","iconVariant":"ghost","to":"/apis/openapi/reports/getreport"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full Reports API reference."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Customer MCP","icon":"robot","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","iconVariant":"ghost","to":"/mcp/customer/introduction"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI-powered querying for Checkr data."]}]}]}]},"headings":[{"value":"Check report status","id":"check-report-status","depth":1},{"value":"Report status values","id":"report-status-values","depth":2},{"value":"Option 1: Poll the Reports endpoint","id":"option-1-poll-the-reports-endpoint","depth":2},{"value":"Option 2: Use webhooks (recommended)","id":"option-2-use-webhooks-recommended","depth":2},{"value":"Option 3: Query with Customer MCP","id":"option-3-query-with-customer-mcp","depth":2},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"title":"Check report status","description":"Poll the API, use webhooks, or query with AI to get real-time report status.","seo":{"title":"Check report status"}},"lastModified":"2026-09-18T05:44:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/use-cases/check-status","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}