{"items":[{"type":"link","label":"Checkr Trust API","link":"/v1","routeSlug":"/v1","content":{"contentType":"overview","meta":{"name":"Checkr Trust API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"v1.json","url":"/_bundle/v1.json?download"},{"kind":"download","label":"v1.yaml","url":"/_bundle/v1.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://checkrtrust.com","url":"https://checkrtrust.com"},{"kind":"email","title":"API Development Team","email":"checkr-trust@checkr.com","label":"checkr-trust@checkr.com","withCopyButton":true,"copyContent":"checkr-trust@checkr.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Proprietary","url":"https://checkrtrust.com"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Checkr Trust API (1.0)","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checkr Trust is a modern, RESTful API-driven service designed to enhance trust and safety for your platform. The Checkr Trust API uses resource-oriented URLs, supports HTTPS for authentication and requests, and returns JSON responses."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Checkr Trust API provides access to a rich set of data, including criminal records, traffic infractions, and registry checks. Once credentialed, you can start testing locally in minutes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Intended Use Cases"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Important: Checkr Trust is not a “consumer reporting agency” or otherwise a producer of “consumer reports,” as those terms are defined in the Fair Credit Reporting Act (“FCRA”). Checkr Trust data must not be accessed, obtained, disclosed, or otherwise used to make any decisions related to credit, insurance, employment, or any other purposes described in 15 U.S.C. § 1681b of FCRA"},"children":[]}]}]}]}],"sectionId":"/v1"}]}]}},{"type":"separator","label":"Resources","content":null},{"type":"group","label":"Accounts","link":"/v1/accounts","routeSlug":"/v1/accounts","items":[{"label":"Create token","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/accounts/post-accounts-token","routeSlug":"/v1/accounts/post-accounts-token","metadata":{"seo":{"title":"Create token","description":"Exchange your Checkr Trust client_id and client_secret for a Beareraccess token (OAuth 2.0 client credentials)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-accounts-token","name":"Create token","isWebhook":false,"pointer":"/paths/~1accounts~1token/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create token","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your Checkr Trust "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a Bearer"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"access token (OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is optional; when sent it must be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_credentials"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Any other value returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the request body is optional and ignored; scopes on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"token come from your Auth0 client configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful Auth0 responses are returned as "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"200"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the standard"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"token fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"token_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid credentials or Auth0 rejections are passed through (typically"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"401"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") with Auth0's OAuth error body."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the authentication provider returns an unexpected or unparsable"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"response, a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"500"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is returned with the standard API error array."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Step-by-step guide: "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_51"}},"schemaId":"schema_51","pointer":"/paths/~1accounts~1token/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/accounts/token","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_51"}},"responseCodes":["200","400","401","500"],"pointer":"/accounts/token","href":"accounts/post-accounts-token","openApiOperationId":"post-accounts-token","summary":"Create token"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_51","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_51"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OK — Auth0 issued an access token. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on subsequent API calls."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/token"}},"schemaId":"components/schemas/token"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bad request — for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"grant_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was provided and is not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_credentials"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Body uses the standard API error array."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unauthorized — client credentials were rejected or the token request failed"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"upstream. Body is Auth0's OAuth error object (not the JSON:API error array"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"used elsewhere in this API)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/oauth_token_error"}},"schemaId":"components/schemas/oauth_token_error"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1accounts~1token/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/token","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/token"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/oauth_token_error","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/oauth_token_error"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/accounts/post-accounts-token"}],"panels":[]}]},"httpPath":"/accounts/token"}],"content":{"contentType":"group","meta":{"name":"Accounts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Accounts","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account credentialing and OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" token issuance"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). See"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the end-to-end flow."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Account creation and environment setup are done with a Checkr Trust team"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"member."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/accounts/token","summary":"Create token","prefix":{"name":"post","color":"post"},"badges":[],"link":"/accounts/post-accounts-token","deprecated":false}]}]}]}]}},{"type":"group","label":"Bulk Uploads","link":"/v1/bulk-uploads","routeSlug":"/v1/bulk-uploads","items":[{"label":"List bulk uploads","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/get-bulk-uploads","routeSlug":"/v1/bulk-uploads/get-bulk-uploads","metadata":{"seo":{"title":"List bulk uploads","description":"List bulk uploads for the authenticated account, newest first."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-bulk-uploads","name":"List bulk uploads","isWebhook":false,"pointer":"/paths/~1bulk_uploads/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List bulk uploads","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"List bulk uploads for the authenticated account, newest first.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"}],"pointer":"/paths/~1bulk_uploads/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bulk_uploads","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","500"],"pointer":"/bulk_uploads","href":"bulk-uploads/get-bulk-uploads","openApiOperationId":"get-bulk-uploads","summary":"List bulk uploads"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_54"}},"schemaId":"schema_54"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_54","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_54"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/get-bulk-uploads"}],"panels":[]}]},"httpPath":"/bulk_uploads"},{"label":"Create bulk upload","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/post-bulk-uploads","routeSlug":"/v1/bulk-uploads/post-bulk-uploads","metadata":{"seo":{"title":"Create bulk upload","description":"Upload a CSV of subjects and start asynchronous validation for a supportedcheck product."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-bulk-uploads","name":"Create bulk upload","isWebhook":false,"pointer":"/paths/~1bulk_uploads/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create bulk upload","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Upload a CSV of subjects and start asynchronous validation for a supported"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"check product."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supported "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings.permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; per-row "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (CSV rows must include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (same county CSV columns; plus "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings.permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; per-row "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CSV column requirements, header aliases, and example rows for each product are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"documented on the request body schema below."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"On success the upload is created in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"submitted"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / moves through validation."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant products complete each row when the check factory returns. County"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"products submit provider searches asynchronously; the upload stays in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" until every row is terminal, then result files are generated."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"County rows are also subject to the same pilot jurisdiction blocks and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fulfillment submission caps as single county checks."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/bulk_upload_create_request"}},"schemaId":"components/schemas/bulk_upload_create_request","pointer":"/paths/~1bulk_uploads/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bulk_uploads","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"multipart/form-data":{"schemaId":"components/schemas/bulk_upload_create_request"}},"responseCodes":["201","400","401","403","500"],"pointer":"/bulk_uploads","href":"bulk-uploads/post-bulk-uploads","openApiOperationId":"post-bulk-uploads","summary":"Create bulk upload"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/bulk_upload_create_request","mediaTypes":["multipart/form-data"],"mediaTypeSchemas":{"multipart/form-data":{"schemaId":"components/schemas/bulk_upload_create_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/bulk_upload"}},"schemaId":"components/schemas/bulk_upload"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/bulk_upload","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/bulk_upload"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/post-bulk-uploads"}],"panels":[]}]},"httpPath":"/bulk_uploads"},{"label":"Get bulk upload","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/get-bulk-uploads-id","routeSlug":"/v1/bulk-uploads/get-bulk-uploads-id","metadata":{"seo":{"title":"Get bulk upload","description":"Get a single bulk upload by id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-bulk-uploads-id","name":"Get bulk upload","isWebhook":false,"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get bulk upload","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single bulk upload by id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"bulk_upload_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the bulk upload","required":true}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bulk_uploads/{bulk_upload_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"bulk_upload_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/bulk_uploads/{bulk_upload_id}","href":"bulk-uploads/get-bulk-uploads-id","openApiOperationId":"get-bulk-uploads-id","summary":"Get bulk upload"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/bulk_upload"}},"schemaId":"components/schemas/bulk_upload"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/bulk_upload","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/bulk_upload"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/get-bulk-uploads-id"}],"panels":[]}]},"httpPath":"/bulk_uploads/{bulk_upload_id}"},{"label":"Download original CSV","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/get-bulk-uploads-id-original","routeSlug":"/v1/bulk-uploads/get-bulk-uploads-id-original","metadata":{"seo":{"title":"Download original CSV","description":"Download the original uploaded CSV file."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-bulk-uploads-id-original","name":"Download original CSV","isWebhook":false,"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1original/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download original CSV","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Download the original uploaded CSV file."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"bulk_upload_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the bulk upload","required":true}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1original/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bulk_uploads/{bulk_upload_id}/original","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"bulk_upload_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/bulk_uploads/{bulk_upload_id}/original","href":"bulk-uploads/get-bulk-uploads-id-original","openApiOperationId":"get-bulk-uploads-id-original","summary":"Download original CSV"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Original CSV attachment","mediaType":"text/csv","mediaTypes":["text/csv"],"mediaTypeContent":{"text/csv":{"schemaId":"schema_56"}},"schemaId":"schema_56"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1original/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_56","mediaTypes":["text/csv"],"mediaTypeContent":{"text/csv":{"schemaId":"schema_56"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/get-bulk-uploads-id-original"}],"panels":[]}]},"httpPath":"/bulk_uploads/{bulk_upload_id}/original"},{"label":"Download result file","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/get-bulk-uploads-id-results","routeSlug":"/v1/bulk-uploads/get-bulk-uploads-id-results","metadata":{"seo":{"title":"Download result file","description":"Download generated results. Default format=csv returns the summary CSV.Pass format=xlsx for the detailed spreadsheet."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-bulk-uploads-id-results","name":"Download result file","isWebhook":false,"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1results/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download result file","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Download generated results. Default "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"format=csv"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns the summary CSV."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"format=xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for the detailed spreadsheet."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"bulk_upload_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the bulk upload","required":true}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1results/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"format","in":"query","schemaId":"schema_57","description":"Result file format."}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1results/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/bulk_uploads/{bulk_upload_id}/results","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"bulk_upload_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[{"name":"format","in":"query","required":false,"schemaId":"schema_57"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/bulk_uploads/{bulk_upload_id}/results","href":"bulk-uploads/get-bulk-uploads-id-results","openApiOperationId":"get-bulk-uploads-id-results","summary":"Download result file"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Result file attachment","mediaType":"text/csv","mediaTypes":["text/csv","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"],"mediaTypeContent":{"text/csv":{"schemaId":"schema_56"},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schemaId":"schema_56"}},"schemaId":"schema_56"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1results/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_56","mediaTypes":["text/csv","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"],"mediaTypeContent":{"text/csv":{"schemaId":"schema_56"},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schemaId":"schema_56"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/get-bulk-uploads-id-results"}],"panels":[]}]},"httpPath":"/bulk_uploads/{bulk_upload_id}/results"},{"label":"Force-run a validated bulk upload","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/post-bulk-uploads-id-force-run","routeSlug":"/v1/bulk-uploads/post-bulk-uploads-id-force-run","metadata":{"seo":{"title":"Force-run a validated bulk upload","description":"Enqueue processing for a bulk upload in validated or invalid_inputwhen at least one runnable row remains. Returns 201 Created when thejob is queued (this endpoint predates the 202 convention used byregenerate_results). Poll GET /v1/bulk_uploads/{bulk_upload_id} forstate transitions — do not poll this POST endpoint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-bulk-uploads-id-force-run","name":"Force-run a validated bulk upload","isWebhook":false,"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1force_run/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Force-run a validated bulk upload","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enqueue processing for a bulk upload in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid_input"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when at least one runnable row remains. Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"201 Created"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"job is queued (this endpoint predates the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"202"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" convention used by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"regenerate_results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Poll "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/bulk_uploads/{bulk_upload_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state transitions — do not poll this POST endpoint."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"bulk_upload_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the bulk upload","required":true}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1force_run/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bulk_uploads/{bulk_upload_id}/force_run","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"bulk_upload_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["201","400","401","404","500"],"pointer":"/bulk_uploads/{bulk_upload_id}/force_run","href":"bulk-uploads/post-bulk-uploads-id-force-run","openApiOperationId":"post-bulk-uploads-id-force-run","summary":"Force-run a validated bulk upload"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Enqueued (returns 201 for backward compatibility)","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_58"}},"schemaId":"schema_58"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1force_run/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"schema_58","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_58"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/post-bulk-uploads-id-force-run"}],"panels":[]}]},"httpPath":"/bulk_uploads/{bulk_upload_id}/force_run"},{"label":"Regenerate result files","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/bulk-uploads/post-bulk-uploads-id-regenerate-results","routeSlug":"/v1/bulk-uploads/post-bulk-uploads-id-regenerate-results","metadata":{"seo":{"title":"Regenerate result files","description":"Enqueue asynchronous regeneration of the summary CSV and detailed XLSX resultfiles for an existing bulk upload. This does not re-run checks — it only rebuildsexport files from already-stored row outcomes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-bulk-uploads-id-regenerate-results","name":"Regenerate result files","isWebhook":false,"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1regenerate_results/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regenerate result files","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enqueue asynchronous regeneration of the summary CSV and detailed XLSX result"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"files for an existing bulk upload. This does not re-run checks — it only rebuilds"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"export files from already-stored row outcomes."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not poll this endpoint."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Each POST enqueues a separate background job; there"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is no idempotency or deduplication of in-flight regeneration work. Call once after"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"processing completes, then poll "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/bulk_uploads/{bulk_upload_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"download "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"result_file"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"detailed_result_file"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when attached) for completion."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"bulk_upload_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the bulk upload","required":true}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1regenerate_results/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/bulk_uploads/{bulk_upload_id}/regenerate_results","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"bulk_upload_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["202","401","404","500"],"pointer":"/bulk_uploads/{bulk_upload_id}/regenerate_results","href":"bulk-uploads/post-bulk-uploads-id-regenerate-results","openApiOperationId":"post-bulk-uploads-id-regenerate-results","summary":"Regenerate result files"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Regeneration job accepted (enqueued)","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_59"}},"schemaId":"schema_59"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1bulk_uploads~1{bulk_upload_id}~1regenerate_results/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"schema_59","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_59"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bulk-uploads/post-bulk-uploads-id-regenerate-results"}],"panels":[]}]},"httpPath":"/bulk_uploads/{bulk_upload_id}/regenerate_results"}],"content":{"contentType":"group","meta":{"name":"Bulk Uploads"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bulk Uploads","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Bulk Uploads accept a CSV of subjects and run supported check products in batch."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant Criminal products complete each row synchronously. County Criminal products"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"submit asynchronously and finalize result files once every row is terminal."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regulated products require a FCRA "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in upload settings."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/bulk_uploads","summary":"List bulk uploads","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bulk-uploads/get-bulk-uploads","deprecated":false},{"title":"/bulk_uploads","summary":"Create bulk upload","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bulk-uploads/post-bulk-uploads","deprecated":false},{"title":"/bulk_uploads/{bulk_upload_id}","summary":"Get bulk upload","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bulk-uploads/get-bulk-uploads-id","deprecated":false},{"title":"/bulk_uploads/{bulk_upload_id}/original","summary":"Download original CSV","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bulk-uploads/get-bulk-uploads-id-original","deprecated":false},{"title":"/bulk_uploads/{bulk_upload_id}/results","summary":"Download result file","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bulk-uploads/get-bulk-uploads-id-results","deprecated":false},{"title":"/bulk_uploads/{bulk_upload_id}/force_run","summary":"Force-run a validated bulk upload","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bulk-uploads/post-bulk-uploads-id-force-run","deprecated":false},{"title":"/bulk_uploads/{bulk_upload_id}/regenerate_results","summary":"Regenerate result files","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bulk-uploads/post-bulk-uploads-id-regenerate-results","deprecated":false}]}]}]}]}},{"type":"group","label":"Instant Criminal Checks","link":"/v1/instant-criminal-checks","routeSlug":"/v1/instant-criminal-checks","items":[{"label":"Get checks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/instant-criminal-checks/get-checks","routeSlug":"/v1/instant-criminal-checks/get-checks","metadata":{"seo":{"title":"Get checks","description":"Get a set of checks"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-checks","name":"Get checks","isWebhook":false,"pointer":"/paths/~1checks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get checks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of checks"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_60","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"single_results_found":{"summary":"Single value","value":"[\"results_found\"]"},"multiple_profile_and_results_found":{"summary":"Multiple values","value":"[\"profile\",\"results_found\"]"}}}],"pointer":"/paths/~1checks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_60","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/checks","href":"instant-criminal-checks/get-checks","openApiOperationId":"get-checks","summary":"Get checks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_61"}},"schemaId":"schema_61"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1checks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_61","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_61"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instant-criminal-checks/get-checks"}],"panels":[]}]},"httpPath":"/checks"},{"label":"Create check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/instant-criminal-checks/post-checks","routeSlug":"/v1/instant-criminal-checks/post-checks","metadata":{"seo":{"title":"Create check","description":"Create a new check."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-checks","name":"Create check","isWebhook":false,"pointer":"/paths/~1checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new check."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-mutual-exclusivity.md"},"children":[]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_62","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_rulesets_applied":{"summary":"Multiple values","value":"[\"profile\",\"rulesets_applied\"]"}}}],"pointer":"/paths/~1checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_63"}},"schemaId":"schema_63","pointer":"/paths/~1checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII/address fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both. See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_62","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_63"}},"responseCodes":["201","400","401","403","429","500"],"pointer":"/checks","href":"instant-criminal-checks/post-checks","openApiOperationId":"post-checks","summary":"Create check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_63","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_63"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/check"}},"schemaId":"components/schemas/check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instant-criminal-checks/post-checks"}],"panels":[]}]},"httpPath":"/checks"},{"label":"Get check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/instant-criminal-checks/get-check-by-id","routeSlug":"/v1/instant-criminal-checks/get-check-by-id","metadata":{"seo":{"title":"Get check","description":"Get a single check with a given id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-check-by-id","name":"Get check","isWebhook":false,"pointer":"/paths/~1checks~1{check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single check with a given id"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"check_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the check","required":true}],"pointer":"/paths/~1checks~1{check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_62","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_rulesets_applied":{"summary":"Multiple values","value":"[\"profile\",\"rulesets_applied\"]"}}}],"pointer":"/paths/~1checks~1{check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/checks/{check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_62","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/checks/{check_id}","href":"instant-criminal-checks/get-check-by-id","openApiOperationId":"get-check-by-id","summary":"Get check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/check"}},"schemaId":"components/schemas/check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1checks~1{check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instant-criminal-checks/get-check-by-id"}],"panels":[]}]},"httpPath":"/checks/{check_id}"},{"label":"Download check report (PDF)","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/instant-criminal-checks/get-check-report-pdf","routeSlug":"/v1/instant-criminal-checks/get-check-report-pdf","metadata":{"seo":{"title":"Download check report (PDF)","description":"Download a PDF report for a single instant criminal check. The file is returned as an attachment(Content-Disposition: attachment) with a suggested filename of checkr_trust_report{check_id}.pdf."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-check-report-pdf","name":"Download check report (PDF)","isWebhook":false,"pointer":"/paths/~1checks~1{check_id}~1report/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download check report (PDF)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Download a PDF report for a single instant criminal check. The file is returned as an attachment"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Content-Disposition: attachment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") with a suggested filename of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkr_trust_report{check_id}.pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The PDF reflects the same result shaping as the JSON check resource."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Availability:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"422 Unprocessable Content"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a JSON body when the check has not finished"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and results are not yet available (no completed results)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"check_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the check","required":true}],"pointer":"/paths/~1checks~1{check_id}~1report/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/checks/{check_id}/report","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","422","500"],"pointer":"/checks/{check_id}/report","href":"instant-criminal-checks/get-check-report-pdf","openApiOperationId":"get-check-report-pdf","summary":"Download check report (PDF)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"PDF document","mediaType":"application/pdf","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_56"}},"schemaId":"schema_56","headers":{"Content-Disposition":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attachment with suggested filename "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkr_trust_report{check_id}.pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"schema":{"type":"string","example":"attachment; filename=\"checkr_trust_report2b8313e8-4efd-45a1-b578-952b8313e890.pdf\""}}},"headerSchemaId":"schema_66"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"The check was not found, or it does not belong to the authenticated account.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_67"}},"schemaId":"schema_67"},{"code":"422","description":"Results are not yet available for this check (the check has not completed).\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_68"}},"schemaId":"schema_68"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1checks~1{check_id}~1report/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_56","mediaTypes":["application/pdf"],"mediaTypeContent":{"application/pdf":{"schemaId":"schema_56"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"schema_67","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_67"}}},{"code":"422","schemaId":"schema_68","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_68"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/instant-criminal-checks/get-check-report-pdf"}],"panels":[]}]},"httpPath":"/checks/{check_id}/report"}],"content":{"contentType":"group","meta":{"name":"Instant Criminal Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Instant Criminal Checks","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant Criminal Checks provide the resulting information relevant to the requested check for a set of PII. Checks include the check type and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results and confidence scoring:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Each criminal "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"case"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" inside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results[].cases[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identity_match_confidence_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when identity matching applies. That field summarizes how well the case matches the subject you searched (high, medium, low, or special values such as unknown or insufficient_information). See the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema in the checks component for full semantics."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/checks","summary":"Get checks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instant-criminal-checks/get-checks","deprecated":false},{"title":"/checks","summary":"Create check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/instant-criminal-checks/post-checks","deprecated":false},{"title":"/checks/{check_id}","summary":"Get check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instant-criminal-checks/get-check-by-id","deprecated":false},{"title":"/checks/{check_id}/report","summary":"Download check report (PDF)","prefix":{"name":"get","color":"get"},"badges":[],"link":"/instant-criminal-checks/get-check-report-pdf","deprecated":false}]}]}]}]}},{"type":"group","label":"Profile Criminal Checks","link":"/v1/profile-criminal-checks","routeSlug":"/v1/profile-criminal-checks","items":[{"label":"Create profile criminal check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/profile-criminal-checks/post-profile-criminal-checks","routeSlug":"/v1/profile-criminal-checks/post-profile-criminal-checks","metadata":{"seo":{"title":"Create profile criminal check","description":"Create a new profile criminal check. Unlike Instant Criminal Checks, results is an arrayof matched identities (profiles) with their own nested records, rather than a flat recordsarray -- so a customer can first review which identity matched before drilling into itsrecords."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-profile-criminal-checks","name":"Create profile criminal check","isWebhook":false,"pointer":"/paths/~1profile_criminal_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create profile criminal check","badges":[{"name":"Beta","color":"purple","position":"before"}],"isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new profile criminal check. Unlike Instant Criminal Checks, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is an array"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of matched identities (profiles) with their own nested records, rather than a flat records"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"array -- so a customer can first review which identity matched before drilling into its"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"records."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/beta-provisional-notice.md"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-mutual-exclusivity.md"},"children":[]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_69","description":"Request optional response fields. Repeat the parameter for multiple values."}],"pointer":"/paths/~1profile_criminal_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_70"}},"schemaId":"schema_70","pointer":"/paths/~1profile_criminal_checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new profile criminal check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both. See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/profile_criminal_checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/profile_criminal_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"schemaId":"schema_69","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_70"}},"responseCodes":["201","400","401","403","429","500"],"pointer":"/profile_criminal_checks","href":"profile-criminal-checks/post-profile-criminal-checks","openApiOperationId":"post-profile-criminal-checks","summary":"Create profile criminal check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_70","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_70"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile_criminal_check"}},"schemaId":"components/schemas/profile_criminal_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1profile_criminal_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/profile_criminal_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile_criminal_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/profile-criminal-checks/post-profile-criminal-checks"}],"panels":[]}]},"badges":[{"name":"Beta","color":"purple","position":"before"}],"httpPath":"/profile_criminal_checks"},{"label":"Get profile criminal check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/profile-criminal-checks/get-profile-criminal-check-by-id","routeSlug":"/v1/profile-criminal-checks/get-profile-criminal-check-by-id","metadata":{"seo":{"title":"Get profile criminal check","description":"Get a single profile criminal check with a given id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-profile-criminal-check-by-id","name":"Get profile criminal check","isWebhook":false,"pointer":"/paths/~1profile_criminal_checks~1{check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get profile criminal check","badges":[{"name":"Beta","color":"purple","position":"before"}],"isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get a single profile criminal check with a given id."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/beta-provisional-notice.md"},"children":[]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"check_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the check","required":true}],"pointer":"/paths/~1profile_criminal_checks~1{check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_69","description":"Request optional response fields. Repeat the parameter for multiple values."}],"pointer":"/paths/~1profile_criminal_checks~1{check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/profile_criminal_checks/{check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"schemaId":"schema_69","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/profile_criminal_checks/{check_id}","href":"profile-criminal-checks/get-profile-criminal-check-by-id","openApiOperationId":"get-profile-criminal-check-by-id","summary":"Get profile criminal check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile_criminal_check"}},"schemaId":"components/schemas/profile_criminal_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1profile_criminal_checks~1{check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/profile_criminal_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile_criminal_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/profile-criminal-checks/get-profile-criminal-check-by-id"}],"panels":[]}]},"badges":[{"name":"Beta","color":"purple","position":"before"}],"httpPath":"/profile_criminal_checks/{check_id}"}],"content":{"contentType":"group","meta":{"name":"Profile Criminal Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Profile Criminal Checks","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Profile Criminal Checks provide a people-data-graph-native, profile-centric alternative to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant Criminal Checks. Instead of a flat records array, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is an array of matched"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"identities (profiles) -- each with a conservative identity summary and its own nested"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"criminal records -- so you can review which identity matched before drilling into its records."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/beta-provisional-notice.md"},"children":[]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/profile_criminal_checks","summary":"Create profile criminal check","prefix":{"name":"post","color":"post"},"badges":[{"name":"Beta","color":"purple","position":"before"}],"link":"/profile-criminal-checks/post-profile-criminal-checks","deprecated":false},{"title":"/profile_criminal_checks/{check_id}","summary":"Get profile criminal check","prefix":{"name":"get","color":"get"},"badges":[{"name":"Beta","color":"purple","position":"before"}],"link":"/profile-criminal-checks/get-profile-criminal-check-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Criminal Checks","link":"/v1/criminal-checks","routeSlug":"/v1/criminal-checks","items":[{"label":"Get criminal checks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/criminal-checks/get-criminal-checks","routeSlug":"/v1/criminal-checks/get-criminal-checks","metadata":{"seo":{"title":"Get criminal checks","description":"Get a set of criminal checks. Results are only available after webhook delivery."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-criminal-checks","name":"Get criminal checks","isWebhook":false,"pointer":"/paths/~1criminal_checks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get criminal checks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of criminal checks. Results are only available after webhook delivery."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_60","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"single_results_found":{"summary":"Single value","value":"[\"results_found\"]"},"multiple_profile_and_results_found":{"summary":"Multiple values","value":"[\"profile\",\"results_found\"]"}}}],"pointer":"/paths/~1criminal_checks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/criminal_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_60","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/criminal_checks","href":"criminal-checks/get-criminal-checks","openApiOperationId":"get-criminal-checks","summary":"Get criminal checks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}},"schemaId":"schema_71"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1criminal_checks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_71","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_71"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/criminal-checks/get-criminal-checks"}],"panels":[]}]},"httpPath":"/criminal_checks"},{"label":"Create criminal check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/criminal-checks/post-criminal-checks","routeSlug":"/v1/criminal-checks/post-criminal-checks","metadata":{"seo":{"title":"Create criminal check","description":"Create a new criminal check. The check runs synchronously but results are only delivered via webhook."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-criminal-checks","name":"Create criminal check","isWebhook":false,"pointer":"/paths/~1criminal_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create criminal check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new criminal check. The check runs synchronously but results are only delivered via webhook."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-mutual-exclusivity-reference-id-allowed.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Important Notes:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are NOT returned in the HTTP response (returns 202 Accepted)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are delivered asynchronously via webhook"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhook destination_url must be configured in product configuration"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1criminal_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_73"}},"schemaId":"schema_73","pointer":"/paths/~1criminal_checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new criminal check."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are delivered asynchronously via webhook."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII/address fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/criminal_checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/criminal_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_73"}},"responseCodes":["202","400","401","403","429","500"],"pointer":"/criminal_checks","href":"criminal-checks/post-criminal-checks","openApiOperationId":"post-criminal-checks","summary":"Create criminal check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_73","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_73"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted - Check created, results will be delivered via webhook.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_74"}},"schemaId":"schema_74"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1criminal_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"schema_74","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_74"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Criminal Check Completion Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when the criminal check search is finished."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Criminal check clients must configure this webhook URL in their product configuration settings when their account is set up via their Checkr Trust Account Executive."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload contains the results for the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"criminal_check"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Results are delivered asynchronously via webhook. See the schema below for details."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on signature verification."},"children":[]}]}]}],"callbackName":"onSearchCompleted","callbackId":"onSearchCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/criminal-check-completed-event-body"}},"schemaId":"components/schemas/criminal-check-completed-event-body","pointer":"/paths/~1criminal_checks/post/callbacks/onSearchCompleted/post/requestBody","description":"Payload containing the criminal check results"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status (e.g. 200 OK, 201 Created, 204 No Content) when you successfully process the callback.\nWe treat any 2xx as success and will not retry the POST.\n"},{"code":"4xx","description":"HTTP status codes in the 4xx range indicate client errors (e.g., 400 Bad Request, 401 Unauthorized).\nReturning a 4xx status may result in retries depending on the specific status code.\n"}],"pointer":"/paths/~1criminal_checks/post/callbacks/onSearchCompleted/post/responses"}]},"pointer":"/paths/~1criminal_checks/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onSearchCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_75"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/criminal-checks/post-criminal-checks"}],"panels":[]}]},"httpPath":"/criminal_checks"},{"label":"Get criminal check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/criminal-checks/get-criminal-check-by-id","routeSlug":"/v1/criminal-checks/get-criminal-check-by-id","metadata":{"seo":{"title":"Get criminal check","description":"Get a single criminal check with a given id. Results are only visible after webhook delivery."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-criminal-check-by-id","name":"Get criminal check","isWebhook":false,"pointer":"/paths/~1criminal_checks~1{criminal_check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get criminal check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single criminal check with a given id. Results are only visible after webhook delivery."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"criminal_check_id","in":"path","schemaId":"schema_76","description":"the uuid identifying the criminal check","required":true}],"pointer":"/paths/~1criminal_checks~1{criminal_check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_62","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_rulesets_applied":{"summary":"Multiple values","value":"[\"profile\",\"rulesets_applied\"]"}}}],"pointer":"/paths/~1criminal_checks~1{criminal_check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/criminal_checks/{criminal_check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"criminal_check_id","in":"path","required":true,"schemaId":"schema_76"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_62","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/criminal_checks/{criminal_check_id}","href":"criminal-checks/get-criminal-check-by-id","openApiOperationId":"get-criminal-check-by-id","summary":"Get criminal check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/criminal_check"}},"schemaId":"components/schemas/criminal_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1criminal_checks~1{criminal_check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/criminal_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/criminal_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/criminal-checks/get-criminal-check-by-id"}],"panels":[]}]},"httpPath":"/criminal_checks/{criminal_check_id}"}],"content":{"contentType":"group","meta":{"name":"Criminal Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Criminal Checks","showPageActions":true},{"nodeType":"markdoc","content":"Criminal Checks provide criminal record check results delivered asynchronously via webhook."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/criminal_checks","summary":"Get criminal checks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/criminal-checks/get-criminal-checks","deprecated":false},{"title":"/criminal_checks","summary":"Create criminal check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/criminal-checks/post-criminal-checks","deprecated":false},{"title":"/criminal_checks/{criminal_check_id}","summary":"Get criminal check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/criminal-checks/get-criminal-check-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"County Checks","link":"/v1/county-checks","routeSlug":"/v1/county-checks","items":[{"label":"Create county check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/county-checks/post-county-checks","routeSlug":"/v1/county-checks/post-county-checks","metadata":{"seo":{"title":"Create county check","description":"Create a new county criminal check for a county jurisdiction, or a state-level criminal check whencounty_fips_code is the literal statewide (case-insensitively)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-county-checks","name":"Create county check","isWebhook":false,"pointer":"/paths/~1county_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create county check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new county criminal check for a county jurisdiction, or a state-level criminal check when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (case-insensitively)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint supports three mutually exclusive search modes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-county-precedence.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PII search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — provide subject identifying information directly:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"first_name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"last_name (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dob (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"county_fips_code (required) — 5-digit county FIPS, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level search"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Profile search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — reference an existing profile:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"profile_id (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state (required)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"county_fips_code (required) — 5-digit county FIPS, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level search"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Case number search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — search by a specific court case number (NC and MN only):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"case_number (required) — letters, numbers, spaces, and hyphens only"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state (required) — "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NC"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MN"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"county_fips_code (required) — 5-digit county FIPS"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These three modes are mutually exclusive — do not combine "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lookback_period_in_years"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the same request."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1county_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/county_check_request"}},"schemaId":"components/schemas/county_check_request","pointer":"/paths/~1county_checks/post/requestBody","description":"The request body for creating a county check"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/county_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/county_check_request"}},"responseCodes":["201","400","401","403","429","500","502"],"pointer":"/county_checks","href":"county-checks/post-county-checks","openApiOperationId":"post-county-checks","summary":"Create county check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/county_check_request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/county_check_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}},"schemaId":"components/schemas/county_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"502","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1county_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/county_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"502","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"County Check Completion Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when the county criminal check reaches a terminal state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure this webhook URL in your product configuration settings when your account is set up via your Checkr Trust Account Executive."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload is one of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal.completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — results are available ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal.not_available"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the search was cancelled or could not be completed ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on signature verification."},"children":[]}]}]}],"callbackName":"onSearchCompleted","callbackId":"onSearchCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Checkr-Signature","in":"header","schemaId":"schema_77","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 signature of the raw request body, formatted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sha256=<hex digest>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This header is always present. Verify it against the raw body using a timing-safe"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"comparison to confirm the payload's authenticity."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We strongly recommend configuring a dedicated webhook signing key (shared secret) with your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checkr Trust Account Executive. A dedicated secret limits the blast radius if your webhook"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint is compromised. If no dedicated signing key is configured, your account's client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"secret is used as a fallback — but reusing the client secret here broadens exposure of a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high-value credential, so a dedicated key is preferred."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To mitigate replay attacks, deduplicate on the event "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and ignore events you have already"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"processed. This is retry-safe, since retries reuse the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the original "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you additionally enforce a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" freshness window, size it to cover the full delivery"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"retry/backoff window so legitimate retries are not rejected."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1county_checks/post/callbacks/onSearchCompleted/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_78"}},"schemaId":"schema_78","pointer":"/paths/~1county_checks/post/callbacks/onSearchCompleted/post/requestBody","description":"Payload containing the county check result or not-available notification"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2XX","description":"Return any 2xx status (e.g. 200 OK, 201 Created, 204 No Content) when you successfully process the callback.\nWe treat any 2xx as success and will not retry the POST.\n"},{"code":"4XX","description":"HTTP status codes in the 4xx range indicate client errors (e.g., 400 Bad Request, 401 Unauthorized).\nReturning a 4xx status may result in retries depending on the specific status code.\n"}],"pointer":"/paths/~1county_checks/post/callbacks/onSearchCompleted/post/responses"}]},"pointer":"/paths/~1county_checks/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onSearchCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_78"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/county-checks/post-county-checks"}],"panels":[]}]},"httpPath":"/county_checks"},{"label":"Get county check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/county-checks/get-county-check-by-id","routeSlug":"/v1/county-checks/get-county-check-by-id","metadata":{"seo":{"title":"Get county check","description":"Get a single county check with a given id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-county-check-by-id","name":"Get county check","isWebhook":false,"pointer":"/paths/~1county_checks~1{county_check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get county check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single county check with a given id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"county_check_id","in":"path","schemaId":"schema_65","description":"The uuid identifying the county check","required":true}],"pointer":"/paths/~1county_checks~1{county_check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1county_checks~1{county_check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/county_checks/{county_check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"county_check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/county_checks/{county_check_id}","href":"county-checks/get-county-check-by-id","openApiOperationId":"get-county-check-by-id","summary":"Get county check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}},"schemaId":"components/schemas/county_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1county_checks~1{county_check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/county_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/county-checks/get-county-check-by-id"}],"panels":[]}]},"httpPath":"/county_checks/{county_check_id}"},{"label":"Cancel county check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/county-checks/post-county-check-cancel","routeSlug":"/v1/county-checks/post-county-check-cancel","metadata":{"seo":{"title":"Cancel county check","description":"Cancel an existing county check that is in a pending state."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-county-check-cancel","name":"Cancel county check","isWebhook":false,"pointer":"/paths/~1county_checks~1{county_check_id}~1cancel/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel county check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Cancel an existing county check that is in a pending state.\n\nA reason must be provided for the cancellation. Only checks that are\ncurrently in 'pending' status can be cancelled.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"county_check_id","in":"path","schemaId":"schema_65","description":"The uuid identifying the county check","required":true}],"pointer":"/paths/~1county_checks~1{county_check_id}~1cancel/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1county_checks~1{county_check_id}~1cancel/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/county_check_cancel_request"}},"schemaId":"components/schemas/county_check_cancel_request","pointer":"/paths/~1county_checks~1{county_check_id}~1cancel/post/requestBody","description":"The request body for cancelling a county check"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/county_checks/{county_check_id}/cancel","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"county_check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/county_check_cancel_request"}},"responseCodes":["200","400","401","404","429","500","502"],"pointer":"/county_checks/{county_check_id}/cancel","href":"county-checks/post-county-check-cancel","openApiOperationId":"post-county-check-cancel","summary":"Cancel county check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/county_check_cancel_request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/county_check_cancel_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}},"schemaId":"components/schemas/county_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"502","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1county_checks~1{county_check_id}~1cancel/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/county_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/county_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"502","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/county-checks/post-county-check-cancel"}],"panels":[]}]},"httpPath":"/county_checks/{county_check_id}/cancel"}],"content":{"contentType":"group","meta":{"name":"County Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"County Checks","showPageActions":true},{"nodeType":"markdoc","content":"County Checks provide county-level criminal background check results for a specific jurisdiction. Results are retrieved from county court records and can be cancelled while in pending status."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/county_checks","summary":"Create county check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/county-checks/post-county-checks","deprecated":false},{"title":"/county_checks/{county_check_id}","summary":"Get county check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/county-checks/get-county-check-by-id","deprecated":false},{"title":"/county_checks/{county_check_id}/cancel","summary":"Cancel county check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/county-checks/post-county-check-cancel","deprecated":false}]}]}]}]}},{"type":"group","label":"Driver Checks","link":"/v1/driver-checks","routeSlug":"/v1/driver-checks","items":[{"label":"Get driver checks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/driver-checks/get-driver-checks","routeSlug":"/v1/driver-checks/get-driver-checks","metadata":{"seo":{"title":"Get driver checks","description":"Get a set of previously created driver checks"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-driver-checks","name":"Get driver checks","isWebhook":false,"pointer":"/paths/~1driver_checks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get driver checks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of previously created driver checks"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1driver_checks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/driver_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/driver_checks","href":"driver-checks/get-driver-checks","openApiOperationId":"get-driver-checks","summary":"Get driver checks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_79"}},"schemaId":"schema_79"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1driver_checks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_79","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_79"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/driver-checks/get-driver-checks"}],"panels":[]}]},"httpPath":"/driver_checks"},{"label":"Create driver check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/driver-checks/post-driver-checks","routeSlug":"/v1/driver-checks/post-driver-checks","metadata":{"seo":{"title":"Create driver check","description":"Create a new driver check."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-driver-checks","name":"Create driver check","isWebhook":false,"pointer":"/paths/~1driver_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create driver check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new driver check."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-mutual-exclusivity-driver-checks.md"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/driver-check-inline-address-persistence.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"motor_vehicle_report"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" checks in Washington ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"WA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), only DPPA purposes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"employment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"insurance"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are supported."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If your account is configured with a different DPPA purpose, requests for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"motor_vehicle_report"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" checks in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"WA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be rejected."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This restriction does not apply to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"driver_license_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" checks."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"unmask_ssn","in":"query","schemaId":"schema_80","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls whether SSN values in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results_v2.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for driver license status checks) are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned in full or masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by driver check endpoints. For identity verification endpoints, see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn_identity_verification"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead — precedence rules differ."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When omitted, the account's product configuration "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" setting"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"determines whether SSNs are unmasked. When explicitly set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the query parameter overrides the product configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defaults to masked when the product configuration has no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"setting."},"children":[]}]}]}]}],"pointer":"/paths/~1driver_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_81"}},"schemaId":"schema_81","pointer":"/paths/~1driver_checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request to create a driver check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII/address fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both. See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/driver_checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/driver_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"unmask_ssn","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_81"}},"responseCodes":["201","400","401","403","409","429","500"],"pointer":"/driver_checks","href":"driver-checks/post-driver-checks","openApiOperationId":"post-driver-checks","summary":"Create driver check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_81","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_81"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/driver_check"}},"schemaId":"components/schemas/driver_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict — the upstream driver-check provider rejected the order (for example, a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"conflicting or duplicate request). Inspect the error payload for provider details."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The check is not created; correct the request or retry after resolving the conflict."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1driver_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/driver_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/driver_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"409","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Driver Check Completion Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when the driver check search is finished."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Driver check clients must configure this webhook URL when their account is set up via their Checkr Trust Account Executive."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload contains the results for either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"driver_license_status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"motor_vehicle_report"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" checks, depending on what was initiated. See the schemas below for details."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on signature verification."},"children":[]}]}]}],"callbackName":"onSearchCompleted","callbackId":"onSearchCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_82"}},"schemaId":"schema_82","pointer":"/paths/~1driver_checks/post/callbacks/onSearchCompleted/post/requestBody","description":"Payload containing the driver check results"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status (e.g. 200 OK, 201 Created, 204 No Content) when you successfully process the callback.\nWe treat any 2xx as success and will not retry the POST.\n"},{"code":"4xx","description":"HTTP status codes in the 4xx range indicate client errors (e.g., 400 Bad Request, 401 Unauthorized).\nReturning a 4xx status may result in retries depending on the specific status code.\n"}],"pointer":"/paths/~1driver_checks/post/callbacks/onSearchCompleted/post/responses"}]},"pointer":"/paths/~1driver_checks/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onSearchCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_82"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/driver-checks/post-driver-checks"}],"panels":[]}]},"httpPath":"/driver_checks"},{"label":"Get driver check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/driver-checks/get-driver-check-by-id","routeSlug":"/v1/driver-checks/get-driver-check-by-id","metadata":{"seo":{"title":"Get driver check","description":"Get a previously created driver check with a given id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-driver-check-by-id","name":"Get driver check","isWebhook":false,"pointer":"/paths/~1driver_checks~1{driver_check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get driver check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a previously created driver check with a given id"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"driver_check_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the driver check","required":true}],"pointer":"/paths/~1driver_checks~1{driver_check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}},{"name":"unmask_ssn","in":"query","schemaId":"schema_80","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls whether SSN values in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results_v2.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for driver license status checks) are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned in full or masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by driver check endpoints. For identity verification endpoints, see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn_identity_verification"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead — precedence rules differ."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When omitted, the account's product configuration "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" setting"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"determines whether SSNs are unmasked. When explicitly set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the query parameter overrides the product configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defaults to masked when the product configuration has no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"setting."},"children":[]}]}]}]}],"pointer":"/paths/~1driver_checks~1{driver_check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/driver_checks/{driver_check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"driver_check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true},{"name":"unmask_ssn","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/driver_checks/{driver_check_id}","href":"driver-checks/get-driver-check-by-id","openApiOperationId":"get-driver-check-by-id","summary":"Get driver check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/driver_check"}},"schemaId":"components/schemas/driver_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1driver_checks~1{driver_check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/driver_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/driver_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/driver-checks/get-driver-check-by-id"}],"panels":[]}]},"httpPath":"/driver_checks/{driver_check_id}"}],"content":{"contentType":"group","meta":{"name":"Driver Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Driver Checks","showPageActions":true},{"nodeType":"markdoc","content":"Driver Checks provide the resulting information relevant to the requested driver license. The response will include the driver check type and results."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/driver_checks","summary":"Get driver checks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/driver-checks/get-driver-checks","deprecated":false},{"title":"/driver_checks","summary":"Create driver check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/driver-checks/post-driver-checks","deprecated":false},{"title":"/driver_checks/{driver_check_id}","summary":"Get driver check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/driver-checks/get-driver-check-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Identity Verifications","link":"/v1/identity-verifications","routeSlug":"/v1/identity-verifications","items":[{"label":"Get identity verifications","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/identity-verifications/get-identity-verifications","routeSlug":"/v1/identity-verifications/get-identity-verifications","metadata":{"seo":{"title":"Get identity verifications","description":"Get a set of identity verifications"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-identity-verifications","name":"Get identity verifications","isWebhook":false,"pointer":"/paths/~1identity_verifications/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get identity verifications","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of identity verifications"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}},{"name":"unmask_ssn","in":"query","schemaId":"schema_80","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" results, controls whether SSN values in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.people[].ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in full or masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by identity verification endpoints only. Driver check endpoints use"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead — see that parameter for precedence rules that apply"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the product configuration has an explicit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" setting (available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only), that setting takes precedence over this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When no product configuration setting exists, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or omitted returns masked"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SSN values and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns full SSN values."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If an SSN value is null or empty, it remains null regardless of this parameter."},"children":[]}]}]}]}],"pointer":"/paths/~1identity_verifications/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/identity_verifications","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true},{"name":"unmask_ssn","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","204","400","401","500"],"pointer":"/identity_verifications","href":"identity-verifications/get-identity-verifications","openApiOperationId":"get-identity-verifications","summary":"Get identity verifications"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_83"}},"schemaId":"schema_83"},{"code":"204","description":"No content"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1identity_verifications/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_83","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_83"}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/identity-verifications/get-identity-verifications"}],"panels":[]}]},"httpPath":"/identity_verifications"},{"label":"Create identity verification","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/identity-verifications/post-identity-verifications","routeSlug":"/v1/identity-verifications/post-identity-verifications","metadata":{"seo":{"title":"Create identity verification","description":"Create a new identity verification."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-identity-verifications","name":"Create identity verification","isWebhook":false,"pointer":"/paths/~1identity_verifications/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create identity verification","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new identity verification."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-mutual-exclusivity-reference-id-allowed.md"},"children":[]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}},{"name":"unmask_ssn","in":"query","schemaId":"schema_80","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" results, controls whether SSN values in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.people[].ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in full or masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by identity verification endpoints only. Driver check endpoints use"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead — see that parameter for precedence rules that apply"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the product configuration has an explicit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" setting (available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only), that setting takes precedence over this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When no product configuration setting exists, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or omitted returns masked"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SSN values and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns full SSN values."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If an SSN value is null or empty, it remains null regardless of this parameter."},"children":[]}]}]}]}],"pointer":"/paths/~1identity_verifications/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_84"}},"schemaId":"schema_84","pointer":"/paths/~1identity_verifications/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new identity verification."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII/address fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both. See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/identity_verifications"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/identity_verifications","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true},{"name":"unmask_ssn","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_84"}},"responseCodes":["201","204","400","401","403","429","500"],"pointer":"/identity_verifications","href":"identity-verifications/post-identity-verifications","openApiOperationId":"post-identity-verifications","summary":"Create identity verification"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_84","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_84"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/identity_verification_post_response"}},"schemaId":"components/schemas/identity_verification_post_response"},{"code":"204","description":"No info available for this phone number"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1identity_verifications/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/identity_verification_post_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/identity_verification_post_response"}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Callback (webhook) triggered when document verification is completed.","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This callback is invoked when an identity verification of type 'document_verification' reaches a final state (complete, failed, etc.). The URL is pre-configured for the client account."},"children":[]}]}]}],"callbackName":"onDocumentVerificationCompleted","callbackId":"onDocumentVerificationCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/document-verification-completed-event-body"}},"schemaId":"components/schemas/document-verification-completed-event-body","pointer":"/paths/~1identity_verifications/post/callbacks/onDocumentVerificationCompleted/post/requestBody","description":"Payload containing the completed document verification details."},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status (e.g. 200 OK, 201 Created, 204 No Content) when you successfully process the callback.\nWe treat any 2xx as success and will not retry the POST.\n"},{"code":"4xx","description":"If your webhook handler returns a 4xx or 5xx status, we will retry the POST a set number of times (with exponential backoff).\n"}],"pointer":"/paths/~1identity_verifications/post/callbacks/onDocumentVerificationCompleted/post/responses"}]},"pointer":"/paths/~1identity_verifications/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onDocumentVerificationCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_85"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/identity-verifications/post-identity-verifications"}],"panels":[]}]},"httpPath":"/identity_verifications"},{"label":"Get identity verification","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/identity-verifications/get-identity-verification-by-id","routeSlug":"/v1/identity-verifications/get-identity-verification-by-id","metadata":{"seo":{"title":"Get identity verification","description":"Get a single identity verification with a given id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-identity-verification-by-id","name":"Get identity verification","isWebhook":false,"pointer":"/paths/~1identity_verifications~1{identity_verification_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get identity verification","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single identity verification with a given id"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"identity_verification_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the identity verification","required":true}],"pointer":"/paths/~1identity_verifications~1{identity_verification_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}},{"name":"unmask_ssn","in":"query","schemaId":"schema_80","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" results, controls whether SSN values in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.people[].ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are returned in full or masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used by identity verification endpoints only. Driver check endpoints use"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" instead — see that parameter for precedence rules that apply"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the product configuration has an explicit "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" setting (available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only), that setting takes precedence over this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When no product configuration setting exists, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or omitted returns masked"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"SSN values and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns full SSN values."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If an SSN value is null or empty, it remains null regardless of this parameter."},"children":[]}]}]}]}],"pointer":"/paths/~1identity_verifications~1{identity_verification_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/identity_verifications/{identity_verification_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"identity_verification_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true},{"name":"unmask_ssn","in":"query","required":false,"schemaId":"schema_80"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/identity_verifications/{identity_verification_id}","href":"identity-verifications/get-identity-verification-by-id","openApiOperationId":"get-identity-verification-by-id","summary":"Get identity verification"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/identity_verification"}},"schemaId":"components/schemas/identity_verification"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1identity_verifications~1{identity_verification_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/identity_verification","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/identity_verification"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/identity-verifications/get-identity-verification-by-id"}],"panels":[]}]},"httpPath":"/identity_verifications/{identity_verification_id}"},{"label":"Download collected document images","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/identity-verifications/get-identity-verification-files","routeSlug":"/v1/identity-verifications/get-identity-verification-files","metadata":{"seo":{"title":"Download collected document images","description":"(Document Verification only) Download a ZIP of collected images for the specified identity verification.The ZIP contains the following files:"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-identity-verification-files","name":"Download collected document images","isWebhook":false,"pointer":"/paths/~1identity_verifications~1{identity_verification_id}~1files/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Download collected document images","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(Document Verification only) Download a ZIP of collected images for the specified identity verification."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ZIP contains the following files:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Doc_Selfie_1_blob.jpg - the selfie image"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"documentbackDoc_Back_1_blob.jpg - the document back image"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"documentfrontDoc_Front_1_blob.jpg - the document front image"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"identity_verification_id","in":"path","schemaId":"schema_65","description":"the uuid identifying the identity verification","required":true}],"pointer":"/paths/~1identity_verifications~1{identity_verification_id}~1files/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/identity_verifications/{identity_verification_id}/files","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"identity_verification_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","404","422","500","502"],"pointer":"/identity_verifications/{identity_verification_id}/files","href":"identity-verifications/get-identity-verification-files","openApiOperationId":"get-identity-verification-files","summary":"Download collected document images"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"ZIP file","mediaType":"application/zip","mediaTypes":["application/zip"],"mediaTypeContent":{"application/zip":{"schemaId":"schema_56"}},"schemaId":"schema_56"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"422","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"502","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1identity_verifications~1{identity_verification_id}~1files/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_56","mediaTypes":["application/zip"],"mediaTypeContent":{"application/zip":{"schemaId":"schema_56"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"422","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"502","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/identity-verifications/get-identity-verification-files"}],"panels":[]}]},"httpPath":"/identity_verifications/{identity_verification_id}/files"}],"content":{"contentType":"group","meta":{"name":"Identity Verifications"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Identity Verifications","showPageActions":true},{"nodeType":"markdoc","content":"Identity Verifications provide the resulting information relevant to the requested verification for a set of PII. The response will include the IDV type and results."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/identity_verifications","summary":"Get identity verifications","prefix":{"name":"get","color":"get"},"badges":[],"link":"/identity-verifications/get-identity-verifications","deprecated":false},{"title":"/identity_verifications","summary":"Create identity verification","prefix":{"name":"post","color":"post"},"badges":[],"link":"/identity-verifications/post-identity-verifications","deprecated":false},{"title":"/identity_verifications/{identity_verification_id}","summary":"Get identity verification","prefix":{"name":"get","color":"get"},"badges":[],"link":"/identity-verifications/get-identity-verification-by-id","deprecated":false},{"title":"/identity_verifications/{identity_verification_id}/files","summary":"Download collected document images","prefix":{"name":"get","color":"get"},"badges":[],"link":"/identity-verifications/get-identity-verification-files","deprecated":false}]}]}]}]}},{"type":"group","label":"Profiles","link":"/v1/profiles","routeSlug":"/v1/profiles","items":[{"label":"Get profiles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/profiles/get-profiles","routeSlug":"/v1/profiles/get-profiles","metadata":{"seo":{"title":"Get profiles","description":"Get a set of profiles"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-profiles","name":"Get profiles","isWebhook":false,"pointer":"/paths/~1profiles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get profiles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of profiles"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"}],"pointer":"/paths/~1profiles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/profiles","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/profiles","href":"profiles/get-profiles","openApiOperationId":"get-profiles","summary":"Get profiles"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}},"schemaId":"schema_86"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1profiles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_86","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_86"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/profiles/get-profiles"}],"panels":[]}]},"httpPath":"/profiles"},{"label":"Create profile","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/profiles/post-profiles","routeSlug":"/v1/profiles/post-profiles","metadata":{"seo":{"title":"Create profile","description":"Create a new profile with personally identifiable information (PII)."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-profiles","name":"Create profile","isWebhook":false,"pointer":"/paths/~1profiles/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create profile","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Create a new profile with personally identifiable information (PII).\n\nThe profile can include various identity fields (SSN, email, phone) which are used for identity verification\nand record matching in check products. The more identity fields provided, the better\nthe matching and verification capabilities will be.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_87"}},"schemaId":"schema_87","pointer":"/paths/~1profiles/post/requestBody","description":"The request body for creating a new profile"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/profiles","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_87"}},"responseCodes":["201","400","401","403","500"],"pointer":"/profiles","href":"profiles/post-profiles","openApiOperationId":"post-profiles","summary":"Create profile"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_87","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_87"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile"}},"schemaId":"components/schemas/profile"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1profiles/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/profile","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/profiles/post-profiles"}],"panels":[]}]},"httpPath":"/profiles"},{"label":"Get profile","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/profiles/get-profile-by-id","routeSlug":"/v1/profiles/get-profile-by-id","metadata":{"seo":{"title":"Get profile","description":"Get a single profile with a given id"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-profile-by-id","name":"Get profile","isWebhook":false,"pointer":"/paths/~1profiles~1{profile_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get profile","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single profile with a given id"},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"profile_id","in":"path","schemaId":"schema_55","description":"the uuid identifying the profile","required":true}],"pointer":"/paths/~1profiles~1{profile_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/profiles/{profile_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"profile_id","in":"path","required":true,"example":"2b8313e8-b578-45a1-4efd-952b8313e890","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/profiles/{profile_id}","href":"profiles/get-profile-by-id","openApiOperationId":"get-profile-by-id","summary":"Get profile"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile"}},"schemaId":"components/schemas/profile"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1profiles~1{profile_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/profile","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/profile"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/profiles/get-profile-by-id"}],"panels":[]}]},"httpPath":"/profiles/{profile_id}"}],"content":{"contentType":"group","meta":{"name":"Profiles"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Profiles","showPageActions":true},{"nodeType":"markdoc","content":"Profiles represent a set of Personally Identifiable Information (PII) for a person who will be checked. Profiles can be updated with the latest information for a person and be referenced to generate checks."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/profiles","summary":"Get profiles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/profiles/get-profiles","deprecated":false},{"title":"/profiles","summary":"Create profile","prefix":{"name":"post","color":"post"},"badges":[],"link":"/profiles/post-profiles","deprecated":false},{"title":"/profiles/{profile_id}","summary":"Get profile","prefix":{"name":"get","color":"get"},"badges":[],"link":"/profiles/get-profile-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Regulated Adverse Action","link":"/v1/regulated-adverse-action","routeSlug":"/v1/regulated-adverse-action","items":[{"label":"Create a pre-adverse action","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-adverse-action/post-regulated-pre-adverse-action","routeSlug":"/v1/regulated-adverse-action/post-regulated-pre-adverse-action","metadata":{"seo":{"title":"Create a pre-adverse action","description":"Sends a pre-adverse action notification to the subject identified by check_id,giving them the opportunity to dispute the results of their background check beforea final decision is made regarding their eligibility. This ensures compliance andfairness in the decision-making process."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-regulated-pre-adverse-action","name":"Create a pre-adverse action","isWebhook":false,"pointer":"/paths/~1regulated~1pre_adverse_actions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a pre-adverse action","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Sends a pre-adverse action notification to the subject identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"giving them the opportunity to dispute the results of their background check before"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a final decision is made regarding their eligibility. This ensures compliance and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fairness in the decision-making process."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This step is optional but must precede a final adverse action if used. Cannot be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"submitted after an adverse action has already been taken for this check."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_request"}},"schemaId":"components/schemas/pre_adverse_action_request","pointer":"/paths/~1regulated~1pre_adverse_actions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/pre_adverse_actions","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_request"}},"responseCodes":["201","400","401","403","409","500"],"pointer":"/regulated/pre_adverse_actions","href":"regulated-adverse-action/post-regulated-pre-adverse-action","openApiOperationId":"post-regulated-pre-adverse-action","summary":"Create a pre-adverse action"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/pre_adverse_action_request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_response"}},"schemaId":"components/schemas/pre_adverse_action_response"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation error. One of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing, or the regulated check does not exist for this account."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adverse action is not enabled for the product configuration of this check."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The regulated check is more than 1 year old and cannot be used as the basis for a pre-adverse action; run a new regulated check first."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A pre-adverse action for this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was already initiated on this account within the last 30 days. Wait for the window to expire or use a different email."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile's first/last name is too common to act on without a middle name. Add a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to the profile, or set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to confirm there is no middle name."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The check has no criminal records to start an adverse action against."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One or more "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disqualifying_records[].record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values do not appear on the check's records."},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict — one of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a pre-adverse action has already been initiated for this check;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"an adverse action has already been taken on this check, so a pre-adverse action can no longer be submitted;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the candidate already has a standing adverse action on file (a non-reversed final adverse action, or an active dispute, on any of their checks), which locks the profile; or"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"another of the candidate's checks already has an adverse-action cycle in progress (only one cycle per candidate at a time)."},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1pre_adverse_actions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/pre_adverse_action_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_response"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"409","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Pre-Adverse Action Completion Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when the subject accepts a pre-adverse action"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"decision, transitioning it to the terminal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Closed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure the destination URL (and optionally a signing key) via the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_webhooks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings on the account's adverse-action-enabled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product configuration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signature verification."},"children":[]}]}]}],"callbackName":"onPreAdverseActionCompleted","callbackId":"onPreAdverseActionCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/pre-adverse-action-completed-event-body"}},"schemaId":"components/schemas/pre-adverse-action-completed-event-body","pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onPreAdverseActionCompleted/post/requestBody","description":"Minimal payload identifying the pre-adverse action and its terminal status."},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status to acknowledge receipt. We treat any 2xx as success and\nwill not retry the POST.\n"},{"code":"4xx","description":"4xx responses are treated as client errors and may trigger retries depending on\nthe specific status code.\n"},{"code":"5xx","description":"5xx responses are treated as server errors and will be retried automatically.\n"}],"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onPreAdverseActionCompleted/post/responses"}]},"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onPreAdverseActionCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_88"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Adverse Action Dispute Filed Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when a subject files a dispute against this pre-adverse"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"action. The same event also fires for disputes against final adverse actions —"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"inspect "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here) to tell them apart."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure the destination URL (and optionally a signing key) via the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_webhooks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings on the account's adverse-action-enabled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product configuration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") — the same destination used for pre-adverse-action webhooks."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signature verification."},"children":[]}]}]}],"callbackName":"onAdverseActionDisputeFiled","callbackId":"onAdverseActionDisputeFiled/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse-action-dispute-filed-event-body"}},"schemaId":"components/schemas/adverse-action-dispute-filed-event-body","pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onAdverseActionDisputeFiled/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimal payload identifying the dispute, its parent (pre-)adverse action, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"type. Fetch full details (including dispute timestamps) via"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", selected by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status to acknowledge receipt. We treat any 2xx as success and\nwill not retry the POST.\n"},{"code":"4xx","description":"4xx responses are treated as client errors and may trigger retries depending on\nthe specific status code.\n"},{"code":"5xx","description":"5xx responses are treated as server errors and will be retried automatically.\n"}],"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onAdverseActionDisputeFiled/post/responses"}]},"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onAdverseActionDisputeFiled/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_89"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Adverse Action Dispute Resolved Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when an admin resolves a dispute filed against this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pre-adverse action, either with changes to the report ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or without ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithoutChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The same event also fires for final"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"adverse actions — inspect "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" here) to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"tell them apart."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure the destination URL (and optionally a signing key) via the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_webhooks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings on the account's adverse-action-enabled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product configuration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signature verification."},"children":[]}]}]}],"callbackName":"onAdverseActionDisputeResolved","callbackId":"onAdverseActionDisputeResolved/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse-action-dispute-resolved-event-body"}},"schemaId":"components/schemas/adverse-action-dispute-resolved-event-body","pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onAdverseActionDisputeResolved/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimal payload identifying the dispute, its parent (pre-)adverse action, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolution outcome. Fetch full details (including dispute timestamps) via"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", selected by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status to acknowledge receipt. We treat any 2xx as success and\nwill not retry the POST.\n"},{"code":"4xx","description":"4xx responses are treated as client errors and may trigger retries depending on\nthe specific status code.\n"},{"code":"5xx","description":"5xx responses are treated as server errors and will be retried automatically.\n"}],"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks/onAdverseActionDisputeResolved/post/responses"}]},"pointer":"/paths/~1regulated~1pre_adverse_actions/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onAdverseActionDisputeResolved/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_90"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-adverse-action/post-regulated-pre-adverse-action"}],"panels":[]}]},"httpPath":"/regulated/pre_adverse_actions"},{"label":"Get a pre-adverse action","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-adverse-action/get-regulated-pre-adverse-action-by-id","routeSlug":"/v1/regulated-adverse-action/get-regulated-pre-adverse-action-by-id","metadata":{"seo":{"title":"Get a pre-adverse action","description":"Retrieves a single pre-adverse action record by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-pre-adverse-action-by-id","name":"Get a pre-adverse action","isWebhook":false,"pointer":"/paths/~1regulated~1pre_adverse_actions~1{pre_adverse_action_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a pre-adverse action","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a single pre-adverse action record by ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"pre_adverse_action_id","in":"path","schemaId":"schema_91","description":"The UUID of the pre-adverse action record.","required":true}],"pointer":"/paths/~1regulated~1pre_adverse_actions~1{pre_adverse_action_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/pre_adverse_actions/{pre_adverse_action_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"pre_adverse_action_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"components/schemas/uuid"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/pre_adverse_actions/{pre_adverse_action_id}","href":"regulated-adverse-action/get-regulated-pre-adverse-action-by-id","openApiOperationId":"get-regulated-pre-adverse-action-by-id","summary":"Get a pre-adverse action"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_detail_response"}},"schemaId":"components/schemas/pre_adverse_action_detail_response"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1pre_adverse_actions~1{pre_adverse_action_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/pre_adverse_action_detail_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/pre_adverse_action_detail_response"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-adverse-action/get-regulated-pre-adverse-action-by-id"}],"panels":[]}]},"httpPath":"/regulated/pre_adverse_actions/{pre_adverse_action_id}"},{"label":"Create an adverse action","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-adverse-action/post-regulated-adverse-action","routeSlug":"/v1/regulated-adverse-action/post-regulated-adverse-action","metadata":{"seo":{"title":"Create an adverse action","description":"Finalizes an adverse decision against the subject identified by check_id.Use this when your organization is declining a subject based in whole or in parton the results of a Checkr Trust background check."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-regulated-adverse-action","name":"Create an adverse action","isWebhook":false,"pointer":"/paths/~1regulated~1adverse_actions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create an adverse action","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Finalizes an adverse decision against the subject identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this when your organization is declining a subject based in whole or in part"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on the results of a Checkr Trust background check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delivers the required adverse action notice to the subject so they can seek"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"assistance or initiate a dispute. In the event a dispute is resolved with changes"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to the report, Checkr Trust will notify your organization so you can reassess"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the subject's eligibility."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"May be submitted with or without a prior pre-adverse action."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Including "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disqualifying_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is optional but strongly recommended — FCRA"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"requires disclosing which records triggered the adverse decision."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse_action_request"}},"schemaId":"components/schemas/adverse_action_request","pointer":"/paths/~1regulated~1adverse_actions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/adverse_actions","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/adverse_action_request"}},"responseCodes":["201","400","401","403","409","500"],"pointer":"/regulated/adverse_actions","href":"regulated-adverse-action/post-regulated-adverse-action","openApiOperationId":"post-regulated-adverse-action","summary":"Create an adverse action"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/adverse_action_request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse_action_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/adverse_action_response"}},"schemaId":"components/schemas/adverse_action_response"},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation error. One of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is missing, or the regulated check does not exist for this account."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adverse action is not enabled for the product configuration of this check."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The regulated check is more than 1 year old and cannot be used as the basis for an adverse action; run a new regulated check first."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An adverse action for this "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was already initiated on this account within the last 30 days. Wait for the window to expire or use a different email."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile's first/last name is too common to act on without a middle name. Add a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to the profile, or set "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to confirm there is no middle name."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The check has no criminal records to start an adverse action against."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One or more "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disqualifying_records[].record_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values do not appear on the check's records."},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"409","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conflict — one of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"an adverse action has already been initiated for this check;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the candidate already has a standing adverse action on file (a non-reversed final adverse action, or an active dispute, on any of their checks), which locks the profile; or"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"another of the candidate's checks already has an adverse-action cycle in progress (only one cycle per candidate at a time)."},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1adverse_actions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/adverse_action_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/adverse_action_response"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"409","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Adverse Action Dispute Filed Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when a subject files a dispute against a (pre-)adverse"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"action. Fires for both pre-adverse and final-adverse disputes — inspect"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to tell them apart."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure the destination URL (and optionally a signing key) via the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_webhooks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings on the account's adverse-action-enabled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product configuration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") — the same destination used for pre-adverse-action webhooks."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signature verification."},"children":[]}]}]}],"callbackName":"onAdverseActionDisputeFiled","callbackId":"onAdverseActionDisputeFiled/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse-action-dispute-filed-event-body"}},"schemaId":"components/schemas/adverse-action-dispute-filed-event-body","pointer":"/paths/~1regulated~1adverse_actions/post/callbacks/onAdverseActionDisputeFiled/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimal payload identifying the dispute, its parent (pre-)adverse action, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"type. Fetch full details (including dispute timestamps) via"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", selected by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status to acknowledge receipt. We treat any 2xx as success and\nwill not retry the POST.\n"},{"code":"4xx","description":"4xx responses are treated as client errors and may trigger retries depending on\nthe specific status code.\n"},{"code":"5xx","description":"5xx responses are treated as server errors and will be retried automatically.\n"}],"pointer":"/paths/~1regulated~1adverse_actions/post/callbacks/onAdverseActionDisputeFiled/post/responses"}]},"pointer":"/paths/~1regulated~1adverse_actions/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onAdverseActionDisputeFiled/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_89"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Adverse Action Dispute Resolved Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when an admin resolves a filed dispute, either with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"changes to the report ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or without"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithoutChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Fires for both pre-adverse and final-adverse"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"disputes — inspect "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to tell them apart."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure the destination URL (and optionally a signing key) via the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_webhooks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" settings on the account's adverse-action-enabled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"product configuration ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"signature verification."},"children":[]}]}]}],"callbackName":"onAdverseActionDisputeResolved","callbackId":"onAdverseActionDisputeResolved/post","contentChildren":[{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/adverse-action-dispute-resolved-event-body"}},"schemaId":"components/schemas/adverse-action-dispute-resolved-event-body","pointer":"/paths/~1regulated~1adverse_actions/post/callbacks/onAdverseActionDisputeResolved/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Minimal payload identifying the dispute, its parent (pre-)adverse action, and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resolution outcome. Fetch full details (including dispute timestamps) via"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", selected by"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2xx","description":"Return any 2xx status to acknowledge receipt. We treat any 2xx as success and\nwill not retry the POST.\n"},{"code":"4xx","description":"4xx responses are treated as client errors and may trigger retries depending on\nthe specific status code.\n"},{"code":"5xx","description":"5xx responses are treated as server errors and will be retried automatically.\n"}],"pointer":"/paths/~1regulated~1adverse_actions/post/callbacks/onAdverseActionDisputeResolved/post/responses"}]},"pointer":"/paths/~1regulated~1adverse_actions/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onAdverseActionDisputeResolved/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_90"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-adverse-action/post-regulated-adverse-action"}],"panels":[]}]},"httpPath":"/regulated/adverse_actions"},{"label":"Get an adverse action","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-adverse-action/get-regulated-adverse-action-by-id","routeSlug":"/v1/regulated-adverse-action/get-regulated-adverse-action-by-id","metadata":{"seo":{"title":"Get an adverse action","description":"Retrieves a single adverse action record by ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-adverse-action-by-id","name":"Get an adverse action","isWebhook":false,"pointer":"/paths/~1regulated~1adverse_actions~1{adverse_action_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get an adverse action","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a single adverse action record by ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"adverse_action_id","in":"path","schemaId":"schema_91","description":"The UUID of the adverse action record.","required":true}],"pointer":"/paths/~1regulated~1adverse_actions~1{adverse_action_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/adverse_actions/{adverse_action_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"adverse_action_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"components/schemas/uuid"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/adverse_actions/{adverse_action_id}","href":"regulated-adverse-action/get-regulated-adverse-action-by-id","openApiOperationId":"get-regulated-adverse-action-by-id","summary":"Get an adverse action"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/adverse_action_detail_response"}},"schemaId":"components/schemas/adverse_action_detail_response"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1adverse_actions~1{adverse_action_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/adverse_action_detail_response","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/adverse_action_detail_response"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-adverse-action/get-regulated-adverse-action-by-id"}],"panels":[]}]},"httpPath":"/regulated/adverse_actions/{adverse_action_id}"}],"content":{"contentType":"group","meta":{"name":"Regulated Adverse Action"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regulated Adverse Action","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regulated Adverse Action provides two separate endpoints for the FCRA adverse action flow:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pre-Adverse Action and Adverse Action."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pre-Adverse Action notifies the subject of a pending adverse decision, delivers a copy of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the report, and provides required FCRA disclosures — giving them an opportunity to dispute"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"before a final decision is made. This step is optional but must precede a final adverse"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"action if used."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adverse Action finalizes the adverse decision and delivers the required notice to the subject."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It may be submitted with or without a prior pre-adverse action."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/regulated/pre_adverse_actions","summary":"Create a pre-adverse action","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-adverse-action/post-regulated-pre-adverse-action","deprecated":false},{"title":"/regulated/pre_adverse_actions/{pre_adverse_action_id}","summary":"Get a pre-adverse action","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-adverse-action/get-regulated-pre-adverse-action-by-id","deprecated":false},{"title":"/regulated/adverse_actions","summary":"Create an adverse action","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-adverse-action/post-regulated-adverse-action","deprecated":false},{"title":"/regulated/adverse_actions/{adverse_action_id}","summary":"Get an adverse action","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-adverse-action/get-regulated-adverse-action-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Regulated Instant Criminal Checks","link":"/v1/regulated-instant-criminal-checks","routeSlug":"/v1/regulated-instant-criminal-checks","items":[{"label":"Get regulated checks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-instant-criminal-checks/get-regulated-checks","routeSlug":"/v1/regulated-instant-criminal-checks/get-regulated-checks","metadata":{"seo":{"title":"Get regulated checks","description":"Get a set of regulated instant criminal checks for the authenticated account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-checks","name":"Get regulated checks","isWebhook":false,"pointer":"/paths/~1regulated~1checks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get regulated checks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of regulated instant criminal checks for the authenticated account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"Limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"Skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_92","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"single_results_found":{"summary":"Single value","value":"[\"results_found\"]"},"multiple_profile_and_review":{"summary":"Multiple values","value":"[\"profile\",\"review\"]"}}}],"pointer":"/paths/~1regulated~1checks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_92","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/regulated/checks","href":"regulated-instant-criminal-checks/get-regulated-checks","openApiOperationId":"get-regulated-checks","summary":"Get regulated checks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_93"}},"schemaId":"schema_93"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1checks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_93","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_93"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-instant-criminal-checks/get-regulated-checks"}],"panels":[]}]},"httpPath":"/regulated/checks"},{"label":"Create regulated check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-instant-criminal-checks/post-regulated-checks","routeSlug":"/v1/regulated-instant-criminal-checks/post-regulated-checks","metadata":{"seo":{"title":"Create regulated check","description":"Create a new regulated criminal background check with legal annotation."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-regulated-checks","name":"Create regulated check","isWebhook":false,"pointer":"/paths/~1regulated~1checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create regulated check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new regulated criminal background check with legal annotation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint performs an instant criminal check and applies legal rules based on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the provided jurisdiction context. Results include legal annotation checks at the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record, case, and charge levels indicating whether items should be included,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"investigated, or removed based on applicable regulations."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with FCRA requirements."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-regulated-checks.md"},"children":[]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_94","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_review":{"summary":"Multiple values","value":"[\"profile\",\"review\"]"}}}],"pointer":"/paths/~1regulated~1checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_95"}},"schemaId":"schema_95","pointer":"/paths/~1regulated~1checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new regulated check with legal annotation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" only) or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both. See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/regulated/checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_94","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_95"}},"responseCodes":["201","400","401","403","429","500"],"pointer":"/regulated/checks","href":"regulated-instant-criminal-checks/post-regulated-checks","openApiOperationId":"post-regulated-checks","summary":"Create regulated check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_95","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_95"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_check"}},"schemaId":"components/schemas/regulated_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/regulated_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-instant-criminal-checks/post-regulated-checks"}],"panels":[]}]},"httpPath":"/regulated/checks"},{"label":"Get regulated check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-instant-criminal-checks/get-regulated-check-by-id","routeSlug":"/v1/regulated-instant-criminal-checks/get-regulated-check-by-id","metadata":{"seo":{"title":"Get regulated check","description":"Get a single regulated check with a given id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-check-by-id","name":"Get regulated check","isWebhook":false,"pointer":"/paths/~1regulated~1checks~1{check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get regulated check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single regulated check with a given id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"check_id","in":"path","schemaId":"schema_65","description":"The uuid identifying the check","required":true}],"pointer":"/paths/~1regulated~1checks~1{check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_94","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_review":{"summary":"Multiple values","value":"[\"profile\",\"review\"]"}}}],"pointer":"/paths/~1regulated~1checks~1{check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/checks/{check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_94","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/checks/{check_id}","href":"regulated-instant-criminal-checks/get-regulated-check-by-id","openApiOperationId":"get-regulated-check-by-id","summary":"Get regulated check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_check"}},"schemaId":"components/schemas/regulated_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1checks~1{check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/regulated_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-instant-criminal-checks/get-regulated-check-by-id"}],"panels":[]}]},"httpPath":"/regulated/checks/{check_id}"}],"content":{"contentType":"group","meta":{"name":"Regulated Instant Criminal Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regulated Instant Criminal Checks","showPageActions":true},{"nodeType":"markdoc","content":"Regulated Instant Criminal Checks provide instant criminal record check results with legal annotation. Results include checks at the record, case, and charge levels indicating compliance with applicable legal rules. A permissible purpose is required for FCRA compliance."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/regulated/checks","summary":"Get regulated checks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-instant-criminal-checks/get-regulated-checks","deprecated":false},{"title":"/regulated/checks","summary":"Create regulated check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-instant-criminal-checks/post-regulated-checks","deprecated":false},{"title":"/regulated/checks/{check_id}","summary":"Get regulated check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-instant-criminal-checks/get-regulated-check-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Regulated County Checks","link":"/v1/regulated-county-checks","routeSlug":"/v1/regulated-county-checks","items":[{"label":"Create regulated county check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-county-checks/post-regulated-county-checks","routeSlug":"/v1/regulated-county-checks/post-regulated-county-checks","metadata":{"seo":{"title":"Create regulated county check","description":"Create a new regulated county criminal check for a specific jurisdiction."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-regulated-county-checks","name":"Create regulated county check","isWebhook":false,"pointer":"/paths/~1regulated~1county_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create regulated county check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new regulated county criminal check for a specific jurisdiction."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint initiates a county-level or statewide criminal background check using either"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"provided PII (personally identifiable information) or an existing profile. Results include"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"legal annotation checks at the record, case, and charge levels indicating whether items"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"should be included, investigated, or removed based on applicable regulations."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with FCRA requirements."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required along with the state: provide a 5-digit FIPS code for a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"county-level check, or the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level check."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-county-precedence.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required fields when providing PII (without profile_id):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"first_name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"last_name"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dob"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"county_fips_code"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"filter_context"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When using a profile_id, state, county_fips_code, filter_context, and permissible_purpose are required."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_96","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_review":{"summary":"Multiple values","value":"[\"profile\",\"review\"]"}}}],"pointer":"/paths/~1regulated~1county_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/regulated_county_check_request"}},"schemaId":"components/schemas/regulated_county_check_request","pointer":"/paths/~1regulated~1county_checks/post/requestBody","description":"The request body for creating a regulated county check"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/county_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_96","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/regulated_county_check_request"}},"responseCodes":["201","400","401","403","429","500","502"],"pointer":"/regulated/county_checks","href":"regulated-county-checks/post-regulated-county-checks","openApiOperationId":"post-regulated-county-checks","summary":"Create regulated county check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"components/schemas/regulated_county_check_request","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/regulated_county_check_request"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_county_check"}},"schemaId":"components/schemas/regulated_county_check"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"502","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1county_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/regulated_county_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_county_check"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"502","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Callbacks","labelTranslationKey":"callbacks","deepLinkSuffix":"callbacks"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"item-content","variant":"callback","callback":{"httpVerb":"post","pathName":"https://example.com/my-webhook-endpoint","summary":"Regulated County Check Completion Webhook","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Callback (webhook) triggered when the regulated county check reaches a terminal state."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Configure this webhook URL in your product configuration settings when your account is set up via your Checkr Trust Account Executive."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload is one of:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_check.completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — results are available ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_check.not_available"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the search was cancelled or could not be completed ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status: cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refer to the main "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" documentation for details on signature verification."},"children":[]}]}]}],"callbackName":"onSearchCompleted","callbackId":"onSearchCompleted/post","contentChildren":[{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"X-Checkr-Signature","in":"header","schemaId":"schema_77","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HMAC-SHA256 signature of the raw request body, formatted as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sha256=<hex digest>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This header is always present. Verify it against the raw body using a timing-safe"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"comparison to confirm the payload's authenticity."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We strongly recommend configuring a dedicated webhook signing key (shared secret) with your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checkr Trust Account Executive. A dedicated secret limits the blast radius if your webhook"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"endpoint is compromised. If no dedicated signing key is configured, your account's client"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"secret is used as a fallback — but reusing the client secret here broadens exposure of a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high-value credential, so a dedicated key is preferred."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To mitigate replay attacks, deduplicate on the event "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and ignore events you have already"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"processed. This is retry-safe, since retries reuse the same "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the original "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you additionally enforce a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"created_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" freshness window, size it to cover the full delivery"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"retry/backoff window so legitimate retries are not rejected."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1regulated~1county_checks/post/callbacks/onSearchCompleted/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_97"}},"schemaId":"schema_97","pointer":"/paths/~1regulated~1county_checks/post/callbacks/onSearchCompleted/post/requestBody","description":"Payload containing the regulated county check result or not-available notification"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"2XX","description":"Return any 2xx status (e.g. 200 OK, 201 Created, 204 No Content) when you successfully process the callback.\nWe treat any 2xx as success and will not retry the POST.\n"},{"code":"4XX","description":"HTTP status codes in the 4xx range indicate client errors (e.g., 400 Bad Request, 401 Unauthorized).\nReturning a 4xx status may result in retries depending on the specific status code.\n"}],"pointer":"/paths/~1regulated~1county_checks/post/callbacks/onSearchCompleted/post/responses"}]},"pointer":"/paths/~1regulated~1county_checks/post/callbacks"}],"panels":[{"children":[{"kind":"callback-payload","callbackName":"onSearchCompleted/post","path":"https://example.com/my-webhook-endpoint","httpVerb":"post","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_97"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-county-checks/post-regulated-county-checks"}],"panels":[]}]},"httpPath":"/regulated/county_checks"},{"label":"Get regulated county check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-county-checks/get-regulated-county-check-by-id","routeSlug":"/v1/regulated-county-checks/get-regulated-county-check-by-id","metadata":{"seo":{"title":"Get regulated county check","description":"Get a single regulated county check with a given id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-county-check-by-id","name":"Get regulated county check","isWebhook":false,"pointer":"/paths/~1regulated~1county_checks~1{regulated_county_check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get regulated county check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single regulated county check with a given id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"regulated_county_check_id","in":"path","schemaId":"schema_65","description":"The uuid identifying the regulated county check","required":true}],"pointer":"/paths/~1regulated~1county_checks~1{regulated_county_check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_96","description":"Request optional response fields. Repeat the parameter for multiple values.","examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"},"multiple_profile_and_review":{"summary":"Multiple values","value":"[\"profile\",\"review\"]"}}}],"pointer":"/paths/~1regulated~1county_checks~1{regulated_county_check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/county_checks/{regulated_county_check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"regulated_county_check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_65"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_96","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/county_checks/{regulated_county_check_id}","href":"regulated-county-checks/get-regulated-county-check-by-id","openApiOperationId":"get-regulated-county-check-by-id","summary":"Get regulated county check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_county_check"}},"schemaId":"components/schemas/regulated_county_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1county_checks~1{regulated_county_check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/regulated_county_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_county_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-county-checks/get-regulated-county-check-by-id"}],"panels":[]}]},"httpPath":"/regulated/county_checks/{regulated_county_check_id}"}],"content":{"contentType":"group","meta":{"name":"Regulated County Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regulated County Checks","showPageActions":true},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regulated County Checks provide county-level or statewide criminal background check results for a specific jurisdiction. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required. Provide a 5-digit FIPS code for a county-level search, or the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level search. Results include checks at the record, case, and charge levels indicating compliance with applicable legal rules. A permissible purpose is required for FCRA compliance."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/regulated/county_checks","summary":"Create regulated county check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-county-checks/post-regulated-county-checks","deprecated":false},{"title":"/regulated/county_checks/{regulated_county_check_id}","summary":"Get regulated county check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-county-checks/get-regulated-county-check-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Regulated Criminal Reports","link":"/v1/regulated-criminal-reports","routeSlug":"/v1/regulated-criminal-reports","items":[{"label":"Get regulated criminal reports","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-criminal-reports/get-regulated-criminal-reports","routeSlug":"/v1/regulated-criminal-reports/get-regulated-criminal-reports","metadata":{"seo":{"title":"Get regulated criminal reports","description":"Get a set of regulated criminal reports for the authenticated account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-criminal-reports","name":"Get regulated criminal reports","isWebhook":false,"pointer":"/paths/~1regulated~1criminal_reports/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get regulated criminal reports","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a set of regulated criminal reports for the authenticated account."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"Limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"Skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1regulated~1criminal_reports/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/criminal_reports","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/regulated/criminal_reports","href":"regulated-criminal-reports/get-regulated-criminal-reports","openApiOperationId":"get-regulated-criminal-reports","summary":"Get regulated criminal reports"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_98"}},"schemaId":"schema_98"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1criminal_reports/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_98","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_98"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-criminal-reports/get-regulated-criminal-reports"}],"panels":[]}]},"httpPath":"/regulated/criminal_reports"},{"label":"Create regulated criminal report","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-criminal-reports/post-regulated-criminal-reports","routeSlug":"/v1/regulated-criminal-reports/post-regulated-criminal-reports","metadata":{"seo":{"title":"Create regulated criminal report","description":"Create a new regulated criminal report with legal annotation."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-regulated-criminal-reports","name":"Create regulated criminal report","isWebhook":false,"pointer":"/paths/~1regulated~1criminal_reports/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create regulated criminal report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new regulated criminal report with legal annotation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint creates an asynchronous criminal report that applies legal rules based on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the provided jurisdiction context. Results include legal annotation checks at the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record, case, and charge levels indicating whether items should be included,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"investigated, or removed based on applicable regulations."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with Fair Credit Reporting Act (FCRA) requirements."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-regulated-criminal-reports.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Important Notes:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are NOT returned in the HTTP response (returns 202 Accepted)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Full results are delivered asynchronously via webhook once processing is complete"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_99"}},"schemaId":"schema_99","pointer":"/paths/~1regulated~1criminal_reports/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new regulated criminal report."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results are delivered asynchronously via webhook."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline PII/address fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/regulated/criminal_reports"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/criminal_reports","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_99"}},"responseCodes":["202","400","401","403","429","500"],"pointer":"/regulated/criminal_reports","href":"regulated-criminal-reports/post-regulated-criminal-reports","openApiOperationId":"post-regulated-criminal-reports","summary":"Create regulated criminal report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_99","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_99"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Accepted - Report created, results will be delivered via webhook.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_criminal_report_created"}},"schemaId":"components/schemas/regulated_criminal_report_created"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1criminal_reports/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/regulated_criminal_report_created","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_criminal_report_created"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-criminal-reports/post-regulated-criminal-reports"}],"panels":[]}]},"httpPath":"/regulated/criminal_reports"},{"label":"Get regulated criminal report","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-criminal-reports/get-regulated-criminal-report-by-id","routeSlug":"/v1/regulated-criminal-reports/get-regulated-criminal-report-by-id","metadata":{"seo":{"title":"Get regulated criminal report","description":"Get a single regulated criminal report with a given id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-regulated-criminal-report-by-id","name":"Get regulated criminal report","isWebhook":false,"pointer":"/paths/~1regulated~1criminal_reports~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get regulated criminal report","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a single regulated criminal report with a given id."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_76","description":"The uuid identifying the regulated criminal report","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890"}],"pointer":"/paths/~1regulated~1criminal_reports~1{id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1regulated~1criminal_reports~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/criminal_reports/{id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"schema_76"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/criminal_reports/{id}","href":"regulated-criminal-reports/get-regulated-criminal-report-by-id","openApiOperationId":"get-regulated-criminal-report-by-id","summary":"Get regulated criminal report"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_criminal_report"}},"schemaId":"components/schemas/regulated_criminal_report"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1criminal_reports~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/regulated_criminal_report","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/regulated_criminal_report"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-criminal-reports/get-regulated-criminal-report-by-id"}],"panels":[]}]},"httpPath":"/regulated/criminal_reports/{id}"}],"content":{"contentType":"group","meta":{"name":"Regulated Criminal Reports"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regulated Criminal Reports","showPageActions":true},{"nodeType":"markdoc","content":"Regulated Criminal Reports provide asynchronous criminal record check results with legal annotation. Results are delivered via webhook once processing is complete. A permissible purpose is required for Fair Credit Reporting Act (FCRA) compliance."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/regulated/criminal_reports","summary":"Get regulated criminal reports","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-criminal-reports/get-regulated-criminal-reports","deprecated":false},{"title":"/regulated/criminal_reports","summary":"Create regulated criminal report","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-criminal-reports/post-regulated-criminal-reports","deprecated":false},{"title":"/regulated/criminal_reports/{id}","summary":"Get regulated criminal report","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-criminal-reports/get-regulated-criminal-report-by-id","deprecated":false}]}]}]}]}},{"type":"group","label":"Regulated Eviction Checks","link":"/v1/regulated-eviction-checks","routeSlug":"/v1/regulated-eviction-checks","items":[{"label":"Get eviction checks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-eviction-checks/get-eviction-checks","routeSlug":"/v1/regulated-eviction-checks/get-eviction-checks","metadata":{"seo":{"title":"Get eviction checks","description":"Get a list of previously created eviction checks."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-eviction-checks","name":"Get eviction checks","isWebhook":false,"pointer":"/paths/~1regulated~1eviction_checks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get eviction checks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Get a list of previously created eviction checks."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"limit","in":"query","schemaId":"schema_52","description":"limit the number of records returned"},{"name":"skip","in":"query","schemaId":"schema_53","description":"skip a number of records before returning (for paging)"},{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1regulated~1eviction_checks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/eviction_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"limit","in":"query","required":false,"schemaId":"schema_52"},{"name":"skip","in":"query","required":false,"schemaId":"schema_53"},{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","400","401","500"],"pointer":"/regulated/eviction_checks","href":"regulated-eviction-checks/get-eviction-checks","openApiOperationId":"get-eviction-checks","summary":"Get eviction checks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_100"}},"schemaId":"schema_100"},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1eviction_checks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_100","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_100"}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-eviction-checks/get-eviction-checks"}],"panels":[]}]},"httpPath":"/regulated/eviction_checks"},{"label":"Create eviction check","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-eviction-checks/post-eviction-checks","routeSlug":"/v1/regulated-eviction-checks/post-eviction-checks","metadata":{"seo":{"title":"Create eviction check","description":"Create a new eviction check."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"post-eviction-checks","name":"Create eviction check","isWebhook":false,"pointer":"/paths/~1regulated~1eviction_checks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create eviction check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a new eviction check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Eviction checks search court records for eviction filings associated with the provided PII or profile. Results are returned synchronously in the response body."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/profile-id-pii-eviction-checks.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Providing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is strongly encouraged — it significantly reduces false positives when multiple people share a name."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with FCRA requirements."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1regulated~1eviction_checks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_101"}},"schemaId":"schema_101","pointer":"/paths/~1regulated~1eviction_checks/post/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request body for creating a new regulated eviction check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use either inline name/identity fields or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—not both ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"property_zip"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). See the POST "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/regulated/eviction_checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" operation for details."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/regulated/eviction_checks","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_101"}},"responseCodes":["201","400","401","403","429","500"],"pointer":"/regulated/eviction_checks","href":"regulated-eviction-checks/post-eviction-checks","openApiOperationId":"post-eviction-checks","summary":"Create eviction check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"schemaId":"schema_101","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_101"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created.\nWhen the product has usage limits configured, the response includes X-RateLimit-Limit, X-RateLimit-Remaining, and optionally X-RateLimit-Expires.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/eviction_check","exampleIds":["paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results","paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results"]}},"schemaId":"components/schemas/eviction_check","exampleIds":["paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results","paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results"]},{"code":"400","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"403","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"429","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Too Many Requests - the product configuration has reached its usage limit or product access has expired."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When usage limits are configured, the response includes X-RateLimit-* headers (see below)."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors","headers":{"X-RateLimit-Limit":{"description":"Maximum number of API calls allowed for this product configuration.","schema":{"type":"string","example":"100"}},"X-RateLimit-Remaining":{"description":"Number of calls remaining in the current limit period.","schema":{"type":"string","example":"0"}},"X-RateLimit-Expires":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}],"schema":{"type":["string","null"],"format":"date-time"}}},"headerSchemaId":"schema_64"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1eviction_checks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201","schemaId":"components/schemas/eviction_check","exampleIds":["paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results","paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/eviction_check","exampleIds":["paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results","paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results"]}}},{"code":"400","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"403","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"429","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-eviction-checks/post-eviction-checks"}],"panels":[]}]},"httpPath":"/regulated/eviction_checks"},{"label":"Get eviction check","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/v1/regulated-eviction-checks/get-eviction-check-by-id","routeSlug":"/v1/regulated-eviction-checks/get-eviction-check-by-id","metadata":{"seo":{"title":"Get eviction check","description":"Retrieve a previously created eviction check by its ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"get-eviction-check-by-id","name":"Get eviction check","isWebhook":false,"pointer":"/paths/~1regulated~1eviction_checks~1{eviction_check_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get eviction check","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieve a previously created eviction check by its ID."},{"nodeType":"security","requirements":[{"schemes":[{"name":"get-bearer-token-using-oauth2","scopes":[],"type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"eviction_check_id","in":"path","schemaId":"schema_91","description":"The UUID identifying the eviction check.","required":true}],"pointer":"/paths/~1regulated~1eviction_checks~1{eviction_check_id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"include[]","in":"query","schemaId":"schema_72","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embed the profile in the response in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":{"single_profile":{"summary":"Single value","value":"[\"profile\"]"}}}],"pointer":"/paths/~1regulated~1eviction_checks~1{eviction_check_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/regulated/eviction_checks/{eviction_check_id}","servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"parameters":{"path":[{"name":"eviction_check_id","in":"path","required":true,"example":"2b8313e8-4efd-45a1-b578-952b8313e890","schemaId":"components/schemas/uuid"}],"query":[{"name":"include[]","in":"query","required":false,"example":["profile"],"schemaId":"schema_72","style":"form","explode":true}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"get-bearer-token-using-oauth2","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}],"scopes":[]}],"responseCodes":["200","401","404","500"],"pointer":"/regulated/eviction_checks/{eviction_check_id}","href":"regulated-eviction-checks/get-eviction-check-by-id","openApiOperationId":"get-eviction-check-by-id","summary":"Get eviction check"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"OK","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/eviction_check"}},"schemaId":"components/schemas/eviction_check"},{"code":"401","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"404","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"},{"code":"500","description":"Error response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}},"schemaId":"components/schemas/errors"}],"pointer":"/paths/~1regulated~1eviction_checks~1{eviction_check_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/eviction_check","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/eviction_check"}}},{"code":"401","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"404","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}},{"code":"500","schemaId":"components/schemas/errors","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/errors"}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/regulated-eviction-checks/get-eviction-check-by-id"}],"panels":[]}]},"httpPath":"/regulated/eviction_checks/{eviction_check_id}"}],"content":{"contentType":"group","meta":{"name":"Regulated Eviction Checks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Regulated Eviction Checks","showPageActions":true},{"nodeType":"markdoc","content":"Regulated Eviction Checks surface eviction court records. Results are returned synchronously and include case filing details, plaintiff information, and judgement data."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/regulated/eviction_checks","summary":"Get eviction checks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-eviction-checks/get-eviction-checks","deprecated":false},{"title":"/regulated/eviction_checks","summary":"Create eviction check","prefix":{"name":"post","color":"post"},"badges":[],"link":"/regulated-eviction-checks/post-eviction-checks","deprecated":false},{"title":"/regulated/eviction_checks/{eviction_check_id}","summary":"Get eviction check","prefix":{"name":"get","color":"get"},"badges":[],"link":"/regulated-eviction-checks/get-eviction-check-by-id","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/uuid":{"id":"components/schemas/uuid","kind":"json-schema","title":"uuid","data":{"type":"string","format":"uuid","description":"A universally unique identifier (UUID) in standard format.","example":"2b8313e8-4efd-45a1-b578-952b8313e890"}},"components/schemas/datetime":{"id":"components/schemas/datetime","kind":"json-schema","title":"datetime","data":{"type":"string","format":"date-time","description":"An ISO 8601 formatted date-time string.","example":"2020-01-01T00:00:00Z"}},"components/schemas/date":{"id":"components/schemas/date","kind":"json-schema","title":"date","data":{"type":"string","format":"date","description":"An ISO 8601 formatted date string.","example":"2020-01-01"}},"components/schemas/date_string_complete":{"id":"components/schemas/date_string_complete","kind":"json-schema","title":"date_string_complete","data":{"description":"A date in the form YYYYMMDD.","type":"string","pattern":"\\d{8}","minLength":8,"maxLength":8,"example":"19950401"}},"components/schemas/date_string_partial":{"id":"components/schemas/date_string_partial","kind":"json-schema","title":"date_string_partial","data":{"description":"A date or partial date in the form YYYYMMDD.\nSince some dates are partial, they may be represented as YYYY0000 or 0000MMDD or YYYYMM00.\n","type":"string","pattern":"\\d{8}","minLength":8,"maxLength":8,"example":"19950401"}},"components/schemas/country_code":{"id":"components/schemas/country_code","kind":"json-schema","title":"country_code","data":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter country code in ISO 3166-1 alpha-2 format.","example":"US"}},"components/schemas/state_code":{"id":"components/schemas/state_code","kind":"json-schema","title":"state_code","data":{"type":"string","pattern":"^[A-Z]{2}$","description":"A two-letter US state code.","example":"CA"}},"components/schemas/zip_code":{"id":"components/schemas/zip_code","kind":"json-schema","title":"zip_code","data":{"type":"string","pattern":"^\\d{5}(-\\d{4})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"US Postal Service ZIP code (5-digit or 9-digit ZIP+4 format)."},"children":[]}]}]}],"example":"94105"}},"components/schemas/address":{"id":"components/schemas/address","kind":"json-schema","title":"address","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A US postal address supplied in a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (for example on check create or profile create/update)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When this object is present, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"zip_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are required."},"children":[]}]}]}],"properties":{"street":{"type":"string","description":"Street address, including house/building number and street name.\nApartment or unit numbers may be included; they are stored but are not used for criminal-record address matching.\n","example":"123 Main St"},"city":{"type":"string","description":"The name of the city or municipality.","example":"Frankfort"},"state":{"description":"The two-letter US state code where the address is located.","$ref":"#/components/schemas/state_code"},"zip_code":{"description":"The US postal ZIP code for the address.","$ref":"#/components/schemas/zip_code"},"country":{"description":"The two-letter country code, typically \"US\" for United States addresses.","$ref":"#/components/schemas/country_code"}},"required":["street","city","state","zip_code"]}},"components/schemas/address_as_reported":{"id":"components/schemas/address_as_reported","kind":"json-schema","title":"address_as_reported","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An address as it appears on a criminal or registry "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returned from a data source."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format and completeness vary by source. Only fields present on the source record are returned;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"do not assume every address object includes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"street"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"city"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"zip_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"street":{"type":"string","description":"Street or location line as reported by the source. May be a free-form string rather than a\nnormalized postal address (for example, a registry status message).\n","example":"123 Main St"},"city":{"type":"string","description":"City or municipality when reported by the source.","example":"Frankfort"},"state":{"type":"string","description":"State as reported by the source, if any.","example":"KY"},"zip_code":{"type":"string","description":"ZIP code as reported by the source, if any.","example":"40601"},"country":{"type":"string","description":"Country as reported by the source, if any.","example":"US"}}}},"components/schemas/addresses":{"id":"components/schemas/addresses","kind":"json-schema","title":"addresses","data":{"type":"array","minItems":1,"maxItems":10,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request only."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Array of addresses supplied by the caller. Index 0 is the primary address."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the property is provided, at least one address entry is required."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For check requests, records may be matched against any address in the array."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The singular "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field remains supported for backwards compatibility and maps to the primary address."},"children":[]}]}]}],"items":{"$ref":"#/components/schemas/address"}}},"components/schemas/email_string":{"id":"components/schemas/email_string","kind":"json-schema","title":"email_string","data":{"type":"string","format":"email","description":"An email address.","example":"john.doe@example.com"}},"components/schemas/phone_string":{"id":"components/schemas/phone_string","kind":"json-schema","title":"phone_string","data":{"type":"string","pattern":"^\\+[1-9]\\d{1,14}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A phone number in the form +[country code][number including area code]."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://en.wikipedia.org/wiki/E.164"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"E.164 format"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Please note that U.S. phone numbers have a country code of \"1\" so all U.S. phone numbers ought to start with \"+1\"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A U.S. number supplied in national format (for example \"(415) 555-0123\") is normalized to E.164"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"on write. If the value cannot be parsed as a valid phone number, the API returns a 400 with a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"+14155552671"}},"components/schemas/ssn_string":{"id":"components/schemas/ssn_string","kind":"json-schema","title":"ssn_string","data":{"type":"string","pattern":"^\\d{3}-?\\d{2}-?\\d{4}$","description":"A US Social Security Number in XXX-XX-XXXX format. Hyphens are optional.","example":"123-45-6789"}},"components/schemas/custom_id_string":{"id":"components/schemas/custom_id_string","kind":"json-schema","title":"custom_id_string","data":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","description":"An identifier of your choice, if you wish to use one. Limited to 64 alphanumeric characters, underscores, and hyphens.","example":"my-custom-id-123"}},"components/schemas/reference_id":{"id":"components/schemas/reference_id","kind":"json-schema","title":"reference_id","data":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,64}$","description":"A reference identifier for linking related records. Limited to 64 alphanumeric characters, underscores, and hyphens.","example":"ref-123"}},"components/schemas/ruleset_id":{"id":"components/schemas/ruleset_id","kind":"json-schema","title":"ruleset_id","data":{"description":"Identifier of an existing ruleset containing filtering rules. To set up account rulesets, please reach out to your Checkr Trust Account Executive or Customer Success representative to set up the configuration.","type":"string","format":"uuid","example":"d16e88e6-aacc-4c42-9cd2-58a93dc9d8af"}},"components/schemas/ruleset_ids":{"id":"components/schemas/ruleset_ids","kind":"json-schema","title":"ruleset_ids","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. When both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are provided, they are merged and de-duplicated before applying."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"components/schemas/profile_id":{"id":"components/schemas/profile_id","kind":"json-schema","title":"profile_id","data":{"type":"string","format":"uuid","description":"Identifier of an existing profile containing search criteria.","example":"2b8313e8-4efd-45a1-b578-952b8313e890"}},"components/schemas/input_type":{"id":"components/schemas/input_type","kind":"json-schema","title":"input_type","data":{"title":"input_type","type":"string","description":"The type of input being provided for the search. Can be either a person's information or an address.","enum":["person","address"],"default":"person"}},"components/schemas/input_type_address":{"id":"components/schemas/input_type_address","kind":"json-schema","title":"input_type","data":{"title":"input_type","type":"string","description":"Specifies that the input type is an address. Used when searching by address only.","enum":["address"]}},"components/schemas/source_states":{"id":"components/schemas/source_states","kind":"json-schema","title":"source_states","data":{"description":"An array of state abbreviations. Only records which come from a given source state are included in the results. Note that some sources are not tagged as coming from a single source state, so records from those sources will always be included. Sex offender registry records and most watchlist records are not tagged with a source state, and so will appear in the results regardless of this flag.  \n","type":"array","items":{"$ref":"#/components/schemas/state_code"}}},"components/schemas/order_by":{"id":"components/schemas/order_by","kind":"json-schema","title":"order_by","data":{"title":"order_by","type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the field to sort the results by. Currently only supported for 'photo_urls'."},"children":[]}]}]}],"enum":["photo_urls"],"example":"photo_urls"}},"components/schemas/error":{"id":"components/schemas/error","kind":"json-schema","title":"error","data":{"type":"object","description":"A standard error object following JSON:API error format.","properties":{"code":{"type":"string","description":"A machine-readable error code.","example":"invalid_request"},"title":{"type":"string","description":"A human-readable error title.","example":"Invalid Request"},"source":{"type":"object","description":"An object containing references to the source of the error.","properties":{"pointer":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A JSON Pointer [RFC6901] to the associated entity in the request document."},"children":[]}]}]}],"example":"/data/attributes/first_name"}}}},"required":["code","title"]}},"components/schemas/errors":{"id":"components/schemas/errors","kind":"json-schema","title":"errors","data":{"type":"array","description":"An array of error objects.","items":{"$ref":"#/components/schemas/error"}}},"components/schemas/token":{"id":"components/schemas/token","kind":"json-schema","title":"token","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.0 access token response from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(client credentials). Pass "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as a Bearer token on API requests."},"children":[]}]}]}],"required":["access_token","token_type","expires_in"],"properties":{"access_token":{"type":"string","description":"The JWT access token to use for API requests.","example":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."},"token_type":{"type":"string","description":"The type of token, always \"Bearer\".","example":"Bearer"},"expires_in":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Seconds until the token expires. Typically "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"86400"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when this elapses — this endpoint does not issue"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"refresh tokens."},"children":[]}]}]}],"example":86400},"scope":{"type":"string","description":"Space-separated OAuth scopes granted to this client (from Auth0 client\nconfiguration). Product check endpoints generally require a valid token\nand an enabled product configuration rather than a specific scope.\n","example":"read:account create:account delete:account"}}}},"components/schemas/oauth_token_error":{"id":"components/schemas/oauth_token_error","kind":"json-schema","title":"oauth_token_error","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.0 error body returned when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fails upstream"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(Auth0). Distinct from the JSON:API "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"errors"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array used on other endpoints."},"children":[]}]}]}],"required":["error"],"properties":{"error":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth error code (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"access_denied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid_client"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"access_denied"},"error_description":{"type":"string","description":"Human-readable explanation from the authorization server.","example":"Unauthorized"}}}},"components/schemas/check_review":{"id":"components/schemas/check_review","kind":"json-schema","title":"check_review","data":{"type":"object","description":"Customer accept/decline/dispute state for a regulated check.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"check_id":{"$ref":"#/components/schemas/uuid","description":"The check this verdict applies to."},"status":{"type":"string","enum":["accepted","declined","disputed"],"x-enumDescriptions":{"accepted":"The customer accepted the check results.","declined":"The customer declined the check results (adverse action initiated).","disputed":"The subject disputed an adverse action notice."}},"decided_at":{"$ref":"#/components/schemas/datetime"},"decided_by_user_id":{"$ref":"#/components/schemas/uuid","description":"User who recorded the accept/decline decision."},"adverse_action_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Associated adverse action record when status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"declined"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"disputed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; otherwise null."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/uuid"},{"type":"null"}]}},"required":["id","check_id","status","decided_at","decided_by_user_id"]}},"components/schemas/ruleset_applied":{"id":"components/schemas/ruleset_applied","kind":"json-schema","title":"ruleset_applied","data":{"type":"object","description":"A ruleset applied when filtering check results.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"name":{"type":"string"},"description":{"oneOf":[{"type":"string"},{"type":"null"}]},"enabled":{"type":"boolean"},"default":{"type":"boolean"},"shared":{"type":"boolean"},"rules":{"type":"object","description":"Rules engine definition used to filter results.","additionalProperties":true},"created_at":{"$ref":"#/components/schemas/datetime"},"updated_at":{"$ref":"#/components/schemas/datetime"},"account":{"$ref":"#/components/schemas/ruleset_applied_account"}},"required":["id","name","enabled","default","shared","rules","created_at","updated_at"]}},"components/schemas/ruleset_applied_account":{"id":"components/schemas/ruleset_applied_account","kind":"json-schema","title":"ruleset_applied_account","data":{"description":"Account that owns the ruleset. Null when not applicable.","oneOf":[{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"company_name":{"type":"string"},"uri_name":{"type":"string"}},"required":["id","company_name","uri_name"]},{"type":"null"}]}},"components/schemas/bulk_upload_product_name":{"id":"components/schemas/bulk_upload_product_name","kind":"json-schema","title":"bulk_upload_product_name","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Product configuration name for the upload. The account must have this product"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"enabled. Supported values:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — synchronous Instant Criminal checks"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — synchronous Regulated Instant Criminal checks"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — asynchronous County Criminal checks"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — asynchronous Regulated County Criminal checks"},"children":[]}]}]}]}],"enum":["instant_criminal","instant_criminal_regulated","county_criminal","county_criminal_regulated"],"example":"county_criminal"}},"components/schemas/bulk_upload_state":{"id":"components/schemas/bulk_upload_state","kind":"json-schema","title":"bulk_upload_state","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Lifecycle state of the bulk upload."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"County products may remain in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"processing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" while individual rows await"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"provider results ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"awaiting_results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on each item). The upload moves to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" once every row is terminal and result files are generated."},"children":[]}]}]}],"enum":["submitted","validating","invalid_input","validated","processing","completed","failed"],"example":"processing"}},"components/schemas/permissible_purpose":{"id":"components/schemas/permissible_purpose","kind":"json-schema","title":"permissible_purpose","data":{"type":"string","description":"The permissible purpose for requesting this criminal record check, as required by the Fair Credit Reporting Act (FCRA).\nThis must be provided for all regulated instant criminal checks to ensure compliance with federal regulations.\n","enum":["Court Order","Consumer Instruction","Credit Transaction","Employment","Insurance Underwriting","Benefit Eligibility","Credit Risk","Consumer Initiated","Account Review","Govt Chargecard","Child Support","Agency Liquidation"],"example":"Employment"}},"components/schemas/jurisdiction":{"id":"components/schemas/jurisdiction","kind":"json-schema","title":"jurisdiction","data":{"type":"object","description":"A geographic jurisdiction specified by state, and optionally county and city.","properties":{"state":{"$ref":"#/components/schemas/state_code"},"county":{"type":"string","description":"The county name within the state.","example":"Los Angeles"},"city":{"type":"string","description":"The city name within the jurisdiction.","example":"San Francisco"}}}},"components/schemas/filter_domain":{"id":"components/schemas/filter_domain","kind":"json-schema","title":"filter_domain","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The legal-filtering domain to apply to this check (for example, employment vs. tenancy rules)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is only needed when your account is configured to allow multiple filter domains."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Most callers do not need to set this — a default domain is applied automatically based on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your account's configuration. When your account does allow choosing a domain per call, only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a limited, pre-approved set of values is accepted; contact Checkr to configure which domains"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your account can use."},"children":[]}]}]}],"enum":["employment","long term tenancy","short term tenancy","eviction","other"],"example":"employment"}},"components/schemas/filter_context":{"id":"components/schemas/filter_context","kind":"json-schema","title":"filter_context","data":{"type":"object","description":"Context information used to determine which legal rules apply when filtering check results.\nJurisdictions help identify applicable state and local regulations that may affect\nwhich records can be reported.\n","properties":{"candidate_jurisdiction":{"description":"The jurisdiction where the candidate (subject of the check) is located.","$ref":"#/components/schemas/jurisdiction"},"decider_jurisdiction":{"description":"The jurisdiction where the decision-maker (employer/requester) is located.","$ref":"#/components/schemas/jurisdiction"},"property_jurisdiction":{"description":"The jurisdiction of the property involved (for tenancy-related checks).","$ref":"#/components/schemas/jurisdiction"},"filter_domain":{"$ref":"#/components/schemas/filter_domain"}},"required":["candidate_jurisdiction"]}},"components/schemas/bulk_upload_settings":{"id":"components/schemas/bulk_upload_settings","kind":"json-schema","title":"bulk_upload_settings","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Upload-level settings persisted on the bulk upload ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"additional_settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which fields apply depends on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"product_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Unknown keys are ignored by the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(strong parameters); only the fields below are accepted."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Send nested multipart fields using Rails bracket notation, for example"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings[permissible_purpose]=Employment"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings[filter_context][candidate_jurisdiction][state]=CA"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Instant Criminal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", optional"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"provider_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regulated Instant Criminal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"instant_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): same as instant, plus"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"regulated_user_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter_context"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"County Criminal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ruleset_ids"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lookback_period_in_years"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include_null_date_of_birth"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Per-row jurisdiction"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" belong in the CSV, not here."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Regulated County Criminal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal_regulated"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"): county settings plus"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"required "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"regulated_user_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"filter_context"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Per-row "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required in the CSV (FCRA compliance)."},"children":[]}]}]}],"properties":{"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"provider_name":{"type":"string","description":"Optional provider override for Instant Criminal bulk uploads only. Single-check\nInstant Criminal endpoints do not expose this field publicly; prefer account\nproduct configuration unless Checkr Trust directs otherwise.\n","example":"tessera"},"lookback_period_in_years":{"description":"Optional number of years to look back for criminal records (county products only).\nIf not provided, the default lookback period configured for the account will be used.\n","type":"integer","minimum":1,"maximum":99,"example":7},"include_null_date_of_birth":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional override for this upload indicating whether county searches include"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"records with a null date of birth. If omitted, your account's default setting"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is used (or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if not configured)."},"children":[]}]}]}],"type":"boolean","example":true},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose"},"regulated_user_type":{"type":"string","description":"Optional regulated user type applied to every row in a regulated bulk upload.\nSingle regulated check endpoints resolve this from the account's product\nconfiguration and do not accept it on the request body; bulk upload (and\nbatch runs) allow an explicit upload-level override for filtering exposure.\n","example":"regulated"},"filter_context":{"$ref":"#/components/schemas/filter_context"}},"additionalProperties":false}},"components/schemas/bulk_upload_error":{"id":"components/schemas/bulk_upload_error","kind":"json-schema","title":"bulk_upload_error","data":{"type":"object","description":"Validation or processing error associated with the upload or a row.","properties":{"code":{"type":"string","example":"validation_error"},"title":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Human-readable error summary returned to the client. For stored hash errors this"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is typically the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"detail"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" message from validation or processing (not a raw"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"database or stack trace)."},"children":[]}]}]}],"example":"missing required column header"},"source":{"type":["string","null"],"description":"Optional JSON pointer or column name pointing at the problem field.","example":"state"}},"required":["code","title"]}},"components/schemas/bulk_upload_file":{"id":"components/schemas/bulk_upload_file","kind":"json-schema","title":"bulk_upload_file","data":{"type":"object","description":"Metadata for an attached CSV or XLSX file, including a relative download URL.","properties":{"filename":{"type":"string","example":"county_batch.csv"},"content_type":{"type":"string","example":"text/csv"},"byte_size":{"type":"integer","example":2048},"human_readable_size":{"type":"string","example":"2 KB"},"download_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Path (or absolute URL when the API includes a host) to download the file."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Original CSV uses "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/bulk_uploads/{bulk_upload_id}/original"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Result CSV uses"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/bulk_uploads/{bulk_upload_id}/results?format=csv"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Detailed XLSX uses"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/v1/bulk_uploads/{bulk_upload_id}/results?format=xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"/v1/bulk_uploads/2b8313e8-b578-45a1-4efd-952b8313e890/original"}},"required":["filename","content_type","byte_size","human_readable_size","download_url"]}},"components/schemas/bulk_upload":{"id":"components/schemas/bulk_upload","kind":"json-schema","title":"bulk_upload","data":{"type":"object","description":"A CSV batch of checks for a single product. Instant products complete each row\nwhen the factory returns; county products submit asynchronously and finalize\nafter every row reaches a terminal state.\n","properties":{"id":{"$ref":"#/components/schemas/uuid"},"account_id":{"$ref":"#/components/schemas/uuid"},"product_configuration_id":{"$ref":"#/components/schemas/uuid"},"product_configuration_name":{"$ref":"#/components/schemas/bulk_upload_product_name"},"state":{"$ref":"#/components/schemas/bulk_upload_state"},"row_count":{"type":"integer","description":"Total rows accepted after CSV validation.","example":100},"row_count_success":{"type":"integer","description":"Rows that completed successfully.","example":97},"row_count_error":{"type":"integer","description":"Rows that failed validation or processing.","example":3},"additional_settings":{"$ref":"#/components/schemas/bulk_upload_settings"},"created_at":{"$ref":"#/components/schemas/datetime"},"updated_at":{"$ref":"#/components/schemas/datetime"},"errors":{"type":"array","description":"Upload-level validation or processing errors.","items":{"$ref":"#/components/schemas/bulk_upload_error"}},"original_file":{"$ref":"#/components/schemas/bulk_upload_file"},"result_file":{"description":"Summary CSV of per-row outcomes (present when attached).","$ref":"#/components/schemas/bulk_upload_file"},"detailed_result_file":{"description":"Detailed XLSX export (present when attached).","$ref":"#/components/schemas/bulk_upload_file"}},"required":["id","account_id","product_configuration_id","product_configuration_name","state","row_count","row_count_success","row_count_error","additional_settings","created_at","updated_at","errors"],"example":{"id":"2b8313e8-b578-45a1-4efd-952b8313e890","account_id":"1a7202d7-a467-34b0-3dec-841a7202d789","product_configuration_id":"3c9424f9-c689-56b2-5f0e-a63c9424f901","product_configuration_name":"county_criminal","state":"processing","row_count":2,"row_count_success":0,"row_count_error":0,"additional_settings":{"lookback_period_in_years":7},"created_at":"2026-08-05T12:00:00Z","updated_at":"2026-08-05T12:00:05Z","errors":[]}}},"components/schemas/bulk_upload_create_request":{"id":"components/schemas/bulk_upload_create_request","kind":"json-schema","title":"bulk_upload_create_request","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multipart form used to create a bulk upload."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/bulk-upload-csv-formats.md"},"children":[]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nested "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields must be sent as form parts (for example"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"settings[lookback_period_in_years]=7"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), not as a single JSON string part."},"children":[]}]}]}],"properties":{"product_name":{"$ref":"#/components/schemas/bulk_upload_product_name"},"original_file":{"type":"string","format":"binary","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CSV file ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".csv"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Max size is configured server-side."},"children":[]}]}]}]},"settings":{"$ref":"#/components/schemas/bulk_upload_settings"}},"required":["product_name","original_file"]}},"components/schemas/no_middle_name":{"id":"components/schemas/no_middle_name","kind":"json-schema","title":"no_middle_name","data":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to declare that the subject does not have a middle name."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Mutually exclusive with a non-empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the API rejects requests that"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supply both a present "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". An empty or null"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is allowed. A non-empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supplied with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Allowed with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may be sent together."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"That is not the same as supplying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — when the flag is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", parsing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stores only a first name and surname, and any token the parser would have treated as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a middle name is folded into the last name (for example "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name: \"John Quincy Doe\""},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"becomes first name "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"John"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and last name "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Quincy Doe"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" empty)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting this to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" clears a middle name already stored on a referenced profile."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplying a non-empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" without this field sets "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", products that perform criminal-record identity matching exclude records"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with a middle name, narrowing matches to subjects with no middle name on record."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When supplied with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the value is persisted to the referenced profile"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(same account-scoped profile the check is created against)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Leave as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or omit) if unsure."},"children":[]}]}]}]}},"components/schemas/masked_ssn_string":{"id":"components/schemas/masked_ssn_string","kind":"json-schema","title":"masked_ssn_string","data":{"type":"string","pattern":"^XXX-XX-\\d{4}$","description":"A masked US Social Security Number showing only the last four digits.","example":"XXX-XX-6789"}},"components/schemas/profile_fields":{"id":"components/schemas/profile_fields","kind":"json-schema","title":"profile_fields","data":{"type":"object","description":"Common fields used across profile-related schemas.","properties":{"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The full name of the person. Must not be combined with first_name, middle_name, or last_name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"May be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on create/update; when that flag is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", parsing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"stores only a first name and surname (any middle token is folded into the last name)."},"children":[]}]}]}],"type":"string"},"first_name":{"description":"The first name of the person.","type":"string"},"middle_name":{"description":"The middle name of the person. Can be null if not provided.","type":"string"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"The last name of the person.","type":"string"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"phone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A phone number in the form +[country code][number including area code]. (E.164 format)"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A U.S. number supplied in national format (for example \"(415) 555-0123\") is normalized to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"E.164 on write. If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/phone_string"},"country_code":{"description":"The phone country calling code supplied for a reverse phone verification (for example, \"1\" or \"54\").","type":"string"},"email":{"$ref":"#/components/schemas/email_string"},"ssn":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"US Social Security Number."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Masked by default"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — API responses return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Full SSN is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"available via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"?unmask_ssn=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on endpoints that support it (driver checks and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"identity verifications), subject to your account's product configuration. Contact"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your account representative to enable SSN unmasking."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on list/index endpoints"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /profiles"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), regardless"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"of masking or unmasking settings. Fetch the individual resource (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /profiles/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to see the masked or unmasked value for a specific record."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"May also be null on a single-resource response when no SSN was provided."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/ssn_string"},{"$ref":"#/components/schemas/masked_ssn_string"},{"type":"null"}],"example":"XXX-XX-6789"},"address":{"$ref":"#/components/schemas/address"},"addresses":{"$ref":"#/components/schemas/addresses"},"custom_id":{"$ref":"#/components/schemas/custom_id_string"},"driver_license_state":{"$ref":"#/components/schemas/state_code"},"driver_license_number":{"type":"string","description":"The driver license number. Format dependent on State.","example":"D1234567"}}}},"components/schemas/profile":{"id":"components/schemas/profile","kind":"json-schema","title":"profile","data":{"title":"profile","description":"A profile containing personal information used for checks and verifications.","type":"object","allOf":[{"properties":{"id":{"$ref":"#/components/schemas/profile_id"}}},{"$ref":"#/components/schemas/profile_fields"}]}},"components/schemas/record_category":{"id":"components/schemas/record_category","kind":"json-schema","title":"record_category","data":{"description":"A categorization of the type of record returned.\nMaps closely to the source category, except PA sources can contain either Patriot or Registry records.\n","type":"string","enum":["arrest","Criminal/traffic","Warrant","Sex Offender","Patriot","Registry"],"x-enumDescriptions":{"arrest":"arrest record (includes jail/prison records)","Criminal/traffic":"criminal record (includes traffic records)","Warrant":"warrant record","Sex Offender":"sex offender list record","Patriot":"watchlist records","Registry":"registry records (not necessarily implying wrongdoing, so excluded by default)"},"example":"Criminal/traffic"}},"components/schemas/source_category":{"id":"components/schemas/source_category","kind":"json-schema","title":"source_category","data":{"description":"A categorization of the type of source where the data was retrieved.\nSome of the categories may not imply wrongdoing, and are excluded by default.\n","type":"string","enum":["arrest","court","criminal registry","DOC","warrant","sex offender registry","domestic watchlist","foreign watchlist","healthcare registry","healthcare sanctions","financial registry","financial sanctions","other registry","other sanctions","PEP registry"],"x-enumDescriptions":{"arrest":"The source contains arrest records, typically from a sheriff's department or police department.","court":"The source is a municipal, county, or state court, or administrative office of courts (AOC).","criminal registry":"The source is a registry of violent or drug offenders","DOC":"The source is a local police jail, or state prison (DOC means Department of Correction.)","warrant":"The source is one which has requested the arrest of a person, typically a police department.","sex offender registry":"The source is a registry of sex offenders.  Typically at the state level.","domestic watchlist":"The source is a US-based list of some sort of offender.","foreign watchlist":"The source is a US-based list of some sort of offender, e.g. Interpol.","healthcare registry":"The source is a list of medical professionals in some capacity, and does not imply wrongdoing. (Excluded by default.)","healthcare sanctions":"The source is a list of medical professionals in some capacity, and implies wrongdoing.","financial registry":"The source is a list of financial professionals in some capacity, and does not imply wrongdoing. (Excluded by default.)","financial sanctions":"The source is a list of financial professionals in some capacity, and implies wrongdoing.","other registry":"The source is a list of people, and does not imply wrongdoing. (Excluded by default.)","other sanctions":"The source is a list of people, and implies wrongdoing.","PEP registry":"The source is a list of politically exposed people (e.g. politicians and world leaders) who potentially could be bribed or coerced into wrongdoing. (Excluded by default.)"},"example":"court"}},"components/schemas/source":{"id":"components/schemas/source","kind":"json-schema","title":"source","data":{"type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An identifier for the source.  E.g. \"cookil\" or \"NJ_Supreme_Ct_view\".  Can be used to programmatically exclude a source."},"children":[]}]}]}],"type":"string","example":"ARSTfranklinKY"},"category":{"$ref":"#/components/schemas/source_category","example":"arrest"},"name":{"description":"A human-understandable (English) name of the source.","type":"string","example":"KY Franklin County Inmates"},"county":{"description":"The name of the county (if any) where the record came from.","type":"string","example":"Franklin"},"county_fips_code":{"description":"The 5-digit FIPS code of the county where the record came from.\nPresent for county checks; omitted for sources without an associated county.\n","type":"string","example":"17031"},"state":{"$ref":"#/components/schemas/state_code"}}}},"components/schemas/record_core":{"id":"components/schemas/record_core","kind":"json-schema","title":"record_core","data":{"type":"object","properties":{"record_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A stable identifier for this record, derived from the record content."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record-{sha256_hash}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This ID is globally unique across all checks and can be referenced"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in adverse action requests to identify disqualifying records."},"children":[]}]}]}],"type":"string","example":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"},"category":{"$ref":"#/components/schemas/record_category"},"person":{"description":"Person attributes as reported on this record. Only fields that have a value are returned;\nmost records include only a subset of these fields.\n","type":"object","properties":{"first_name":{"type":"string","example":"John"},"middle_name":{"description":"middle initial or name or names","type":"string","example":"W"},"last_name":{"type":"string","example":"Smith"},"suffix":{"type":"string"},"full_name":{"type":"string","example":"Smith, John W."},"dob":{"$ref":"#/components/schemas/date_string_partial"},"last_collected_date":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date the provider last collected or observed this record. This person-level field is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned only for check-family products when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include_last_collected_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is enabled on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the product configuration. It is distinct from the Checkr-calculated "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record_date"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on an"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"individual charge."},"children":[]}]}]}],"$ref":"#/components/schemas/date_string_complete"},"inferred_dob":{"description":"Some records which do not already have a full DOB may have an inferred full DOB that was found by other means.\nFor example a record may have no dob, or only a partial dob, but we were able to inferred a full dob using other similar records.\n","$ref":"#/components/schemas/date_string_complete"},"doc_number":{"description":"Dept. of Corrections number.\nA number or identifier given by a state Dept. of Corrections to identify a person who went to prison.\n","type":"string"},"gender":{"description":"The gender, if any, as recorded by the source.  No specific format.","type":"string","example":"M"},"height":{"description":"The height, if any, as recorded by the source.  No specific format.","type":"string","example":"601"},"weight":{"description":"The weight, if any, as recorded by the source.  No specific format.","type":"string","example":"180"},"hair_color":{"description":"The hair color, if any, as recorded by the source.  No specific format.","type":"string","example":"BRN"},"eye_color":{"description":"The eye color if any, as recorded by the source.  No specific format.","type":"string","example":"HAZ"},"skin_color":{"description":"The skin color, if any, as recorded by the source.  No specific format.","type":"string","example":"wht"},"race":{"description":"The race as defined by the source.  No specific format.","type":"string","example":"W"},"ethnicity":{"description":"The ethnicity, if any, as recorded by the source.  No specific format.","type":"string","example":"Hispanic-American"},"physical_build":{"description":"The physical build, if any, as recorded by the source.  No specific format.","type":"string","example":"BROAD"},"physical_marks":{"description":"Scars, marks, and tattoos as defined by the source.  No specific format.","type":"string","example":"blue cross on outside left ankle"},"photo_urls":{"description":"A set of URLs referencing pictures of this person, as recorded by the source.","type":"array","items":{"description":"A public URL which has an image, as recorded by the source.\nSometimes, the picture is an image which shows the text \"No Image Available.\"\nWe are working on removing those, but you may still encounter them.\n","type":"string","format":"uri"}},"name_aliases":{"description":"Other names that this person may have gone by.","type":"array","items":{"type":"string","example":"Johnny Smith"}},"dob_aliases":{"description":"Other dates of birth that this person may have used.","type":"array","items":{"type":"string","example":"19940321"}},"addresses":{"description":"Addresses associated with this person on this record, as reported by the data source.\nOmitted when the source provides no address information. Each entry may be partial.\n","type":"array","items":{"$ref":"#/components/schemas/address_as_reported"},"example":[{"street":"123 Main St","city":"Frankfort","state":"KY","zip_code":"40601"},{"street":"OFFENDER REPORTS MOVED OUT OF UTAH"}]}}},"source":{"$ref":"#/components/schemas/source"}}}},"components/schemas/case_core":{"id":"components/schemas/case_core","kind":"json-schema","title":"case_core","data":{"type":"object","properties":{"case_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A stable identifier for this case, derived from the case content."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case-{sha256_hash}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","example":"case-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"},"case_number":{"description":"The case number assigned by a court.  Not present for records which are not from a court.  Format varies.","type":"string","example":"2025-99999"},"type":{"description":"The case type as reported by the court.  Not present for records which are not from a court.  Format varies.","type":"string"},"status":{"description":"The case status as reported by the court.  Sparsely available.  Format varies.","type":"string"},"file_date":{"description":"The date the case was filed as reported by the court.  Not present for records which are not from a court.","$ref":"#/components/schemas/date_string_partial"},"arresting_agency":{"description":"The name of the arresting agency.","type":"string","example":"Franklin County Sheriff"},"arrest_date":{"description":"The date the person was arrested.","$ref":"#/components/schemas/date_string_partial"},"court_name":{"description":"The name of the charging court.","type":"string","example":"Franklin County Circuit Court"},"court_county":{"description":"The county of the charging court.","type":"string","example":"Franklin"}}}},"components/schemas/identity_match_confidence_level":{"id":"components/schemas/identity_match_confidence_level","kind":"json-schema","title":"identity_match_confidence_level","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identity match confidence"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this case. When present, it indicates how strongly this criminal case aligns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"with the PII you submitted for the check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The values "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"medium"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"low"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are assigned based on Checkr's proprietary ML algorithm."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Other values:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unknown"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — identity matching was enabled for the check but a confidence label could not be determined for this case. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"insufficient_information"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — identity matching was skipped (for example, insufficient identifiers); check "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"run_notes"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for context."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Absence:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Omitted when identity matching was not enabled for the check. Reach out to support@checkrtrust.com if you are interested in enabling this feature"},"children":[]}]}]}],"type":"string","enum":["high","medium","low","unknown","insufficient_information"],"example":"high","x-enumDescriptions":{"high":"Strong identity alignment with the searched subject.","medium":"Moderate alignment with the searched subject.","low":"Weak alignment with the searched subject.","unknown":"Identity matching was on, but no confidence label was available for this case.","insufficient_information":"Identity matching did not run for this check (often due to insufficient PII)."}}},"components/schemas/charge_type":{"id":"components/schemas/charge_type","kind":"json-schema","title":"category","data":{"description":"the type (level, severity) of a charge","type":"string","title":"category","enum":["felony","misdemeanor","petty_offense","unknown"],"example":"petty_offense"}},"components/schemas/charge_category":{"id":"components/schemas/charge_category","kind":"json-schema","title":"category","data":{"description":"the highest level of categorization of a charge","type":"string","title":"category","enum":["Criminal Intent","Drugs & Alcohol","Fraud & Deception","Homicide","Security","Sexual","Statutory","Theft & Property","Vehicles & Traffic","Violence","unclassified"],"example":"Theft & Property"}},"components/schemas/charge_subcategory":{"id":"components/schemas/charge_subcategory","kind":"json-schema","title":"subcategory","data":{"description":"the second level of categorization of a charge","type":"string","title":"subcategory","enum":["Accessory","Conspiracy","Court Orders","Criminal Tools","Obstruction","Organized Crime","Alcohol & Tobacco","Driving under the Influence (DUI)","Drugs-Marijuana Possession/Use","Drugs-Possession/Use","Drugs-Sale & Manufacture","Bribery & Corruption","Business & Tax","Cyber Crimes","Embezzlement","Forgery","Fraud","Identity Theft & Impersonation","Worthless Check","Attempted Homicide","Intentional Homicide","Unintentional Killing","Immigration","Terrorism","Treason","Lewd Behavior","Prostitution","Sexual Abuse","Animal Ordinances","Custody & Support","Fish & Game","Gambling","Miscellaneous Citations & Violations","Public Nuisance","Safety & Zoning","Arson","Burglary","Petty Theft","Possession of Stolen Property","Robbery","Theft","Trespassing","Vandalism & Mischief","License & Registration","Parking","Speeding","Unsafe Operation","Vehicle Equipment","Abduction & Restraint","Animal Cruelty","Assault & Battery","Child & Elder Abuse","Disorderly Behavior","Harassment & Threats","Weapons & Endangerment","unclassified"],"example":"Petty Theft"}},"components/schemas/charge_subsubcategory":{"id":"components/schemas/charge_subsubcategory","kind":"json-schema","title":"subsubcategory","data":{"description":"The lowest (most detailed) level of categorization of a charge.\nThere are over 250 of these.\nThey are one of the categorizations on which rulesets operate.\n","type":"string","title":"subsubcategory","example":"Retail Theft"}},"components/schemas/sentence":{"id":"components/schemas/sentence","kind":"json-schema","title":"sentence","data":{"type":"object","properties":{"conviction_date":{"$ref":"#/components/schemas/date_string_partial"},"begin_date":{"description":"Date the sentence began, if reported.","$ref":"#/components/schemas/date_string_partial"},"actual_release_date":{"description":"Date the person was actually released, if reported.","$ref":"#/components/schemas/date_string_partial"},"scheduled_release_date":{"description":"Scheduled release date, if reported.","$ref":"#/components/schemas/date_string_partial"},"release_type":{"description":"Type of release, if reported.","type":"string"},"details":{"description":"Description of the sentence, if any","type":"string","example":"fine, 1D"}}}},"components/schemas/disposition_type":{"id":"components/schemas/disposition_type","kind":"json-schema","title":"disposition_type","data":{"description":"the type of disposition","type":"string","enum":["Conviction","Dismissed","Invalid","Merged","Pending","Transferred","Warrant","Unclassified"],"example":"Conviction"}},"components/schemas/disposition":{"id":"components/schemas/disposition","kind":"json-schema","title":"disposition","data":{"type":"object","properties":{"disposition":{"description":"A description of the disposition, as provided by the court, if any.","type":"string","example":"GLT"},"disposition_date":{"$ref":"#/components/schemas/date_string_partial"},"disposition_type":{"$ref":"#/components/schemas/disposition_type"}}}},"components/schemas/charge":{"id":"components/schemas/charge","kind":"json-schema","title":"charge","data":{"type":"object","properties":{"charge_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A stable identifier for this charge, derived from the charge content."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"charge-{sha256_hash}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","example":"charge-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"},"description":{"description":"The description of the offense, as reported on the record.  Format varies.","type":"string","example":"SHOPLIFTING"},"offense_date":{"description":"The date the offense was committed, as reported on the record.","$ref":"#/components/schemas/date_string_partial"},"legal_code":{"description":"Legal code (statute) as reported by the court or arresting agency.","type":"string","example":"433.234"},"type":{"$ref":"#/components/schemas/charge_type"},"category":{"$ref":"#/components/schemas/charge_category"},"subcategory":{"$ref":"#/components/schemas/charge_subcategory"},"subsubcategory":{"$ref":"#/components/schemas/charge_subsubcategory"},"record_date":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of the record."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is not part of the record itself."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is a field calculated by Checkr Trust."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It is the field used to determine if the charge is within the lookback period."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Although there are many other situations, often a convicted charge has a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record_date which is the disposition_date, and a non-conviction charge"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"has a record_date which is the filing date."},"children":[]}]}]}],"$ref":"#/components/schemas/date_string_partial"},"city":{"description":"The name of the city where the person was charged","type":"string","example":"Indian Hills"},"county":{"description":"The name of the county where the person was charged","type":"string","example":"Jefferson"},"state":{"description":"The state where the person was charged","type":"string","example":"KY"},"sentences":{"type":"array","items":{"$ref":"#/components/schemas/sentence"}},"dispositions":{"type":"array","items":{"$ref":"#/components/schemas/disposition"}}}}},"components/schemas/case":{"id":"components/schemas/case","kind":"json-schema","title":"case","data":{"allOf":[{"$ref":"#/components/schemas/case_core"},{"type":"object","properties":{"identity_match_confidence_level":{"$ref":"#/components/schemas/identity_match_confidence_level"},"charges":{"description":"Only fields that have a value are returned.  Most charges will have only a subset of these fields.","type":"array","items":{"$ref":"#/components/schemas/charge"}}}}]}},"components/schemas/record":{"id":"components/schemas/record","kind":"json-schema","title":"record","data":{"title":"record","allOf":[{"$ref":"#/components/schemas/record_core"},{"type":"object","properties":{"cases":{"description":"Only fields that have a value are returned.  Most cases will have only a subset of these fields.","type":"array","items":{"$ref":"#/components/schemas/case"}}}}]}},"components/schemas/check_type":{"id":"components/schemas/check_type","kind":"json-schema","title":"check_type","data":{"type":"string","enum":["instant_criminal","sex_offender_registry"]}},"components/schemas/check":{"id":"components/schemas/check","kind":"json-schema","title":"check","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array of criminal "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"records"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". When no records are found, this is an empty array."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Confidence scoring:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Each record's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cases[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entries may include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identity_match_confidence_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":","},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"summarizing identity-match confidence for that case. See the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema and the Instant Criminal Checks tag description."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/record"}},"check_type":{"$ref":"#/components/schemas/check_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"run_notes":{"description":"An unstructured array of human-readable notes about this particular check.\nMay contain notes about how input was parsed,\nor other information about results.\nNot intended to be parsed by computer, as these notes are not guaranteed to be in any given format.\n","type":"array","items":{"type":"string","example":"changed last_name from 'Smith Jr' to 'Smith'"}},"results_found":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=results_found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When present, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array is omitted."},"children":[]}]}]}],"type":"boolean"},"rulesets_applied":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=rulesets_applied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_applied"}}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"check with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"check with profile object"}]}},"components/schemas/name_full_or_split_required":{"id":"components/schemas/name_full_or_split_required","kind":"json-schema","title":"name_full_or_split_required","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exactly one name format must be provided: either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" alone, or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optionally with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Combining "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with a name-part field"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") is rejected. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may be sent"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alongside either format."},"children":[]}]}]}],"oneOf":[{"title":"name-parts","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide first_name and last_name (without full_name)."},"children":[]}]}]}],"required":["first_name","last_name"],"not":{"required":["full_name"]}},{"title":"full-name","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide full_name (without first_name, middle_name, or last_name)."},"children":[]}]}]}],"required":["full_name"],"not":{"anyOf":[{"required":["first_name"]},{"required":["middle_name"]},{"required":["last_name"]}]}}]}},"components/schemas/middle_name_no_middle_name_exclusive":{"id":"components/schemas/middle_name_no_middle_name_exclusive","kind":"json-schema","title":"middle_name_no_middle_name_exclusive","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Rejects a non-empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Matches runtime validation ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be present/non-blank to conflict)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Empty or null "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is allowed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not covered here — it may be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (see"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the shared "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema)."},"children":[]}]}]}],"properties":{"middle_name":{"type":"string"},"no_middle_name":{"type":"boolean"}},"not":{"required":["middle_name","no_middle_name"],"properties":{"middle_name":{"type":"string","minLength":1},"no_middle_name":{"enum":[true]}}}}},"components/schemas/check_request_allow_duplicate_criminal_records":{"id":"components/schemas/check_request_allow_duplicate_criminal_records","kind":"json-schema","title":"check_request_allow_duplicate_criminal_records","data":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Multi-source deduplication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" runs by default for instant criminal, targeted instant criminal,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"sex offender registry, and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"criminal_check"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /v1/criminal_checks"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). It may merge or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"suppress duplicate rows across data providers."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or omit:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" apply deduplication for this check."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" skip multi-source deduplication; results may include duplicate source rows in storage"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and in API responses (and webhooks for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"criminal_check"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create-time only:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" send on create; not a query parameter on "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"components/schemas/check-request-from-pii":{"id":"components/schemas/check-request-from-pii","kind":"json-schema","title":"check-request-from-pii","data":{"type":"object","properties":{"check_type":{"$ref":"#/components/schemas/check_type"},"input_type":{"$ref":"#/components/schemas/input_type"},"first_name":{"description":"first name (given name).  Do not include prefixes, like \"Ms.\" or \"Dr.\"","type":"string","example":"Jane"},"middle_name":{"description":"middle name(s)","type":"string","example":"Mary Louise"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"last name (surname).  Do not include suffixes, like \"Jr.\" or \"2nd\".","type":"string","example":"O'Donnell-Van Helsing"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and then use those for the check. With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"into the last name instead of being stored as a middle name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you already know the first and last names, we suggest sending them."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The parser will attempt to remove prefixes and suffixes, and handles several different formats of name,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but we cannot guarantee it will parse the name in the manner you expect."},"children":[]}]}]}],"type":"string","example":"O'Donnell-Van Helsing, Dr. Jane Mary Louise, MD"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"description":"Social Security Number used for additional identity verification and record matching","$ref":"#/components/schemas/ssn_string"},"phone":{"$ref":"#/components/schemas/phone_string"},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-check-addresses-field-criminal-search.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"},"order_by":{"$ref":"#/components/schemas/order_by"},"allow_duplicate_criminal_records":{"$ref":"#/components/schemas/check_request_allow_duplicate_criminal_records"}},"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"JOHN","last_name":"SMITH","dob":"19900101","ssn":"123-45-6789","phone":"+14155552671","addresses":[{"street":"456 Oak Ave","city":"Los Angeles","state":"CA","zip_code":"90001"},{"street":"789 Pine Blvd","city":"San Diego","state":"CA","zip_code":"92101"}]}}},"components/schemas/check_type_sex_offender_registry":{"id":"components/schemas/check_type_sex_offender_registry","kind":"json-schema","title":"check_type","data":{"type":"string","title":"check_type","enum":["sex_offender_registry"]}},"components/schemas/address_request":{"id":"components/schemas/address_request","kind":"json-schema","title":"address_request","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An address to be searched for records."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In searching by address, records are matched by street number, street name, city, and state"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unit/apartment numbers are not used for matching addresses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Street types (Avenue, Street, Boulevard) are not used for matching addresses"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, \"123 Main St., Apt. 3B\" will match using \"123\" and \"Main\""},"children":[]}]}]}]}],"allOf":[{"$ref":"#/components/schemas/address"}]}},"components/schemas/check-request-from-address":{"id":"components/schemas/check-request-from-address","kind":"json-schema","title":"check-request-from-address","data":{"description":"the request to create a new check using an address","properties":{"check_type":{"$ref":"#/components/schemas/check_type_sex_offender_registry"},"input_type":{"$ref":"#/components/schemas/input_type_address"},"address":{"$ref":"#/components/schemas/address_request","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-inline-address-persistence-singular-or-plural.md"},"children":[]}]},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"},"order_by":{"$ref":"#/components/schemas/order_by"},"allow_duplicate_criminal_records":{"$ref":"#/components/schemas/check_request_allow_duplicate_criminal_records"}},"required":["check_type","input_type","address"],"example":{"check_type":"sex_offender_registry","input_type":"address","address":{"street":"123 Main Street","city":"New York","state":"NY","zip_code":"12345"}}}},"components/schemas/check-request-from-profile":{"id":"components/schemas/check-request-from-profile","kind":"json-schema","title":"check-request-from-profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a check from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"properties":{"check_type":{"$ref":"#/components/schemas/check_type"},"input_type":{"$ref":"#/components/schemas/input_type"},"profile_id":{"$ref":"#/components/schemas/profile_id"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"source_states":{"$ref":"#/components/schemas/source_states"},"order_by":{"$ref":"#/components/schemas/order_by"},"allow_duplicate_criminal_records":{"$ref":"#/components/schemas/check_request_allow_duplicate_criminal_records"}},"required":["profile_id"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080"}}},"components/schemas/check_type_driver_license_status":{"id":"components/schemas/check_type_driver_license_status","kind":"json-schema","title":"check_type_driver_license_status","data":{"type":"string","enum":["driver_license_status"]}},"components/schemas/driver_check_driver_license_status_result":{"id":"components/schemas/driver_check_driver_license_status_result","kind":"json-schema","title":"driver_license_status_result","data":{"title":"driver_license_status_result","type":"object","properties":{"requested_profile":{"type":"object","allOf":[{"$ref":"#/components/schemas/profile_fields"}],"description":"The inputs used to create the driver check. Fields that weren't provided will not be included."},"passenger":{"type":"object","properties":{"validity":{"type":"string","enum":["VALID","INVALID","NOT FOUND"],"x-enumDescriptions":{"VALID":"The license number is valid and reflects the authorization to drive a passenger vehicle.","INVALID":"The license number is invalid and cannot be used to drive a passenger vehicle.","NOT FOUND":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We did not find a definitive result for this license. This could indicate the 'requested_profile' values had an error / typo. Another possibility is that we were unable to determine the 'ssn' and/or 'zip_code' fields, they are required for the requested state, and they weren't provided in the requested_profile."},"children":[]}]}]}]}}}}}}},"components/schemas/driver_check_driver_license_status":{"id":"components/schemas/driver_check_driver_license_status","kind":"json-schema","title":"driver_check_driver_license_status","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"description":"A datetime, or null if not completed.","oneOf":[{"$ref":"#/components/schemas/datetime"},{"type":"null"}]},"results":{"description":"Results, or null if not completed.","oneOf":[{"$ref":"#/components/schemas/driver_check_driver_license_status_result"},{"type":"null"}]},"check_type":{"$ref":"#/components/schemas/check_type_driver_license_status"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"check_type":{"$ref":"#/components/schemas/check_type_driver_license_status"}},"title":"driver license status with profile id","required":["profile_id"]},{"properties":{"profile":{"$ref":"#/components/schemas/profile"},"check_type":{"$ref":"#/components/schemas/check_type_driver_license_status"}},"title":"driver license status with profile object","required":["profile"]}]}},"components/schemas/check_type_motor_vehicle_report":{"id":"components/schemas/check_type_motor_vehicle_report","kind":"json-schema","title":"check_type_motor_vehicle_report","data":{"type":"string","enum":["motor_vehicle_report"]}},"components/schemas/driver_check_result_code":{"id":"components/schemas/driver_check_result_code","kind":"json-schema","title":"result_code","data":{"type":"string","title":"result_code","enum":["FOUND","NOT FOUND","REJECTED","LOCKED"],"x-enumDescriptions":{"FOUND":"motor vehicle report yielded results","NOT FOUND":"motor vehicle report information yielded no results","REJECTED":"motor vehicle report information was invalid or an unknown error occurred","LOCKED":"the motor vehicle report is not available electronically"}}},"components/schemas/driver_event":{"id":"components/schemas/driver_event","kind":"json-schema","title":"driver_event","data":{"title":"driver_event","type":"object","properties":{"description":{"type":"string","description":"A description of the event"},"code":{"type":"string","description":"Normalized code for this type of event"},"acd_code":{"type":"string","description":"Normalized AAMVA Code Dictionary (ACD) code for this event"},"type":{"type":"string","description":"The type of event (conviction, suspension, etc.)"},"jurisdiction":{"type":"string","description":"The jurisdiction the event took place in"},"location":{"type":"string","description":"A more specific location of the event (if provided)"},"date":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date the event occurred"},"disposition_date":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"The date the disposition took effect (if provided)"},"disposition":{"type":"string","description":"The current status or final outcome of the event"},"points":{"type":"string","description":"(Jurisdiction-specific) the number of points affected, added, etc."},"additional_detail":{"type":"string","description":"Additional detail about the event normally pertaining to speed such as the speed the vehicle was traveling, how fast it was going above the speed limit, whether or not the vehicle was traveling over 100 MPH, etc."}}}},"components/schemas/driver_crash":{"id":"components/schemas/driver_crash","kind":"json-schema","title":"driver_crash","data":{"title":"driver_crash","type":"object","properties":{"date":{"$ref":"#/components/schemas/date","description":"The date the crash occurred"},"type":{"type":"string","description":"The type of crash"},"jurisdiction":{"type":"string","description":"The jurisdiction where the crash occurred."},"location":{"type":"string","description":"A more specific location of the crash (if provided)"},"description":{"type":"string","description":"A description of the crash"},"severity":{"type":"string","enum":["AC0","AC1","AC2","AC3","NEW"],"x-enumDescriptions":{"AC0":"Undeclared","AC1":"Property Damage","AC2":"Injury","AC3":"Fatality","NEW":"Unassigned"}},"was_citation_issued":{"type":"boolean","description":"Whether or not a citation was issued for this crash"},"comments":{"type":"array","description":"Information related to the section that could not be associated with a named field","items":{"type":"string"}}}}},"components/schemas/driver_jurisdiction_action":{"id":"components/schemas/driver_jurisdiction_action","kind":"json-schema","title":"jurisdiction_action","data":{"title":"jurisdiction_action","type":"object","properties":{"type":{"type":"string","description":"The type of action taken (i.e. suspension, revocation, withdrawal, etc.)"},"group":{"description":"Removal of Driving Privileges (RDP) Group. This provides additional context as to why an action was taken.","type":"string","pattern":"^RDP[0-9]{2}$","enum":["RDP00","RDP01","RDP10","RDP11","RDP20","RDP30","RDP31","RDP32","RDP33","RDP40","RDP50","RDP60","RDP70","RDP71"],"x-enumDescriptions":{"RDP00":"Unspecified","RDP01":"Unassignable","RDP10":"Alcohol or Drug Influence","RDP11":"Alcohol or Drug Related (Non-Driving)","RDP20":"Cumulative (too many violations)","RDP30":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Other Actions (Unlicensed, Reckless, Hit & Run, etc.)"},"children":[]}]}]}],"RDP31":"Driving While Barred","RDP32":"Reckless Driving","RDP33":"Vehicle Use in Prohibited Offenses","RDP40":"Failure to Pay / Failure to Appear","RDP50":"Financial Responsibilty (no insurance at time of crash, cancellation of insurance, etc.)","RDP60":"Non-DMV-Related","RDP70":"DMV-Related","RDP71":"CDL Downgrade"}},"start_date":{"description":"The date the action became effective","$ref":"#/components/schemas/date"},"end_date":{"description":"The date the action is no longer effective","$ref":"#/components/schemas/date"},"extent_of_action":{"description":"The extent of what privileges are affected by this action","type":"string"},"description":{"description":"A description of the action","type":"string"},"initiating_jurisdiction":{"description":"The jurisdiction that took or initiated this action","type":"string","pattern":"^[A-Za-z]{2}$"},"comments":{"description":"Information related to the section that could not be associated with a named field.","type":"array","items":{"type":"string"}}}}},"components/schemas/driver_license_type":{"id":"components/schemas/driver_license_type","kind":"json-schema","title":"type","data":{"description":"If the license type is PREVIOUS or OUT OF STATE, the rest of the license information may not be present.","type":"string","title":"type","enum":["CDL","CDL PERMIT","MOTORCYCLE","MOTORCYCLE PERMIT","PASSENGER","PASSENGER PERMIT","MOPED","ID CARD","PREVIOUS","OUT OF STATE"],"example":"PASSENGER"}},"components/schemas/driver_license_validity":{"id":"components/schemas/driver_license_validity","kind":"json-schema","title":"validity","data":{"type":"string","title":"validity","enum":["VALID","INVALID","UNKNOWN"],"example":"VALID"}},"components/schemas/driver_license_license_dls":{"id":"components/schemas/driver_license_license_dls","kind":"json-schema","title":"license","data":{"title":"license","type":"object","properties":{"type":{"$ref":"#/components/schemas/driver_license_type"},"validity":{"$ref":"#/components/schemas/driver_license_validity"},"jurisdiction":{"description":"The jurisdiction that issued the license","type":"string","pattern":"^[A-Za-z]{2}$"},"number":{"description":"The license number. Format dependent on State.","type":"string"},"class_code":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code representing the license class (may not have a value if class_description is provided)"},"children":[]}]}]}],"type":"string"},"class_description":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description of the license class (may not have a value if class_code is provided)"},"children":[]}]}]}],"type":"string"},"status_code":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Code representing the license status (may not have a value if status_description is provided)"},"children":[]}]}]}],"type":"string"},"status_description":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description of the license status (may not have a value if status_code is provided)"},"children":[]}]}]}],"type":"string"},"issued_on":{"$ref":"#/components/schemas/datetime","description":"The date the license was issued (may or may not be present)"},"expires_on":{"$ref":"#/components/schemas/datetime","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date the license expires"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: the following jurisdictions do not provide this information:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Hawaii (HI)"},"children":[]}]}]}]}]}}}},"components/schemas/driver_license_restriction":{"id":"components/schemas/driver_license_restriction","kind":"json-schema","title":"restriction","data":{"title":"restriction","type":"object","properties":{"code":{"description":"Code for the restriction","type":"string"},"description":{"description":"Description of the restriction","type":"string"},"category":{"description":"The category of restriction","type":"string"}}}},"components/schemas/driver_license_endorsement":{"id":"components/schemas/driver_license_endorsement","kind":"json-schema","title":"endorsement","data":{"title":"endorsement","type":"object","properties":{"code":{"description":"Code for the endorsement","type":"string"},"description":{"description":"Description of the endorsement","type":"string"},"category":{"description":"The category of endorsement","type":"string"}}}},"components/schemas/driver_license_license_mvr":{"id":"components/schemas/driver_license_license_mvr","kind":"json-schema","title":"license","data":{"title":"license","type":"object","allOf":[{"$ref":"#/components/schemas/driver_license_license_dls"},{"type":"object","properties":{"restrictions":{"description":"Restrictions that apply to the license (must wear corrective lenses, cannot operate a certain type of vehicle, etc.)","type":"array","items":{"$ref":"#/components/schemas/driver_license_restriction"}},"endorsements":{"description":"Endorsements applied to the license (can drive school buses, drive HAZMAT vehicles, drive truck with double or triple trailers, etc.)","type":"array","items":{"$ref":"#/components/schemas/driver_license_endorsement"}},"comments":{"description":"Information related to the section that could not be associated with a named field","type":"array","items":{"type":"string"}}}}]}},"components/schemas/driver_license_miscellaneous":{"id":"components/schemas/driver_license_miscellaneous","kind":"json-schema","title":"miscellaneous","data":{"title":"miscellaneous","type":"object","properties":{"date":{"description":"A date associated with this miscellaneous information (if provided)","$ref":"#/components/schemas/date"},"description":{"description":"A description of the miscellaneous information","type":"string"},"comments":{"description":"Information related to the section that could not be associated with a named field","type":"array","items":{"type":"string"}}}}},"components/schemas/driver_check_motor_vehicle_report_result":{"id":"components/schemas/driver_check_motor_vehicle_report_result","kind":"json-schema","title":"motor_vehicle_report_result","data":{"title":"motor_vehicle_report_result","type":"object","properties":{"order_details":{"description":"Order metadata","type":"object","properties":{"result_code":{"$ref":"#/components/schemas/driver_check_result_code"}}},"driver_information":{"description":"Information regarding the driver's PII","type":"object","properties":{"date_of_birth":{"type":"string","format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The driver's date of birth"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: the following jurisdictions do not provide this information:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Georgia (GA)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Illinois (IL)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"New Jersey (NJ)"},"children":[]}]}]}]}]},"license":{"description":"License information","type":"object","properties":{"number":{"type":"string","description":"The license number"},"jurisdiction":{"type":"string","description":"The jurisdiction that issued the license"}}},"name":{"description":"The driver's name broken into separate fields","type":"object","properties":{"first":{"type":"string","description":"The driver's first name"},"middle":{"type":"string","description":"The driver's middle name"},"last":{"type":"string","description":"The driver's last name"},"suffix":{"type":"string","description":"The driver's name suffix"},"raw":{"type":"string","description":"The driver's full name as received"}}}}},"driver_events":{"description":"Events on a driver's record (convictions, violations, citations, abstracts, etc.)","type":"array","items":{"$ref":"#/components/schemas/driver_event"}},"crashes":{"description":"Crashes on a driver's record","type":"array","items":{"$ref":"#/components/schemas/driver_crash"}},"jurisdiction_actions":{"description":"Actions taken by a jurisdiction on or against a driver (suspensions, revocations, withdrawals, etc.)","type":"array","items":{"$ref":"#/components/schemas/driver_jurisdiction_action"}},"licenses":{"description":"Licenses associated with the driver","type":"array","items":{"$ref":"#/components/schemas/driver_license_license_mvr"}},"miscellaneous":{"description":"Miscellaneous information that could not be categorized into permanent data attributes","type":"array","items":{"$ref":"#/components/schemas/driver_license_miscellaneous"}}}}},"components/schemas/driver_check_motor_vehicle_report":{"id":"components/schemas/driver_check_motor_vehicle_report","kind":"json-schema","title":"driver_check_motor_vehicle_report","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"description":"A datetime, or null if not completed.","oneOf":[{"$ref":"#/components/schemas/datetime"},{"type":"null"}]},"results":{"description":"Results, or null if not completed.","oneOf":[{"$ref":"#/components/schemas/driver_check_motor_vehicle_report_result"},{"type":"null"}]},"profile_id":{"$ref":"#/components/schemas/profile_id"},"profile":{"$ref":"#/components/schemas/profile"},"check_type":{"$ref":"#/components/schemas/check_type_motor_vehicle_report"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"check_type":{"$ref":"#/components/schemas/check_type_motor_vehicle_report"}},"title":"motor vehicle report with profile id","required":["profile_id","check_type"]},{"properties":{"profile":{"$ref":"#/components/schemas/profile"},"check_type":{"$ref":"#/components/schemas/check_type_motor_vehicle_report"}},"title":"motor vehicle report with profile object","required":["profile"]}]}},"components/schemas/driver_check_type":{"id":"components/schemas/driver_check_type","kind":"json-schema","title":"check_type","data":{"type":"string","title":"check_type","enum":["driver_license_status","motor_vehicle_report"]}},"components/schemas/driver-check-request-from-pii":{"id":"components/schemas/driver-check-request-from-pii","kind":"json-schema","title":"driver-check-request-from-pii","data":{"type":"object","description":"Create a driver check by providing PII directly.","properties":{"first_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First name of the person. Required (with last_name) when not sending full_name."},"children":[]}]}]}]},"last_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Last name of the person. Required (with first_name) when not sending full_name."},"children":[]}]}]}]},"full_name":{"type":"string","description":"Either send the full name, or first and last names, but not both.\nIf you send a full name, we will attempt to parse it into first name, middle name(s) and last name.\nIf you already know the first and last names, we suggest sending them.\n","example":"Jane Doe"},"dob":{"$ref":"#/components/schemas/date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth (ISO 8601 date string)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"driver_license_number":{"type":"string","description":"Driver license number"},"driver_license_state":{"$ref":"#/components/schemas/state_code","description":"State that issued the driver license"},"check_type":{"$ref":"#/components/schemas/driver_check_type"},"zip_code":{"$ref":"#/components/schemas/zip_code","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-driver-check-zip-code-field.md"},"children":[]}]},"address":{"$ref":"#/components/schemas/address","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-driver-check-address-field.md"},"children":[]}]},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-driver-check-addresses-field.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"required":["driver_license_number","driver_license_state","check_type"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"}],"example":{"first_name":"Jane","last_name":"Doe","dob":"1990-01-15","driver_license_number":"12345678","driver_license_state":"TX","check_type":"motor_vehicle_report","addresses":[{"street":"123 Main St","city":"Austin","state":"TX","zip_code":"78701","country":"US"}]}}},"components/schemas/driver-check-request-from-profile":{"id":"components/schemas/driver-check-request-from-profile","kind":"json-schema","title":"driver-check-request-from-profile","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a driver check from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"check_type":{"$ref":"#/components/schemas/driver_check_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"required":["profile_id","check_type"]}},"components/schemas/driver_check":{"id":"components/schemas/driver_check","kind":"json-schema","title":"driver_check","data":{"oneOf":[{"$ref":"#/components/schemas/driver_check_driver_license_status"},{"$ref":"#/components/schemas/driver_check_motor_vehicle_report"}]}},"components/schemas/driver-license-status-completed-event-body":{"id":"components/schemas/driver-license-status-completed-event-body","kind":"json-schema","title":"driver-license-status-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a driver license status check completes. The embedded "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is included in masked form ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") only. To retrieve the full SSN, call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/driver_checks/{driver_check_id}?unmask_ssn=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the unmasked value appears"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results_v2.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), not in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["driver_license_status.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"$ref":"#/components/schemas/driver_check_driver_license_status_result"},"profile":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile associated with this check. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is included in masked form ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") only."},"children":[]}]}]}],"$ref":"#/components/schemas/profile"},"check_type":{"$ref":"#/components/schemas/check_type_driver_license_status"},"reference_id":{"$ref":"#/components/schemas/reference_id"}}},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/motor-vehicle-report-completed-event-body":{"id":"components/schemas/motor-vehicle-report-completed-event-body","kind":"json-schema","title":"motor-vehicle-report-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a motor vehicle report check completes. The embedded "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is included in masked form ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") only. To retrieve the full SSN, call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/driver_checks/{driver_check_id}?unmask_ssn=true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; the unmasked value appears"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.requested_profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", not in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile.ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["motor_vehicle_report.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"$ref":"#/components/schemas/driver_check_motor_vehicle_report_result"},"profile":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile associated with this check. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is included in masked form ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") only."},"children":[]}]}]}],"$ref":"#/components/schemas/profile"},"check_type":{"$ref":"#/components/schemas/check_type_motor_vehicle_report"},"reference_id":{"$ref":"#/components/schemas/reference_id"}}},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/attribute_match_score":{"id":"components/schemas/attribute_match_score","kind":"json-schema","title":"attribute_match_score","data":{"description":"0 if an attribute does not match, 100 if it matches","type":"integer","enum":[0,100]}},"components/schemas/attribute_match_scores":{"id":"components/schemas/attribute_match_scores","kind":"json-schema","title":"attribute_match_scores","data":{"description":"attribute match scores","type":"object","properties":{"first_name":{"$ref":"#/components/schemas/attribute_match_score"},"last_name":{"$ref":"#/components/schemas/attribute_match_score"},"dob":{"$ref":"#/components/schemas/attribute_match_score"},"phone":{"$ref":"#/components/schemas/attribute_match_score"},"email":{"$ref":"#/components/schemas/attribute_match_score"},"address":{"$ref":"#/components/schemas/attribute_match_score"},"city":{"$ref":"#/components/schemas/attribute_match_score"},"state":{"$ref":"#/components/schemas/attribute_match_score"},"zip_code":{"$ref":"#/components/schemas/attribute_match_score"},"ssn":{"$ref":"#/components/schemas/attribute_match_score"}},"example":{"first_name":100,"last_name":100,"dob":100,"phone":100,"email":0,"address":100,"city":100,"state":100,"zip_code":100,"ssn":0}}},"components/schemas/attribute_match_score_overall":{"id":"components/schemas/attribute_match_score_overall","kind":"json-schema","title":"attribute_match_score_overall","data":{"description":"0 if no attributes match, 50 if some attributes match, 100 if all attributes match","type":"integer","enum":[0,50,100],"example":50}},"components/schemas/idv_result_context_item":{"id":"components/schemas/idv_result_context_item","kind":"json-schema","title":"idv_result_context_item","data":{"title":"idv_result_context_item","type":"object","properties":{"code":{"type":"string","description":"A stable code for the reason or context","example":"CT-0195"},"title":{"type":"string","description":"A user-friendly description of the reason or context","example":"Address is correlated with a past address"},"category":{"type":"string","description":"Category derived from the provider reason code.","enum":["informational","rejection","unknown"],"example":"informational"}}}},"components/schemas/idv_result_pii_validation":{"id":"components/schemas/idv_result_pii_validation","kind":"json-schema","title":"idv_result_pii_validation","data":{"title":"idv_result_pii_validation","type":"object","properties":{"attribute_match_scores":{"$ref":"#/components/schemas/attribute_match_scores"},"overall_match_score":{"$ref":"#/components/schemas/attribute_match_score_overall"},"result_context":{"type":"array","items":{"$ref":"#/components/schemas/idv_result_context_item"}}}}},"components/schemas/idv_collection_link":{"id":"components/schemas/idv_collection_link","kind":"json-schema","title":"idv_collection_link","data":{"title":"idv_collection_link","type":"object","properties":{"url":{"description":"URL for the document collection application.","type":"string","format":"uri"},"qr_code":{"description":"Base64 encoded PNG image of a QR code linking to the collection URL.","type":"string","format":"byte"}}}},"components/schemas/idv_document_type":{"id":"components/schemas/idv_document_type","kind":"json-schema","title":"idv_document_type","data":{"title":"idv_document_type","type":"object","properties":{"type":{"description":"The type of document identified (e.g., Drivers License, Passport).","type":"string","example":"Drivers License"},"country":{"description":"The country of issuance.","type":"string","example":"USA"},"state":{"description":"The state/province of issuance (if applicable).","type":"string","example":"CO"}}}},"components/schemas/idv_document_data":{"id":"components/schemas/idv_document_data","kind":"json-schema","title":"idv_document_data","data":{"title":"idv_document_data","type":"object","properties":{"first_name":{"description":"First name extracted from the document.","type":"string","example":"Dwayne"},"sur_name":{"description":"Last name extracted from the document.","type":"string","example":"Denver"},"full_name":{"description":"Full name extracted from the document.","type":"string","example":"Dwayne Denver"},"address":{"description":"Address extracted from the document.","type":"string","example":"123 Example Street, New York City, NY 10001"},"parsed_address":{"description":"Address components parsed from the extracted address.","type":"object","properties":{"physical_address":{"description":"The primary address line of the address.","type":"string"},"physical_address2":{"description":"The secondary address line of the address.","type":"string"},"city":{"description":"The city of the address.","type":"string"},"state":{"description":"The state of the address.","type":"string"},"country":{"description":"The country of the address.","type":"string"},"zip":{"description":"The ZIP code of the address.","type":"string"}}},"document_number":{"description":"Document identification number.","type":"string","example":"000000000"},"dob":{"description":"Date of birth extracted from the document.","type":"string","format":"date","example":"1990-01-01"},"issue_date":{"description":"Date the document was issued.","type":"string","format":"date","example":"2020-01-01"},"expiration_date":{"description":"Date the document expires.","type":"string","format":"date","example":"2027-01-01"}}}},"components/schemas/idv_result_document_verification":{"id":"components/schemas/idv_result_document_verification","kind":"json-schema","title":"idv_result_document_verification","data":{"title":"idv_result_document_verification","type":"object","properties":{"status":{"description":"The current status of the document verification process.","type":"string","enum":["started","documents_collected","complete"]},"result":{"description":"The final result of the verification, or null if not complete.","type":"string","enum":["accept","reject","resubmit","failed"]},"errors":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of error codes if the process failed or encountered issues (e.g., consent_declined, session_expired)."},"children":[]}]}]}],"$ref":"#/components/schemas/errors"},"collection_link":{"description":"Link details for the document collection step.","$ref":"#/components/schemas/idv_collection_link"},"result_context":{"description":"Array of objects describing reasons or context associated with the result.","type":"array","items":{"$ref":"#/components/schemas/idv_result_context_item"},"example":[{"code":"CT-0167","title":"First name extracted from document correlates with input name","category":"informational"},{"code":"CT-0171","title":"Document number extracted from document correlates with input number","category":"informational"}]},"document_type":{"description":"Details about the type of document submitted.","$ref":"#/components/schemas/idv_document_type"},"document_data":{"description":"Data extracted from the submitted document.","$ref":"#/components/schemas/idv_document_data"}},"example":{"status":"complete","result":"accept","errors":[],"collection_link":{"url":"https://example.com","qr_code":""},"result_context":[{"code":"CT-0167","title":"First name extracted from document correlates with input name","category":"informational"},{"code":"CT-0171","title":"Document number extracted from document correlates with input number","category":"informational"}],"document_type":{"type":"Drivers License","country":"USA","state":"CO"},"document_data":{"first_name":"Dwayne","sur_name":"Denver","full_name":"Dwayne Denver","address":"123 Example Street, New York City, NY 10001","parsed_address":{"physical_address":"123 Example Street","physical_address2":"Suite 200","city":"New York City","state":"NY","zip":"10001","country":"USA"},"document_number":"000000000","dob":"2000-01-01","issue_date":"2020-01-01","expiration_date":"2027-01-01"}}}},"components/schemas/idv_result_personal_identity_records":{"id":"components/schemas/idv_result_personal_identity_records","kind":"json-schema","title":"idv_result_personal_identity_records","data":{"title":"idv_result_personal_identity_records","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results for a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"personal_identity_records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" identity verification. SSN values in"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"people[].ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are masked as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by default; use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"query parameter or product configuration to return full values. SSN may be null"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when the provider has no SSN on file for a record."},"children":[]}]}]}],"type":"object","properties":{"request":{"description":"The request parameters used for the search","type":"object","properties":{"first_name":{"description":"The first name of the person","type":"string"},"middle_name":{"description":"The middle name of the person","type":"string"},"last_name":{"description":"The last name of the person","type":"string"},"dob":{"$ref":"#/components/schemas/date_string_complete"},"phone":{"$ref":"#/components/schemas/phone_string"},"email":{"$ref":"#/components/schemas/email_string"},"ssn":{"$ref":"#/components/schemas/ssn_string"},"address":{"$ref":"#/components/schemas/address"},"reference_id":{"$ref":"#/components/schemas/reference_id"}}},"people":{"description":"Array of identity records found matching the search criteria","type":"array","items":{"type":"object","properties":{"name":{"description":"The person's name components","type":"object","properties":{"first_name":{"type":"string"},"middle_name":{"type":"string"},"last_name":{"type":"string"},"full_name":{"type":"string"}}},"dobs":{"description":"Array of dates of birth associated with this identity (format YYYYMMDD, with 00 for unknown components)","type":"array","items":{"type":"string","pattern":"^[0-9]{8}$","example":"19900115"}},"phones":{"description":"Array of phone numbers associated with this identity","type":"array","items":{"type":"string"}},"ssn":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Social Security Number for this identity record. Not enabled by default;"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contact your Checkr Trust Account Executive or Customer Success"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"representative if you need SSN in results."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When SSN unmasking is disabled, values are returned masked as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"XXX-XX-{last4}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (see the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"unmask_ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" query parameter). May be null"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when the provider has no SSN on file for this record."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/ssn_string"},{"$ref":"#/components/schemas/masked_ssn_string"},{"type":"null"}],"example":"XXX-XX-1234"},"addresses":{"description":"Array of addresses associated with this identity","type":"array","items":{"type":"object","properties":{"street":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"zip_code":{"type":"string"},"county":{"type":"string","description":"County name"},"country":{"type":"string"},"from_date":{"type":"string","format":"date","description":"First date the person was associated with this address"},"to_date":{"type":"string","format":"date","description":"Last date the person was associated with this address"}}}},"aliases":{"description":"Array of name aliases associated with this identity","type":"array","items":{"type":"object","properties":{"first_name":{"type":"string"},"middle_name":{"type":"string"},"last_name":{"type":"string"},"full_name":{"type":"string"}}}}}}}},"example":{"request":{"first_name":"JOHN","last_name":"SMITH","dob":"19900115"},"people":[{"name":{"first_name":"JOHN","middle_name":"ALLEN","last_name":"SMITH","full_name":"JOHN ALLEN SMITH"},"dobs":["19900115"],"phones":["+15551234567"],"ssn":"XXX-XX-1234","addresses":[{"street":"123 MAIN ST","city":"ANYTOWN","state":"CA","zip_code":"12345","county":"LINCOLN","country":"US","from_date":"2018-03-15","to_date":"2024-01-20"}],"aliases":[{"first_name":"JOHNNY","last_name":"SMITH"}]}]}}},"components/schemas/idv_result_reverse_phone":{"id":"components/schemas/idv_result_reverse_phone","kind":"json-schema","title":"idv_result_reverse_phone","data":{"title":"idv_result_reverse_phone","type":"object","properties":{"phone_info":{"description":"Technical and geographic information about the phone number.","type":"object","properties":{"operating_company":{"description":"The operating carrier associated with the phone number.","type":"object","properties":{"category_description":{"type":"string","description":"Description of the carrier category."},"name":{"type":"string","description":"Legal name of the operating company."},"dba":{"type":"string","description":"Doing-business-as name of the operating company."},"common_name":{"type":"string","description":"Common name of the operating company."},"type":{"type":"string","description":"Type of operating company."}}},"rate_center":{"description":"Geographic rate center information for the phone number.","type":"object","properties":{"lata":{"description":"Local Access and Transport Area information.","type":"object","properties":{"code":{"type":"string"},"state":{"type":"string"},"state_name":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"location":{"type":"string"}}},"bta":{"description":"Basic Trading Area information.","type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"}}},"mtas":{"description":"Major Trading Areas associated with the rate center.","type":"array","items":{"type":"object","properties":{"code":{"type":"integer"},"country":{"type":"string"},"market_name":{"type":"string"}}}},"cbsas":{"description":"Core Based Statistical Areas associated with the rate center.","type":"array","items":{"type":"object","properties":{"code":{"type":"integer"},"csa":{"type":"integer"},"area_name":{"type":"string"},"area_type":{"type":"string"},"state":{"type":"string"}}}},"counties":{"description":"Counties associated with the rate center.","type":"array","items":{"type":"object","properties":{"fips_code":{"type":"string","description":"US county FIPS code"},"name":{"type":"string"},"type":{"type":"string"},"state":{"type":"string"},"state_name":{"type":"string"},"county":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"land_area_square_miles":{"type":"number"},"population_in_2006":{"type":"integer"}}}},"zip_codes":{"description":"ZIP codes associated with the rate center.","type":"array","items":{"type":"string"}},"city":{"type":"string"},"code":{"type":"string"},"type":{"type":"string"},"country":{"type":"string"},"country_name":{"type":"string"},"state":{"type":"string"},"state_name":{"type":"string"},"time_zone":{"type":"string"},"time_zone_name":{"type":"string"},"dst_recognized":{"type":"string","description":"Whether daylight saving time is recognized in this area."}}},"npa":{"type":"integer","description":"Numbering Plan Area (area code)."},"nxx":{"type":"integer","description":"Central office code (exchange)."},"block_id":{"type":"string","description":"Block identifier for the phone number."},"line_type":{"type":"string","description":"Type of phone line (e.g. Mobile, Landline, VOIP)."},"central_office_name":{"type":"string","description":"Name of the central office serving this number."},"switch":{"type":"string","description":"Switch identifier for the central office."},"derived_from_npa":{"type":"integer","description":"Original NPA if the number was derived from a different area code."},"new_npa":{"type":"string","description":"New NPA if the number has been reassigned."},"overlay":{"type":"string","description":"Overlay area code, if applicable."},"nxx_type":{"type":"string","description":"Type classification of the NXX code."},"nxx_description":{"type":"string","description":"Description of the NXX type."}}},"persons":{"description":"Array of identity records associated with the phone number.","type":"array","items":{"type":"object","properties":{"names":{"description":"Names associated with this identity.","type":"array","items":{"type":"object","properties":{"full_name":{"type":"string"},"first_name":{"type":"string"},"middle_name":{"type":"string"},"last_name":{"type":"string"},"prefixes":{"type":"string"},"maiden_name":{"type":"string"},"suffixes":{"type":"string"}}}},"addresses":{"description":"Addresses associated with this identity.","type":"array","items":{"type":"object","properties":{"address1":{"type":"string"},"address2":{"type":"string"},"address3":{"type":"string"},"house_num":{"type":"string"},"unit_num":{"type":"string"},"unit_type":{"type":"string"},"county":{"type":"string"},"county_code":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"state_code":{"type":"string"},"city_state":{"type":"string"},"postal_code":{"type":"string"},"country":{"type":"string"},"country_code":{"type":"string"},"zip_code":{"type":"string"},"zip_code4":{"type":"string"},"date_from":{"type":"string"},"date_from_year":{"type":"integer"},"date_from_month":{"type":"integer"},"date_from_day":{"type":"integer"},"date_to":{"type":"string"},"date_to_year":{"type":"integer"},"date_to_month":{"type":"integer"},"date_to_day":{"type":"integer"}}}},"phones":{"description":"Phone numbers associated with this identity.","type":"array","items":{"type":"object","properties":{"phone":{"type":"string"},"country_code":{"type":"string"},"formatted":{"type":"string"},"valid_since":{"type":"string","format":"date-time"},"type":{"type":"string"}}}},"email":{"type":"string","description":"Email address associated with this identity."},"days_email_has_been_active":{"type":"string","description":"Number of days the email address has been active."},"gender":{"type":"string","enum":["unknown","male","female"],"description":"Gender associated with this identity."},"dob":{"type":"string","description":"Date of birth associated with this identity."},"social_profiles":{"description":"Social media profiles associated with this identity.","type":"array","items":{"type":"object","properties":{"exists":{"type":"boolean"},"user_name":{"type":"string"},"num_friends":{"type":"string"},"profile_url":{"type":"string"},"image_url":{"type":"string"},"site":{"type":"string"},"site_url":{"type":"string"}}}},"user_ids":{"description":"User identifiers associated with this identity.","type":"array","items":{"type":"string"}},"user_names":{"description":"Usernames associated with this identity.","type":"array","items":{"type":"string"}},"relationships":{"description":"Relationships associated with this identity.","type":"array","items":{"type":"object"}}}}},"date_executed":{"type":"string","description":"The date and time the phone search was executed."},"total_time_in_seconds":{"type":"number","description":"Total time taken to execute the phone search, in seconds."}}}},"components/schemas/idv_type":{"id":"components/schemas/idv_type","kind":"json-schema","title":"idv_type","data":{"description":"The type of identity verification to be done.","type":"string","title":"idv_type","enum":["pii_validation","document_verification","personal_identity_records","reverse_phone"],"x-enumDescriptions":{"pii_validation":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When requesting pii_validation, the result will be returned immediately."},"children":[]}]}]}],"document_verification":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When requesting document_verification, the result will be returned asynchronously through a pre-defined webhook."},"children":[]}]}]}],"personal_identity_records":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When requesting personal_identity_records, enriched identity information will be returned immediately."},"children":[]}]}]}],"reverse_phone":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When requesting reverse_phone, identity information associated with the provided phone number will be returned immediately."},"children":[]}]}]}]},"default":"pii_validation"}},"components/schemas/identity_verification":{"id":"components/schemas/identity_verification","kind":"json-schema","title":"identity_verification","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The structure of results depends on the value of idv_type."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/idv_result_pii_validation"},{"$ref":"#/components/schemas/idv_result_document_verification"},{"$ref":"#/components/schemas/idv_result_personal_identity_records"},{"$ref":"#/components/schemas/idv_result_reverse_phone"}]},"idv_type":{"$ref":"#/components/schemas/idv_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"identity verification with profile id","required":["profile_id"]},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"identity verification with profile object","required":["profile"]}]}},"components/schemas/identity-verification-request-from-pii":{"id":"components/schemas/identity-verification-request-from-pii","kind":"json-schema","title":"identity-verification-request-from-pii","data":{"description":"the request to create a new identity verification from set of PII","type":"object","properties":{"idv_type":{"$ref":"#/components/schemas/idv_type"},"first_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The first name of the person. Required (with last_name) when not sending full_name."},"children":[]}]}]}],"type":"string"},"middle_name":{"description":"For document verification, the middle name of the person.","type":"string"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The last name of the person. Required (with first_name) when not sending full_name."},"children":[]}]}]}],"type":"string"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you already know the first and last names, we suggest sending them."},"children":[]}]}]}],"type":"string","example":"Jane Doe"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"phone":{"$ref":"#/components/schemas/phone_string"},"email":{"$ref":"#/components/schemas/email_string"},"ssn":{"$ref":"#/components/schemas/ssn_string"},"address":{"$ref":"#/components/schemas/address","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-address-field-prefer-addresses-array.md"},"children":[]}]},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-idv-addresses-field.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"send_message":{"description":"For document verification, whether the end user should receive an SMS with the collection link to the provided phone number.\nDefaults to false if not provided.\n","type":"boolean","default":false},"skip_selfie":{"description":"For document verification, whether we should skip collecting and verifying a selfie. Defaults to false.","type":"boolean","default":false}},"required":["idv_type"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"anyOf":[{"title":"dob-is-required","description":"The object must have DOB.","required":["dob"]},{"title":"phone-is-required","description":"The object must have phone number.","required":["phone"]},{"title":"email-is-required","description":"The object must have email.","required":["email"]},{"title":"address-is-required","description":"The object must have address.","required":["address"]},{"title":"addresses-is-required","description":"The object must have at least one address in addresses.","required":["addresses"]},{"title":"ssn-is-required","description":"The object must have an SSN.","required":["ssn"]}],"example":{"first_name":"JOHN","last_name":"SMITH","idv_type":"pii_validation","email":"j.doe@example.com"}}},"components/schemas/identity-verification-request-from-profile":{"id":"components/schemas/identity-verification-request-from-profile","kind":"json-schema","title":"identity-verification-request-from-profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an identity verification from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"properties":{"idv_type":{"$ref":"#/components/schemas/idv_type"},"profile_id":{"$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"send_message":{"description":"For document verification, whether the end user should receive an SMS with the collection link to the provided phone number. Defaults to false if not provided.","type":"boolean"},"skip_selfie":{"description":"For document verification, whether we should skip collecting and verifying a selfie. Defaults to false.","type":"boolean","default":false}},"required":["profile_id","idv_type"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080","idv_type":"pii_validation"}}},"components/schemas/identity-verification-request-from-phone":{"id":"components/schemas/identity-verification-request-from-phone","kind":"json-schema","title":"identity-verification-request-from-phone","data":{"description":"the request to create a new reverse phone identity verification","type":"object","properties":{"idv_type":{"$ref":"#/components/schemas/idv_type"},"country_code":{"description":"The country code of the phone number (e.g. \"1\" for US).","type":"string"},"phone":{"description":"The phone number to look up (e.g. \"310-555-5555\").","type":"string"}},"required":["idv_type","country_code","phone"],"example":{"idv_type":"reverse_phone","country_code":"1","phone":"310-555-5555"}}},"components/schemas/idv_result_document_verification_initial":{"id":"components/schemas/idv_result_document_verification_initial","kind":"json-schema","title":"idv_result_document_verification_initial","data":{"title":"idv_result_document_verification_initial","type":"object","properties":{"status":{"type":"string","enum":["started"],"description":"The initial status of the document verification process."},"collection_link":{"$ref":"#/components/schemas/idv_collection_link","description":"Link details for the document collection step."}},"required":["status","collection_link"]}},"components/schemas/identity_verification_post_response":{"id":"components/schemas/identity_verification_post_response","kind":"json-schema","title":"identity_verification_post_response","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid","description":"the UUID of the identity verification."},"created_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The structure of results depends on the value of idv_type."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/idv_result_pii_validation"},{"$ref":"#/components/schemas/idv_result_document_verification_initial"},{"$ref":"#/components/schemas/idv_result_personal_identity_records"},{"$ref":"#/components/schemas/idv_result_reverse_phone"}]},"profile_id":{"$ref":"#/components/schemas/uuid","description":"the UUID of the profile."},"profile":{"$ref":"#/components/schemas/profile"},"idv_type":{"$ref":"#/components/schemas/idv_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"required":["id","created_at","results","idv_type"]}},"components/schemas/document-verification-completed-event-body":{"id":"components/schemas/document-verification-completed-event-body","kind":"json-schema","title":"document-verification-completed-event-body","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["document_verification.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"oneOf":[{"$ref":"#/components/schemas/idv_result_document_verification"}],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The structure of results depends on the value of idv_type."},"children":[]}]}]}]},"profile_id":{"type":"string","format":"uuid"},"idv_type":{"type":"string","enum":["document_verification"]},"reference_id":{"$ref":"#/components/schemas/reference_id"}}},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/profile_request_from_pii":{"id":"components/schemas/profile_request_from_pii","kind":"json-schema","title":"profile_request_from_pii","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request to create a new profile from a set of personally identifiable information (PII)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exactly one name format must be provided: either full_name (without first_name, middle_name, or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"last_name) or first_name and last_name (without full_name)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany either format. When supplied with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the parsed middle"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"token is folded into the surname (see the shared "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one of the following must also be provided - DOB, phone, email, address, or SSN."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The more identity fields provided (SSN, email, phone), the better the matching and verification capabilities will be."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These fields are used for additional identity verification and record matching in various check products."},"children":[]}]}]}],"type":"object","properties":{"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The full name of the person. Must not be combined with first_name, middle_name, or last_name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"May be combined with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"; when that flag is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", parsing stores only a first"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name and surname (any middle token is folded into the last name)."},"children":[]}]}]}],"type":"string"},"first_name":{"description":"The first name of the person.","type":"string"},"middle_name":{"description":"The middle name of the person. Can be null if not provided.","type":"string"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"The last name of the person.","type":"string"},"dob":{"$ref":"#/components/schemas/date_string_complete"},"phone":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A phone number in the form +[country code][number including area code]. (E.164 format)"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A U.S. number supplied in national format (for example \"(415) 555-0123\") is normalized to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"E.164 on write. If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/phone_string"},"email":{"$ref":"#/components/schemas/email_string"},"ssn":{"$ref":"#/components/schemas/ssn_string"},"address":{"$ref":"#/components/schemas/address"},"addresses":{"$ref":"#/components/schemas/addresses"},"custom_id":{"$ref":"#/components/schemas/custom_id_string"}},"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"},{"anyOf":[{"title":"dob-is-required","description":"The object must have DOB.","required":["dob"]},{"title":"phone-is-required","description":"The object must have phone number.","required":["phone"]},{"title":"email-is-required","description":"The object must have email.","required":["email"]},{"title":"address-is-required","description":"The object must have address.","required":["address"]},{"title":"addresses-is-required","description":"The object must have at least one address in addresses.","required":["addresses"]},{"title":"ssn-is-required","description":"The object must have an SSN.","required":["ssn"]}]}],"example":{"first_name":"JOHN","middle_name":"ROBERT","last_name":"SMITH","dob":"19900101","ssn":"123-45-6789","email":"john.smith@example.com","phone":"+14155552671","address":{"street":"123 Main St","city":"San Francisco","state":"CA","zip_code":"94105"},"custom_id":"employee-123"}}},"components/schemas/profile_request_from_address":{"id":"components/schemas/profile_request_from_address","kind":"json-schema","title":"profile_request_from_address","data":{"description":"The request to create a new profile from an address only. This is used when you only have address information and no personal identifiers.","type":"object","properties":{"address":{"$ref":"#/components/schemas/address"},"addresses":{"$ref":"#/components/schemas/addresses"},"custom_id":{"$ref":"#/components/schemas/custom_id_string"}},"required":["address"],"example":{"address":{"street":"123 Example Street","city":"New York City","state":"NY","zip_code":"10001","country":"US"}}}},"components/schemas/profile_request_from_profile":{"id":"components/schemas/profile_request_from_profile","kind":"json-schema","title":"profile_request_from_profile","data":{"description":"The request to create a new profile by copying an existing profile's information. This allows reusing previously validated profile data.","type":"object","properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"custom_id":{"$ref":"#/components/schemas/custom_id_string"}},"required":["profile_id"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080"}}},"components/schemas/legal_check":{"id":"components/schemas/legal_check","kind":"json-schema","title":"legal_check","data":{"type":"object","description":"A legal annotation check result indicating how a record, case, or charge\nwas evaluated against applicable legal rules.\n","properties":{"action_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action type determined by the legal rule evaluation:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"note: Informational annotation added to the item"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"investigate: The item may require further review before inclusion"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"remove: The item should not be reported based on legal restrictions"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modified: The item was modified (e.g., certain attributes were removed)"},"children":[]}]}]}]}],"enum":["note","investigate","remove","modified"],"example":"note"},"rule_id":{"type":"string","description":"Identifier of the legal rule that triggered this check result.","example":"CA-7yr-felony"},"rule_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of rule that was applied:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"legal: A rule based on statutory or regulatory requirements"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"policy: A rule based on company policy"},"children":[]}]}]}]}],"enum":["legal","policy"],"example":"legal"},"domain":{"type":"string","description":"The filter domain in which this rule was applied.","example":"employment"},"description":{"type":"string","description":"Human-readable description of what the legal rule evaluated.","example":"Felony convictions older than 7 years cannot be reported in California"},"run_at":{"type":"string","format":"date-time","description":"The timestamp when this check was evaluated.","example":"2024-01-15T10:30:00.000Z"}}}},"components/schemas/regulated_charge":{"id":"components/schemas/regulated_charge","kind":"json-schema","title":"regulated_charge","data":{"description":"A charge with legal annotation checks.","allOf":[{"$ref":"#/components/schemas/charge"},{"type":"object","properties":{"checks":{"type":"array","description":"Legal annotation check results for this charge.","items":{"$ref":"#/components/schemas/legal_check"}}}}]}},"components/schemas/regulated_case":{"id":"components/schemas/regulated_case","kind":"json-schema","title":"regulated_case","data":{"description":"A case with legal annotation checks.","allOf":[{"$ref":"#/components/schemas/case_core"},{"type":"object","properties":{"charges":{"description":"Charges in this case, with legal annotation checks.","type":"array","items":{"$ref":"#/components/schemas/regulated_charge"}},"checks":{"type":"array","description":"Legal annotation check results for this case.","items":{"$ref":"#/components/schemas/legal_check"}}}}]}},"components/schemas/regulated_record":{"id":"components/schemas/regulated_record","kind":"json-schema","title":"regulated_record","data":{"title":"regulated_record","description":"A criminal record with legal annotation checks at record, case, and charge levels.","allOf":[{"$ref":"#/components/schemas/record_core"},{"type":"object","properties":{"cases":{"description":"Cases in this record, with legal annotation checks.","type":"array","items":{"$ref":"#/components/schemas/regulated_case"}},"checks":{"type":"array","description":"Legal annotation check results for this record.","items":{"$ref":"#/components/schemas/legal_check"}}}}]}},"components/schemas/regulated_check_type":{"id":"components/schemas/regulated_check_type","kind":"json-schema","title":"regulated_check_type","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of regulated check. Currently only instant_criminal_regulated is supported."},"children":[]}]}]}],"enum":["instant_criminal_regulated"],"default":"instant_criminal_regulated"}},"components/schemas/regulated_check":{"id":"components/schemas/regulated_check","kind":"json-schema","title":"regulated_check","data":{"type":"object","description":"A regulated check response with legal annotation checks included in results.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":"When there are no results found, this will be an empty array.","type":"array","items":{"$ref":"#/components/schemas/regulated_record"}},"check_type":{"$ref":"#/components/schemas/regulated_check_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"run_notes":{"description":"An unstructured array of human-readable notes about this particular check.\nMay contain notes about how input was parsed or other information about results.\n","type":"array","items":{"type":"string"}},"results_found":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=results_found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When present, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array is omitted."},"children":[]}]}]}],"type":"boolean"},"rulesets_applied":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=rulesets_applied"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_applied"}},"review":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Null when no accept/decline/dispute decision exists for this check."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/check_review"},{"type":"null"}]},"adverse_action_enabled":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether adverse-action workflow is enabled for this product."},"children":[]}]}]}],"type":"boolean"}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"regulated check with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"regulated check with profile object"}]}},"components/schemas/regulated_check_request_from_pii":{"id":"components/schemas/regulated_check_request_from_pii","kind":"json-schema","title":"regulated_check_request_from_pii","data":{"type":"object","description":"Request to create a regulated check using personally identifiable information (PII).","properties":{"check_type":{"$ref":"#/components/schemas/regulated_check_type"},"first_name":{"description":"First name (given name). Do not include prefixes like \"Ms.\" or \"Dr.\"","type":"string","example":"Jane"},"middle_name":{"description":"Middle name(s)","type":"string","example":"Mary Louise"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"Last name (surname). Do not include suffixes like \"Jr.\" or \"2nd\".","type":"string","example":"Smith"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]}]}]}],"type":"string","example":"Smith, Jane Mary Louise"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"description":"Social Security Number used for additional identity verification and record matching","$ref":"#/components/schemas/ssn_string"},"phone":{"$ref":"#/components/schemas/phone_string"},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-check-addresses-field-regulated.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"filter_context":{"$ref":"#/components/schemas/filter_context"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"}},"required":["dob","filter_context","permissible_purpose"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"JOHN","last_name":"SMITH","dob":"19900101","ssn":"123-45-6789","phone":"+14155552671","addresses":[{"street":"456 Oak Ave","city":"Los Angeles","state":"CA","zip_code":"90001"}],"filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/regulated_check_request_from_profile":{"id":"components/schemas/regulated_check_request_from_profile","kind":"json-schema","title":"regulated_check_request_from_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a regulated check from an existing profile. Do not include inline PII or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile."},"children":[]}]}]}],"type":"object","properties":{"check_type":{"$ref":"#/components/schemas/regulated_check_type"},"profile_id":{"$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"filter_context":{"$ref":"#/components/schemas/filter_context"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"}},"required":["profile_id","filter_context","permissible_purpose"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080","filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/regulated_case-2":{"id":"components/schemas/regulated_case-2","kind":"json-schema","title":"regulated_case-2","data":{"description":"A case with legal annotation checks.","allOf":[{"$ref":"#/components/schemas/case"},{"type":"object","properties":{"charges":{"description":"Charges in this case, with legal annotation checks.","type":"array","items":{"$ref":"#/components/schemas/regulated_charge"}},"checks":{"type":"array","description":"Legal annotation check results for this case.","items":{"$ref":"#/components/schemas/legal_check"}}}}]}},"components/schemas/regulated_record-2":{"id":"components/schemas/regulated_record-2","kind":"json-schema","title":"regulated_record","data":{"title":"regulated_record","description":"A criminal record with legal annotation checks at record, case, and charge levels.","allOf":[{"$ref":"#/components/schemas/record"},{"type":"object","properties":{"cases":{"description":"Cases in this record, with legal annotation checks.","type":"array","items":{"$ref":"#/components/schemas/regulated_case-2"}},"checks":{"type":"array","description":"Legal annotation check results for this record.","items":{"$ref":"#/components/schemas/legal_check"}}}}]}},"components/schemas/criminal_report_check_type":{"id":"components/schemas/criminal_report_check_type","kind":"json-schema","title":"criminal_report_check_type","data":{"type":"string","description":"The type of check performed for this report.","enum":["regulated_criminal_report"],"default":"regulated_criminal_report"}},"components/schemas/regulated_criminal_report":{"id":"components/schemas/regulated_criminal_report","kind":"json-schema","title":"regulated_criminal_report","data":{"type":"object","description":"A regulated criminal report with legal annotation checks included in results.\nResults are delivered asynchronously via webhook once processing is complete.\n","properties":{"id":{"$ref":"#/components/schemas/uuid"},"status":{"type":"string","description":"The current status of the report.","enum":["pending","complete","failed"],"example":"complete"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":"When there are no results found, this will be an empty array.","type":"array","items":{"$ref":"#/components/schemas/regulated_record-2"}},"check_type":{"$ref":"#/components/schemas/criminal_report_check_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"run_notes":{"description":"An unstructured array of human-readable notes about this particular report.\nMay contain notes about how input was parsed or other information about results.\n","type":"array","items":{"type":"string"}}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"regulated criminal report with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"regulated criminal report with profile object"}]}},"components/schemas/filter_domain-2":{"id":"components/schemas/filter_domain-2","kind":"json-schema","title":"filter_domain-2","data":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The legal-filtering domain to apply to this report (for example, employment vs. tenancy rules)."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is only needed when your account is configured to allow multiple filter domains."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Most callers do not need to set this — a default domain is applied automatically based on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your account's configuration. When your account does allow choosing a domain per call, only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a limited, pre-approved set of values is accepted; contact Checkr to configure which domains"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your account can use."},"children":[]}]}]}],"enum":["employment","long term tenancy","short term tenancy","eviction","other"],"example":"employment"}},"components/schemas/filter_context-2":{"id":"components/schemas/filter_context-2","kind":"json-schema","title":"filter_context-2","data":{"type":"object","description":"Context information used to determine which legal rules apply when filtering report results.\nJurisdictions help identify applicable state and local regulations that may affect\nwhich records can be reported.\n","properties":{"candidate_jurisdiction":{"description":"The jurisdiction where the candidate (subject of the report) is located.","$ref":"#/components/schemas/jurisdiction"},"decider_jurisdiction":{"description":"The jurisdiction where the decision-maker (employer/requester) is located.","$ref":"#/components/schemas/jurisdiction"},"property_jurisdiction":{"description":"The jurisdiction of the property involved (for tenancy-related reports).","$ref":"#/components/schemas/jurisdiction"},"filter_domain":{"$ref":"#/components/schemas/filter_domain-2"}},"required":["candidate_jurisdiction"]}},"components/schemas/permissible_purpose-2":{"id":"components/schemas/permissible_purpose-2","kind":"json-schema","title":"permissible_purpose-2","data":{"type":"string","description":"The permissible purpose for requesting this criminal record report, as required by the Fair Credit Reporting Act (FCRA).\nThis must be provided for all regulated criminal reports to ensure compliance with federal regulations.\n","enum":["Court Order","Consumer Instruction","Credit Transaction","Employment","Insurance Underwriting","Benefit Eligibility","Credit Risk","Consumer Initiated","Account Review","Govt Chargecard","Child Support","Agency Liquidation"],"example":"Employment"}},"components/schemas/criminal_report_request_from_pii":{"id":"components/schemas/criminal_report_request_from_pii","kind":"json-schema","title":"criminal_report_request_from_pii","data":{"type":"object","description":"Request to create a regulated criminal report using personally identifiable information (PII).","properties":{"check_type":{"$ref":"#/components/schemas/criminal_report_check_type"},"first_name":{"description":"First name (given name). Do not include prefixes like \"Ms.\" or \"Dr.\"","type":"string","example":"Jane"},"middle_name":{"description":"Middle name(s)","type":"string","example":"Mary Louise"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"Last name (surname). Do not include suffixes like \"Jr.\" or \"2nd\".","type":"string","example":"Smith"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]}]}]}],"type":"string","example":"Smith, Jane Mary Louise"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"description":"Social Security Number used for additional identity verification and record matching","$ref":"#/components/schemas/ssn_string"},"phone":{"$ref":"#/components/schemas/phone_string"},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-check-addresses-field-regulated.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"filter_context":{"$ref":"#/components/schemas/filter_context-2"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose-2"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"}},"required":["dob","filter_context","permissible_purpose"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"JOHN","last_name":"SMITH","dob":"19900101","ssn":"123-45-6789","phone":"+14155552671","addresses":[{"street":"456 Oak Ave","city":"Los Angeles","state":"CA","zip_code":"90001"}],"filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/criminal_report_request_from_profile":{"id":"components/schemas/criminal_report_request_from_profile","kind":"json-schema","title":"criminal_report_request_from_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a regulated criminal report from an existing profile. Do not include inline PII or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"type":"object","properties":{"check_type":{"$ref":"#/components/schemas/criminal_report_check_type"},"profile_id":{"$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"filter_context":{"$ref":"#/components/schemas/filter_context-2"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose-2"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"}},"required":["profile_id","filter_context","permissible_purpose"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080","filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/regulated_criminal_report_created":{"id":"components/schemas/regulated_criminal_report_created","kind":"json-schema","title":"regulated_criminal_report_created","data":{"type":"object","description":"Response returned when a regulated criminal report is created. Full results are delivered asynchronously via webhook.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"status":{"type":"string","description":"The current status of the report.","enum":["pending","complete","failed"],"example":"pending"}}}},"components/schemas/disqualifying_record":{"id":"components/schemas/disqualifying_record","kind":"json-schema","title":"disqualifying_record","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A reference to a specific criminal record that contributed to the adverse decision."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Including disqualifying records is optional but strongly recommended for FCRA compliance -"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the subject must be informed of which records triggered the decision."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record_id is globally unique across all checks."},"children":[]}]}]}],"properties":{"record_id":{"type":"string","description":"The ID of the criminal record within a check result.","example":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"}},"required":["record_id"]}},"components/schemas/pre_adverse_action_request":{"id":"components/schemas/pre_adverse_action_request","kind":"json-schema","title":"pre_adverse_action_request","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to send a pre-adverse action notification to the subject identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This ensures compliance and fairness in the decision-making process."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cannot be submitted after an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" has already been taken for this check."},"children":[]}]}]}],"properties":{"check_id":{"$ref":"#/components/schemas/uuid","description":"The ID of the regulated check that produced the records for this pre-adverse action."},"email":{"$ref":"#/components/schemas/email_string","description":"Email address of the subject to deliver the notice to."},"suppress_notice":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the notice email is not sent to the subject. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"candidate_report_url"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is still populated in the response. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"disqualifying_records":{"type":"array","description":"The criminal records that triggered the adverse decision. Optional but recommended.","items":{"$ref":"#/components/schemas/disqualifying_record"}}},"required":["check_id","email"],"example":{"check_id":"a3f1e290-bc44-4d2a-9c18-d3e5f2a71b00","email":"john.smith@example.com","disqualifying_records":[{"record_id":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"}]}}},"components/schemas/pre_adverse_action_response":{"id":"components/schemas/pre_adverse_action_response","kind":"json-schema","title":"pre_adverse_action_response","data":{"type":"object","description":"A pre-adverse action record.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"check_id":{"$ref":"#/components/schemas/uuid","description":"The ID of the regulated check that produced the records for this pre-adverse action."},"status":{"type":"string","description":"The status associated with the pre-adverse action.","example":"AdverseActionInitiated"},"candidate_report_url":{"type":["string","null"],"format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Subject-facing URL for viewing the background check report and responding to the notice."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a subject UI is configured this is a deep link keyed by the pre-adverse action id,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"gated by a one-time code sent to the subject's email so the customer cannot open it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"directly; you may still share it with the subject, and Checkr emails it to them unless"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"suppress_notice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set. Where no subject UI is configured, this is a support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mailto:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link instead (no OTP gating)."},"children":[]}]}]}],"example":"https://subjects.checkrtrust.com/2b8313e8-4efd-45a1-b578-952b8313e890/review"},"disqualifying_records":{"type":"array","items":{"$ref":"#/components/schemas/disqualifying_record"}},"created_at":{"$ref":"#/components/schemas/datetime"},"sent_at":{"type":["string","null"],"format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp when the notice was delivered. Null until status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2024-06-01T14:00:00Z"}}}},"components/schemas/pre-adverse-action-completed-event-body":{"id":"components/schemas/pre-adverse-action-completed-event-body","kind":"json-schema","title":"pre-adverse-action-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when the subject accepts a pre-adverse action decision ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Closed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The payload is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"intentionally minimal: retrieve full details via "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["pre_adverse_action.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"pre_adverse_action_id":{"$ref":"#/components/schemas/uuid","description":"ID of the pre-adverse action that reached a terminal state."},"status":{"type":"string","enum":["Closed"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Terminal status the pre-adverse action transitioned to."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Closed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — subject accepted the decision."},"children":[]}]}]}]}},"required":["pre_adverse_action_id","status"]},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/adverse-action-dispute-filed-event-body":{"id":"components/schemas/adverse-action-dispute-filed-event-body","kind":"json-schema","title":"adverse-action-dispute-filed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a subject files a dispute against a (pre-)adverse action. Fires for both"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pre-adverse and final-adverse disputes; use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to distinguish them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload is intentionally minimal. To retrieve full details — including"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dispute_filed_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dispute_resolved_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — fetch the parent (pre-)adverse action:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type: pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" → "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type: adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" → "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]}]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["adverse_action.dispute_filed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"adverse_action_id":{"$ref":"#/components/schemas/uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the (pre-)adverse action the dispute was filed against. Use with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to call the matching GET endpoint for full details."},"children":[]}]}]}]},"adverse_action_dispute_id":{"$ref":"#/components/schemas/uuid","description":"ID of the dispute record."},"adverse_action_type":{"type":"string","enum":["pre_adverse_action","adverse_action"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which lifecycle stage the dispute belongs to, and which GET endpoint to call."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — dispute against a pre-adverse action notice"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — dispute against a final adverse action"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"status":{"type":"string","enum":["DisputeFiled"],"description":"Status of the adverse action after the dispute was filed."}},"required":["adverse_action_id","adverse_action_dispute_id","adverse_action_type","status"]},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/adverse-action-dispute-resolved-event-body":{"id":"components/schemas/adverse-action-dispute-resolved-event-body","kind":"json-schema","title":"adverse-action-dispute-resolved-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when an admin resolves a filed dispute, either with changes to the report"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or without ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithoutChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Fires for both"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"pre-adverse and final-adverse disputes; use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to distinguish them."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The payload is intentionally minimal. To retrieve full details — including"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dispute_filed_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" / "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dispute_resolved_at"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — fetch the parent (pre-)adverse action:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type: pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" → "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type: adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" → "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]}]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["adverse_action.dispute_resolved"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"adverse_action_id":{"$ref":"#/components/schemas/uuid","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the (pre-)adverse action whose dispute was resolved. Use with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to call the matching GET endpoint for full details."},"children":[]}]}]}]},"adverse_action_dispute_id":{"$ref":"#/components/schemas/uuid","description":"ID of the dispute record."},"adverse_action_type":{"type":"string","enum":["pre_adverse_action","adverse_action"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which lifecycle stage the dispute belongs to, and which GET endpoint to call."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pre_adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — dispute against a pre-adverse action notice"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/pre_adverse_actions/{pre_adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"adverse_action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — dispute against a final adverse action"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/regulated/adverse_actions/{adverse_action_id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"status":{"type":"string","enum":["DisputeResolvedWithChanges","DisputeResolvedWithoutChanges"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resolution outcome."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the report was adjusted; reassess the subject's eligibility."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"DisputeResolvedWithoutChanges"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the report stands as-is."},"children":[]}]}]}]}},"required":["adverse_action_id","adverse_action_dispute_id","adverse_action_type","status"]},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/pre_adverse_action_record_context":{"id":"components/schemas/pre_adverse_action_record_context","kind":"json-schema","title":"pre_adverse_action_record_context","data":{"type":"object","description":"Additional context provided by the subject for a specific record.","properties":{"record_id":{"type":"string","description":"The ID of the record the subject is providing context for.","example":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"},"context":{"type":"string","description":"Additional context or explanation from the subject related to the record.","example":"This charge was expunged in 2019."},"has_attachments":{"type":"boolean","description":"Indicates whether the subject uploaded supporting attachments for this record.","example":false}}}},"components/schemas/pre_adverse_action_dispute":{"id":"components/schemas/pre_adverse_action_dispute","kind":"json-schema","title":"pre_adverse_action_dispute","data":{"type":"object","description":"A dispute filed by the subject against a specific disqualifying record.","properties":{"record_id":{"type":"string","description":"The ID of the record being disputed.","example":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"},"issue_type":{"type":"string","description":"The nature of the dispute.","enum":["charges_not_mine","charges_incorrect","charges_should_not_show","duplicate_record","other_error"],"example":"charges_not_mine"},"explanation":{"type":"string","description":"The subject's explanation for the dispute.","example":"I have never lived in that state."}}}},"components/schemas/pre_adverse_action_pii":{"id":"components/schemas/pre_adverse_action_pii","kind":"json-schema","title":"pre_adverse_action_pii","data":{"type":["object","null"],"description":"Updated personal information provided by the subject to support their response or dispute.","properties":{"first_name":{"type":"string","example":"John"},"middle_name":{"type":"string","example":"D"},"last_name":{"type":"string","example":"Smith"},"birth_month":{"type":"integer","example":5},"birth_day":{"type":"integer","example":25},"birth_year":{"type":"integer","example":1980},"ssn":{"type":"string","example":"XXX-XX-6789"},"addresses":{"type":"array","items":{"type":"object","properties":{"street":{"type":"string","example":"123 Main St"},"city":{"type":"string","example":"Austin"},"state":{"type":"string","example":"TX"},"zip_code":{"type":"string","example":"73301"}}}},"identification_documents":{"type":"array","items":{"type":"object","properties":{"driver_license":{"type":["object","null"],"properties":{"license_number":{"type":"string"},"license_state":{"type":"string"}}},"state_id":{"type":["object","null"],"properties":{"id_number":{"type":"string"},"issuing_state":{"type":"string"}}},"passport":{"type":["object","null"],"properties":{"number":{"type":"string"}}}}}}}}},"components/schemas/pre_adverse_action_feedback":{"id":"components/schemas/pre_adverse_action_feedback","kind":"json-schema","title":"pre_adverse_action_feedback","data":{"type":["object","null"],"description":"Information provided by the subject in response to the pre-adverse action notice.\nOnly populated after the subject has reviewed and responded to the notice.\n","properties":{"user_provided_answer":{"type":"string","description":"Whether the subject acknowledges the records.","enum":["none","yes","no","do_not_share"],"example":"no"},"contexts":{"type":"array","description":"Context provided by the subject for specific records.","items":{"$ref":"#/components/schemas/pre_adverse_action_record_context"}},"disputes":{"type":"array","description":"Disputes filed by the subject against specific records.","items":{"$ref":"#/components/schemas/pre_adverse_action_dispute"}},"pii":{"$ref":"#/components/schemas/pre_adverse_action_pii"}}}},"components/schemas/pre_adverse_action_detail_response":{"id":"components/schemas/pre_adverse_action_detail_response","kind":"json-schema","title":"pre_adverse_action_detail_response","data":{"allOf":[{"$ref":"#/components/schemas/pre_adverse_action_response"},{"type":"object","properties":{"feedback":{"$ref":"#/components/schemas/pre_adverse_action_feedback"},"dispute_filed_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when the subject filed a dispute. Null until a dispute is filed.","example":"2024-06-05T09:30:00Z"},"dispute_resolved_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when the dispute was resolved. Null until resolved.","example":"2024-06-15T11:00:00Z"}}}]}},"components/schemas/adverse_action_request":{"id":"components/schemas/adverse_action_request","kind":"json-schema","title":"adverse_action_request","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to finalize an adverse decision against the subject identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"check_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this when your organization is declining a subject based in whole or in part on the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results of a Checkr Trust background check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Delivers the required adverse action notice to the subject so they can seek assistance"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or initiate a dispute. In the event a dispute is resolved with changes to the report,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checkr Trust will notify your organization so you can reassess the subject's eligibility."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"May be submitted with or without a prior pre-adverse action."},"children":[]}]}]}],"properties":{"check_id":{"$ref":"#/components/schemas/uuid","description":"The ID of the regulated check that produced the records for this adverse action."},"email":{"$ref":"#/components/schemas/email_string","description":"Email address of the subject to deliver the notice to."},"suppress_notice":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the notice email is not sent to the subject. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"candidate_report_url"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is still populated in the response. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"disqualifying_records":{"type":"array","description":"The criminal records that triggered the adverse decision. Optional but recommended.","items":{"$ref":"#/components/schemas/disqualifying_record"}}},"required":["check_id","email"],"example":{"check_id":"a3f1e290-bc44-4d2a-9c18-d3e5f2a71b00","email":"john.smith@example.com","disqualifying_records":[{"record_id":"record-7480fc7edac1a09867849999f2a2f6eec3cc37150f4ba65cbd1f46a4a1a5c15e"}]}}},"components/schemas/adverse_action_response":{"id":"components/schemas/adverse_action_response","kind":"json-schema","title":"adverse_action_response","data":{"type":"object","description":"An adverse action record.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"check_id":{"$ref":"#/components/schemas/uuid","description":"The ID of the regulated check that produced the records for this adverse action."},"status":{"type":"string","description":"The status associated with the adverse action.","example":"AdverseActionInitiated"},"candidate_report_url":{"type":["string","null"],"format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Subject-facing URL for viewing the background check report and responding to the notice."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When a subject UI is configured this is a deep link keyed by the adverse action id,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"gated by a one-time code sent to the subject's email so the customer cannot open it"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"directly; you may still share it with the subject, and Checkr emails it to them unless"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"suppress_notice"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set. Where no subject UI is configured, this is a support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"mailto:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link instead (no OTP gating)."},"children":[]}]}]}],"example":"https://subjects.checkrtrust.com/2b8313e8-4efd-45a1-b578-952b8313e890/review"},"disqualifying_records":{"type":"array","items":{"$ref":"#/components/schemas/disqualifying_record"}},"created_at":{"$ref":"#/components/schemas/datetime"},"sent_at":{"type":["string","null"],"format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timestamp when the notice was delivered. Null until status is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"2024-06-01T14:00:00Z"}}}},"components/schemas/adverse_action_detail_response":{"id":"components/schemas/adverse_action_detail_response","kind":"json-schema","title":"adverse_action_detail_response","data":{"allOf":[{"$ref":"#/components/schemas/adverse_action_response"},{"type":"object","properties":{"dispute_filed_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when the subject filed a dispute. Null until a dispute is filed.","example":"2024-06-05T09:30:00Z"},"dispute_resolved_at":{"type":["string","null"],"format":"date-time","description":"Timestamp when the dispute was resolved. Null until resolved.","example":"2024-06-15T11:00:00Z"}}}]}},"components/schemas/county_fips_code_or_statewide":{"id":"components/schemas/county_fips_code_or_statewide","kind":"json-schema","title":"county_fips_code_or_statewide","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use a 5-digit county FIPS code for a county-level criminal search. Use the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"state-level criminal search covering the jurisdiction identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"state"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (the API accepts "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"case-insensitively and normalizes it to lowercase in stored search criteria)."},"children":[]}]}]}],"oneOf":[{"type":"string","pattern":"^\\d{5}$","example":"06075"},{"type":"string","enum":["statewide"]}]}},"components/schemas/regulated_county_check_request_from_pii":{"id":"components/schemas/regulated_county_check_request_from_pii","kind":"json-schema","title":"regulated_county_check_request_from_pii","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to create a regulated county check using personally identifiable information (PII)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set county_fips_code to the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to perform a state-level search instead of a county-level search."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with FCRA requirements."},"children":[]}]}]}],"type":"object","properties":{"first_name":{"description":"First name (given name). Do not include prefixes like \"Ms.\" or \"Dr.\"","type":"string","example":"Jane"},"middle_name":{"description":"Middle name(s)","type":"string","example":"Mary"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"Last name (surname). Do not include suffixes like \"Jr.\" or \"2nd\".","type":"string","example":"Smith"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]}]}]}],"type":"string","example":"Jane Mary Smith"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"state":{"description":"The two-letter US state code for the search jurisdiction.","$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"filter_context":{"$ref":"#/components/schemas/filter_context"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"address":{"$ref":"#/components/schemas/address","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-county-check-address-field.md"},"children":[]}]},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-county-check-addresses-field.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"ruleset_ids":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. Pass a single-element array if you only have one ruleset to apply."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: county check rulesets do not support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_matching_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_types_requiring_address_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_states"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"required":["dob","state","county_fips_code","filter_context","permissible_purpose"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"Jane","middle_name":"Mary","last_name":"Smith","dob":"19900115","state":"CA","county_fips_code":"06075","filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/regulated_county_check_request_from_profile":{"id":"components/schemas/regulated_county_check_request_from_profile","kind":"json-schema","title":"regulated_county_check_request_from_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a regulated county check from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set county_fips_code to the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to perform a state-level search instead of a county-level search."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A permissible purpose must be provided to comply with FCRA requirements."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"type":"object","properties":{"profile_id":{"description":"The unique identifier of an existing profile containing PII.","$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"state":{"description":"The two-letter US state code for the search jurisdiction.","$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"filter_context":{"$ref":"#/components/schemas/filter_context"},"permissible_purpose":{"$ref":"#/components/schemas/permissible_purpose"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"ruleset_ids":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. Pass a single-element array if you only have one ruleset to apply."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: county check rulesets do not support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_matching_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_types_requiring_address_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_states"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"required":["profile_id","state","county_fips_code","filter_context","permissible_purpose"],"example":{"profile_id":"2b8313e8-4efd-45a1-b578-952b8313e890","state":"CA","county_fips_code":"06075","filter_context":{"candidate_jurisdiction":{"state":"CA"},"decider_jurisdiction":{"state":"NY"}},"permissible_purpose":"Employment"}}},"components/schemas/regulated_county_check_request":{"id":"components/schemas/regulated_county_check_request","kind":"json-schema","title":"regulated_county_check_request","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to create a regulated county check, either from PII or from an existing profile."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_fips_code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is required: pass a 5-digit FIPS code for a county-level check, or the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level check."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/regulated_county_check_request_from_pii"},{"$ref":"#/components/schemas/regulated_county_check_request_from_profile"}]}},"components/schemas/regulated_county_check_type":{"id":"components/schemas/regulated_county_check_type","kind":"json-schema","title":"regulated_county_check_type","data":{"description":"The type of regulated county check.","type":"string","title":"regulated_county_check_type","enum":["county_criminal_regulated"],"default":"county_criminal_regulated"}},"components/schemas/regulated_county_check_status":{"id":"components/schemas/regulated_county_check_status","kind":"json-schema","title":"regulated_county_check_status","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the regulated county check."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the check has been submitted and is awaiting results."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — results are available."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the search was cancelled, either at your request or because it could not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be completed. When a search cannot be completed, a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_check.not_available"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is delivered."},"children":[]}]}]}]}],"type":"string","title":"regulated_county_check_status","enum":["pending","complete","cancelled"],"example":"pending"}},"components/schemas/check_error_reason":{"id":"components/schemas/check_error_reason","kind":"json-schema","title":"check_error_reason","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A machine-readable reason for a check's error status. Only present when the check has errored."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"provider_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the third-party data provider returned an unrecoverable error."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"timeout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the check did not complete within the allowed time window."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the check was cancelled, either at your request or because it could not be completed."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"need_more_info"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — additional identity information (e.g. email or SSN) is required to view results."},"children":[]}]}]}]}],"type":"string","title":"check_error_reason","enum":["provider_error","timeout","cancelled","need_more_info"],"example":"cancelled"}},"components/schemas/regulated_county_check_search_criteria":{"id":"components/schemas/regulated_county_check_search_criteria","kind":"json-schema","title":"regulated_county_check_search_criteria","data":{"description":"The search criteria used for the regulated county check.","type":"object","properties":{"first_name":{"description":"First name of the person.","type":"string","example":"Jane"},"middle_name":{"description":"Middle name of the person.","type":"string","example":"Mary"},"last_name":{"description":"Last name of the person.","type":"string","example":"Smith"},"date_of_birth":{"description":"Date of birth in the form YYYY-MM-DD.","allOf":[{"$ref":"#/components/schemas/date"}]},"state":{"description":"The two-letter US state code.","$ref":"#/components/schemas/state_code"},"county_fips_code":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The FIPS code for the county, or the literal "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"statewide"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for a state-level check."},"children":[]}]}]}],"$ref":"#/components/schemas/county_fips_code_or_statewide"}}}},"components/schemas/run_notes":{"id":"components/schemas/run_notes","kind":"json-schema","title":"run_notes","data":{"description":"An unstructured array of human-readable notes about this particular check.\nMay contain notes about how input was parsed or other information about results.\nNot intended to be parsed by computer, as these notes are not guaranteed to be in any given format.\n","type":"array","items":{"type":"string","example":"used no ruleset"}}},"components/schemas/regulated_county_check":{"id":"components/schemas/regulated_county_check","kind":"json-schema","title":"regulated_county_check","data":{"type":"object","description":"A regulated county criminal check response.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"description":"The timestamp when the check was completed. Null if still pending.","oneOf":[{"$ref":"#/components/schemas/datetime"},{"type":"null"}]},"check_type":{"$ref":"#/components/schemas/regulated_county_check_type"},"status":{"$ref":"#/components/schemas/regulated_county_check_status"},"error_reason":{"$ref":"#/components/schemas/check_error_reason"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"search_criteria":{"$ref":"#/components/schemas/regulated_county_check_search_criteria"},"results":{"description":"The results of the regulated county check.\nEmpty array if no records found or if the check is still pending.\n","type":"array","items":{"$ref":"#/components/schemas/regulated_record"}},"run_notes":{"$ref":"#/components/schemas/run_notes"},"review":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Null when no accept/decline/dispute decision exists for this check."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/check_review"},{"type":"null"}]},"adverse_action_enabled":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present only when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=review"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested; omitted otherwise."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether adverse-action workflow is enabled for this product."},"children":[]}]}]}],"type":"boolean"}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"regulated county check with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"regulated county check with profile object"}]}},"components/schemas/county-check-completed-event-body":{"id":"components/schemas/county-check-completed-event-body","kind":"json-schema","title":"county-check-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a regulated county check completes and results are available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object is the regulated county check resource."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["county_check.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"$ref":"#/components/schemas/regulated_county_check"},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/county-check-not-available-event-body":{"id":"components/schemas/county-check-not-available-event-body","kind":"json-schema","title":"county-check-not-available-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted for a regulated county check when the search cannot be completed and is cancelled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(e.g. the provider cancels the search). The check reports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no records are returned."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["county_check.not_available"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"$ref":"#/components/schemas/regulated_county_check"},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/county_check_request_from_pii":{"id":"components/schemas/county_check_request_from_pii","kind":"json-schema","title":"county_check_request_from_pii","data":{"description":"Request to create a county check using personally identifiable information (PII).","type":"object","properties":{"first_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"First name of the person. Required (with last_name) when not sending full_name or using profile_id."},"children":[]}]}]}],"type":"string","example":"Jane"},"middle_name":{"description":"Middle name of the person.","type":"string","example":"Mary"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Last name of the person. Required (with first_name) when not sending full_name or using profile_id."},"children":[]}]}]}],"type":"string","example":"Smith"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you already know the first and last names, we suggest sending them."},"children":[]}]}]}],"type":"string","example":"Jane Mary Smith"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required when not using profile_id."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"state":{"description":"The two-letter US state code for the search jurisdiction (county or statewide).","$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"lookback_period_in_years":{"description":"Optional number of years to look back for criminal records.\nIf not provided, the default lookback period configured for the account will be used.\n","type":"integer","minimum":1,"maximum":99,"example":7},"include_null_date_of_birth":{"description":"Optional override for this request indicating whether to include records with a null date of birth.\nIf omitted, your account's default setting is used (or 'true' if not configured).\n","type":"boolean","example":true},"reference_id":{"$ref":"#/components/schemas/reference_id"},"address":{"$ref":"#/components/schemas/address","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-county-check-address-field.md"},"children":[]}]},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-county-check-addresses-field.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"ruleset_ids":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. Pass a single-element array if you only have one ruleset to apply."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: county check rulesets do not support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_matching_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_types_requiring_address_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_states"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"required":["dob","state","county_fips_code"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"Jane","middle_name":"Mary","last_name":"Smith","dob":"19900115","state":"CA","county_fips_code":"06075","lookback_period_in_years":7}}},"components/schemas/county_check_request_from_profile":{"id":"components/schemas/county_check_request_from_profile","kind":"json-schema","title":"county_check_request_from_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a county check from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"type":"object","properties":{"profile_id":{"description":"The unique identifier of an existing profile containing PII.","$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"state":{"description":"The two-letter US state code for the search jurisdiction (county or statewide).","$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"lookback_period_in_years":{"description":"Optional number of years to look back for criminal records.\nIf not provided, the default lookback period configured for the account will be used.\n","type":"integer","minimum":1,"maximum":99,"example":7},"include_null_date_of_birth":{"description":"Optional override for this request indicating whether to include records with a null date of birth.\nIf omitted, your account's default setting is used (or 'true' if not configured).\n","type":"boolean","example":true},"reference_id":{"$ref":"#/components/schemas/reference_id"},"ruleset_ids":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. Pass a single-element array if you only have one ruleset to apply."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: county check rulesets do not support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_matching_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_types_requiring_address_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_states"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"required":["profile_id","state","county_fips_code"],"example":{"profile_id":"2b8313e8-4efd-45a1-b578-952b8313e890","state":"CA","county_fips_code":"06075","lookback_period_in_years":7}}},"components/schemas/county_check_request_from_case_number":{"id":"components/schemas/county_check_request_from_case_number","kind":"json-schema","title":"county_check_request_from_case_number","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to create a county check by searching for a specific court case number."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this mode when you have a known case number from a court record instead of subject PII."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is mutually exclusive with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"lookback_period_in_years"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Case number search is currently supported only in "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"NC"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"object","properties":{"case_number":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The court case number to search for. Must contain only letters, numbers, spaces, and hyphens."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example NC case number format: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1992CRS000215"},"children":[]}]}]}],"type":"string","pattern":"^[A-Za-z0-9\\- ]+$","example":"1992CRS000215"},"state":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The two-letter US state code for the search jurisdiction."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Case number search is supported only for "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"NC"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"MN"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"ruleset_ids":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of ruleset identifiers to apply. Pass a single-element array if you only have one ruleset to apply."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: county check rulesets do not support "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_matching_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob_types_requiring_address_match"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"source_states"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/ruleset_id"}}},"required":["case_number","state","county_fips_code"],"example":{"case_number":"1992CRS000215","state":"NC","county_fips_code":"37063"}}},"components/schemas/county_check_request":{"id":"components/schemas/county_check_request","kind":"json-schema","title":"county_check_request","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to create a county check. Supports three mutually exclusive search modes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PII search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Profile search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provide an existing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Case number search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provide a court "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (NC and MN only)"},"children":[]}]}]}]}],"oneOf":[{"$ref":"#/components/schemas/county_check_request_from_pii"},{"$ref":"#/components/schemas/county_check_request_from_profile"},{"$ref":"#/components/schemas/county_check_request_from_case_number"}]}},"components/schemas/county_check_type":{"id":"components/schemas/county_check_type","kind":"json-schema","title":"county_check_type","data":{"description":"The type of county check.","type":"string","title":"county_check_type","enum":["county_criminal"],"default":"county_criminal"}},"components/schemas/county_check_status":{"id":"components/schemas/county_check_status","kind":"json-schema","title":"county_check_status","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status of the county check."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"pending"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the check has been submitted and is awaiting results."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — results are available. A "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal.completed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook is delivered."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — the search was cancelled, either at your request or because it could not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be completed. When a search cannot be completed, a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"county_criminal.not_available"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" webhook"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"is delivered."},"children":[]}]}]}]}],"type":"string","title":"county_check_status","enum":["pending","complete","cancelled"],"example":"pending"}},"components/schemas/county_check_search_criteria":{"id":"components/schemas/county_check_search_criteria","kind":"json-schema","title":"county_check_search_criteria","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The search criteria used for the county check. Field presence depends on how the check was submitted:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"PII or profile search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — includes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and usually "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"date_of_birth"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(from the request or linked profile). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is omitted."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Case number search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" — includes "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Name and date-of-birth fields are omitted."},"children":[]}]}]}]}],"type":"object","properties":{"first_name":{"description":"First name of the person. Present for PII and profile searches; omitted for case-number searches.","type":"string","example":"Jane"},"middle_name":{"description":"Middle name of the person. Present for PII and profile searches when supplied; omitted for case-number searches.","type":"string","example":"Mary"},"last_name":{"description":"Last name of the person. Present for PII and profile searches; omitted for case-number searches.","type":"string","example":"Smith"},"date_of_birth":{"description":"Date of birth in the form YYYY-MM-DD. Present for PII and profile searches; omitted for case-number searches.","allOf":[{"$ref":"#/components/schemas/date"}]},"state":{"description":"The two-letter US state code.","$ref":"#/components/schemas/state_code"},"county_fips_code":{"$ref":"#/components/schemas/county_fips_code_or_statewide"},"lookback_period_in_years":{"description":"The number of years to look back for criminal records. Present for PII and profile searches;\nomitted for case-number searches.\n","type":"integer","example":7},"case_number":{"description":"The court case number used for the search. Present only for case-number searches;\nomitted for PII and profile searches.\n","type":"string","example":"1992CRS000215"}}}},"components/schemas/county_check":{"id":"components/schemas/county_check","kind":"json-schema","title":"county_check","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A county criminal check response. Case-number searches always return "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id: null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"required":["id","created_at","check_type","status","search_criteria","results"],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"description":"The timestamp when the check was completed. Null if still pending.","oneOf":[{"$ref":"#/components/schemas/datetime"},{"type":"null"}]},"check_type":{"$ref":"#/components/schemas/county_check_type"},"status":{"$ref":"#/components/schemas/county_check_status"},"error_reason":{"$ref":"#/components/schemas/check_error_reason"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"search_criteria":{"$ref":"#/components/schemas/county_check_search_criteria"},"results":{"description":"The results of the county check.\nEmpty array if no records found or if the check is still pending.\n","type":"array","items":{"$ref":"#/components/schemas/record"}},"run_notes":{"$ref":"#/components/schemas/run_notes"},"profile_id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Profile UUID when the check is associated with a profile. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for case-number searches."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Omitted when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=profile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used — use the nested "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object instead."},"children":[]}]}]}],"oneOf":[{"$ref":"#/components/schemas/profile_id"},{"type":"null"}]},"profile":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Nested profile when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"include[]=profile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested. Omitted for case-number searches,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"which are not associated with a profile."},"children":[]}]}]}],"$ref":"#/components/schemas/profile"}}}},"components/schemas/county-criminal-completed-event-body":{"id":"components/schemas/county-criminal-completed-event-body","kind":"json-schema","title":"county-criminal-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a county criminal check completes and results are available"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object is the county check resource."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["county_criminal.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"$ref":"#/components/schemas/county_check"},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/county-criminal-not-available-event-body":{"id":"components/schemas/county-criminal-not-available-event-body","kind":"json-schema","title":"county-criminal-not-available-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted for a county criminal check when the search cannot be completed and is cancelled"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(e.g. the provider cancels the search). The check reports "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no records are returned."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["county_criminal.not_available"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"$ref":"#/components/schemas/county_check"},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/county_check_cancel_request":{"id":"components/schemas/county_check_cancel_request","kind":"json-schema","title":"county_check_cancel_request","data":{"description":"Request to cancel a pending county check.","type":"object","properties":{"reason":{"description":"The reason for cancelling the county check.","type":"string","minLength":1,"maxLength":500,"example":"Candidate withdrew application"}},"required":["reason"],"example":{"reason":"Candidate withdrew application"}}},"components/schemas/criminal_check":{"id":"components/schemas/criminal_check","kind":"json-schema","title":"criminal_check","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A criminal check result. Results are only available after webhook delivery (completed_at is set)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Before webhook delivery, the results array will be empty."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/check"},{"type":"object","properties":{"completed_at":{"description":"Timestamp when the check was completed and webhook was delivered.","type":"string","format":"date-time"}}}]}},"components/schemas/criminal-check-request-from-pii-base":{"id":"components/schemas/criminal-check-request-from-pii-base","kind":"json-schema","title":"criminal-check-request-from-pii-base","data":{"type":"object","properties":{"input_type":{"$ref":"#/components/schemas/input_type"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If invalid, the API returns a 400 with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validation_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pointing to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"description":"Social Security Number used for additional identity verification and record matching","$ref":"#/components/schemas/ssn_string"},"phone":{"$ref":"#/components/schemas/phone_string"},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-check-addresses-field-criminal-search.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"},"order_by":{"$ref":"#/components/schemas/order_by"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"allow_duplicate_criminal_records":{"$ref":"#/components/schemas/check_request_allow_duplicate_criminal_records"}}}},"components/schemas/criminal-check-request-from-pii":{"id":"components/schemas/criminal-check-request-from-pii","kind":"json-schema","title":"criminal-check-request-from-pii","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request to create a new criminal check using PII."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"first_name + last_name"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (optional "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"middle_name"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"or"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" a single "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"full_name"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" string, but not both."},"children":[]}]}]}],"allOf":[{"type":"object","properties":{"first_name":{"description":"First name (given name). Do not include prefixes such as \"Ms.\" or \"Dr.\"\n","type":"string","example":"Jane"},"middle_name":{"description":"Middle name(s). Optional.","type":"string","example":"Mary Louise"},"last_name":{"description":"Last name (surname). Do not include suffixes such as \"Jr.\" or \"2nd\".\n","type":"string","example":"O'Donnell-Van Helsing"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and then use those for the check. With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"into the last name instead of being stored as a middle name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you already know the first and last names, we suggest sending them."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The parser will attempt to remove prefixes and suffixes, and handles several different formats of name,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but we cannot guarantee it will parse the name in the manner you expect."},"children":[]}]}]}],"type":"string","example":"O'Donnell-Van Helsing, Dr. Jane Mary Louise, MD"}}},{"$ref":"#/components/schemas/criminal-check-request-from-pii-base"},{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"JOHN","last_name":"SMITH","dob":"19900101","ssn":"123-45-6789","phone":"+14155552671","addresses":[{"street":"456 Oak Ave","city":"Los Angeles","state":"CA","zip_code":"90001"}]}}},"components/schemas/criminal-check-request-from-profile":{"id":"components/schemas/criminal-check-request-from-profile","kind":"json-schema","title":"criminal-check-request-from-profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a criminal check from an existing profile. Do not include inline PII or address fields alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: check_type is automatically set to 'criminal_check' and cannot be specified."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"type":"object","properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"input_type":{"$ref":"#/components/schemas/input_type"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"source_states":{"$ref":"#/components/schemas/source_states"},"order_by":{"$ref":"#/components/schemas/order_by"},"allow_duplicate_criminal_records":{"$ref":"#/components/schemas/check_request_allow_duplicate_criminal_records"}},"required":["profile_id"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080"}}},"components/schemas/criminal-check-completed-event-body":{"id":"components/schemas/criminal-check-completed-event-body","kind":"json-schema","title":"criminal-check-completed-event-body","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Emitted when a criminal check completes. The embedded "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"data.profile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object does not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"include an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field — SSN is intentionally omitted from webhook payloads."},"children":[]}]}]}],"properties":{"id":{"$ref":"#/components/schemas/uuid"},"object":{"type":"string","enum":["event"]},"type":{"type":"string","enum":["criminal_check.completed"]},"created_at":{"$ref":"#/components/schemas/datetime"},"data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"results":{"description":"When there are no results found, this will be an empty array.","type":"array","items":{"$ref":"#/components/schemas/record"}},"profile":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile associated with this check. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field is not present in webhook payloads."},"children":[]}]}]}],"$ref":"#/components/schemas/profile"},"check_type":{"type":"string","enum":["criminal_check"]},"input_type":{"$ref":"#/components/schemas/input_type"},"reference_id":{"$ref":"#/components/schemas/reference_id"}}},"account_id":{"$ref":"#/components/schemas/uuid"}},"required":["id","object","type","created_at","data","account_id"]}},"components/schemas/matched_profile_limit":{"id":"components/schemas/matched_profile_limit","kind":"json-schema","title":"matched_profile_limit","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Maximum number of matched profiles to return in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", ranked by identity match strength"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(best first). Send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" when you only want the single best identity match; raise it to review"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"several candidate identities. This limits profiles only -- each returned profile still carries"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"all of its records."},"children":[]}]}]}],"type":"integer","minimum":1,"maximum":20,"default":10,"example":5}},"components/schemas/profile_criminal_check_request_from_pii":{"id":"components/schemas/profile_criminal_check_request_from_pii","kind":"json-schema","title":"profile_criminal_check_request_from_pii","data":{"description":"Create a profile criminal check using inline PII.","type":"object","properties":{"first_name":{"description":"first name (given name). Do not include prefixes, like \"Ms.\" or \"Dr.\"","type":"string","example":"Marcus"},"middle_name":{"description":"middle name(s)","type":"string"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"description":"last name (surname). Do not include suffixes, like \"Jr.\" or \"2nd\".","type":"string","example":"Williams"},"full_name":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first and last names, but not both. If you send a full name,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Checkr Trust will attempt to parse it into first name, middle name(s), and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]}]}]}],"type":"string"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in the form YYYYMMDD. Not required by this schema, but in practice a search"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"without a date of birth cannot be satisfied by our identity provider today and returns"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 provider_error"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"$ref":"#/components/schemas/ssn_string"},"phone":{"$ref":"#/components/schemas/phone_string"},"email":{"$ref":"#/components/schemas/email_string"},"custom_id":{"$ref":"#/components/schemas/custom_id_string"},"address":{"$ref":"#/components/schemas/address","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-inline-address-persistence-singular-or-plural.md"},"children":[]}]},"addresses":{"$ref":"#/components/schemas/addresses","description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-inline-address-persistence-singular-or-plural.md"},"children":[]}]},"reference_id":{"$ref":"#/components/schemas/reference_id"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"limit":{"$ref":"#/components/schemas/matched_profile_limit"}},"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"Marcus","last_name":"Williams","dob":"19880315"}}},"components/schemas/profile_criminal_check_request_from_profile":{"id":"components/schemas/profile_criminal_check_request_from_profile","kind":"json-schema","title":"profile_criminal_check_request_from_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create a profile criminal check from an existing profile. Do not include inline PII fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -- the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"type":"object","properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"ruleset_id":{"$ref":"#/components/schemas/ruleset_id"},"ruleset_ids":{"$ref":"#/components/schemas/ruleset_ids"},"limit":{"$ref":"#/components/schemas/matched_profile_limit"}},"required":["profile_id"]}},"components/schemas/profile_criminal_check_type":{"id":"components/schemas/profile_criminal_check_type","kind":"json-schema","title":"profile_criminal_check_type","data":{"type":"string","enum":["profile_criminal_check"]}},"components/schemas/profile_match_confidence_level":{"id":"components/schemas/profile_match_confidence_level","kind":"json-schema","title":"profile_match_confidence_level","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Identity match confidence"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this matched profile, based on how strongly the identity"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"matched by our people data graph aligns with the PII you submitted for the check."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The values "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"medium"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"low"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are assigned based on Checkr's proprietary ML algorithm."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is measured independently from each record's own "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"identity_match_confidence_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (see the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"/"},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"case"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema) -- a profile-level \"high\" and a record-level \"high\" are not derived from"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the same measurement and should not be compared to each other."},"children":[]}]}]}],"type":"string","enum":["high","medium","low"],"example":"high","x-enumDescriptions":{"high":"Strong identity alignment with the searched subject.","medium":"Moderate alignment with the searched subject.","low":"Weak alignment with the searched subject."}}},"components/schemas/name_variation":{"id":"components/schemas/name_variation","kind":"json-schema","title":"name_variation","data":{"type":"object","description":"One name variation on file for the matched profile.","properties":{"full_name":{"type":"string","example":"Marcus G Williams"},"first_name":{"type":"string","example":"Marcus"},"middle_name":{"type":"string","example":"G"},"last_name":{"type":"string","example":"Williams"}}}},"components/schemas/matched_profile_identity":{"id":"components/schemas/matched_profile_identity","kind":"json-schema","title":"matched_profile_identity","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A conservative identity summary for the matched profile. This summary intentionally does not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"include raw contact PII (emails, phone numbers) or document numbers, even when the underlying"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"identity provider carries them -- that exclusion applies only to this identity summary, not to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the matched profile's nested "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"records[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", which may legitimately include a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"doc_number"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" as"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"court-record data (see the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema)."},"children":[]}]}]}],"type":"object","properties":{"name_variations":{"description":"Name variations on file for this identity, most authoritative first, capped at 10 entries.\n","type":"array","items":{"$ref":"#/components/schemas/name_variation"}},"dates_of_birth":{"description":"Dates of birth on file for this identity.","type":"array","items":{"$ref":"#/components/schemas/date_string_partial"}},"gender":{"type":"string","enum":["male","female","non_binary","other"],"example":"male"},"states":{"description":"US states associated with this identity's addresses on file.","type":"array","items":{"$ref":"#/components/schemas/state_code"},"example":["FL","GA"]},"photo_urls":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A set of URLs referencing photos of this person: photos on file for this identity, plus"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any photos attached to this matched profile's returned "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"records[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (for example, a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"criminal record's mugshot). Only records visible in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"records[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" contribute here -- a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"record filtered out of the response never adds a photo to this list. Deduplicated, capped"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"at 20 entries. Same field name and shape as Instant Criminal Checks'"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record.person.photo_urls"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"array","items":{"type":"string","format":"uri"},"example":["https://example.com/pictures/marcus-selfie.jpg"]}}}},"components/schemas/matched_profile":{"id":"components/schemas/matched_profile","kind":"json-schema","title":"matched_profile","data":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A single identity matched by the search, with its own nested criminal records. A check's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array may contain zero, one, or more matched profiles. Matched profiles are not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"individually identifiable -- refer to them by their position in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array (for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"example, \"the 1st match\" or \"the 5th match\")."},"children":[]}]}]}],"type":"object","properties":{"match_confidence_level":{"$ref":"#/components/schemas/profile_match_confidence_level"},"identity":{"$ref":"#/components/schemas/matched_profile_identity"},"records":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Criminal records associated with this matched profile. Same shape as the Instant Criminal Checks "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"record"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" schema."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/record"}}}}},"components/schemas/profile_criminal_check":{"id":"components/schemas/profile_criminal_check","kind":"json-schema","title":"profile_criminal_check","data":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"check_type":{"$ref":"#/components/schemas/profile_criminal_check_type"},"input_type":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Always "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"person"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for this product -- profile_criminal_check has no address-based search path."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/input_type"}]},"reference_id":{"$ref":"#/components/schemas/reference_id"},"results_info":{"type":"object","properties":{"profiles_returned":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Count of matched-profile entries in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" -- i.e. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results.length"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Capped by the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"request's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (or its default/max), and reduced further by any ruleset applied on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the request: a matched profile whose records are all excluded by the ruleset is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"dropped from "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" entirely, so this count reflects what actually comes back, not"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"just what PDG matched."},"children":[]}]}]}],"type":"integer","minimum":0}}},"results":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array of matched identities (profiles), each with its own nested records. Empty array when"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"no identity matched, or when a ruleset applied on the request excludes every record for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"every matched profile. Sorted by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"match_confidence_level"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'s underlying score, descending --"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the best match is always first. Capped at the request's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default 10, max 20); a"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"matched profile left with no records after ruleset filtering is omitted rather than"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned with an empty "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"records"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array. This ordering is a stable contract you can rely on:"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"matched profiles are not otherwise individually identifiable (no "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is exposed),"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"so position in this array is the only way to refer to a specific match (e.g. \"the 1st match\")."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/matched_profile"}}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"profile criminal check with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"profile criminal check with profile object"}]}},"components/schemas/eviction_subject":{"id":"components/schemas/eviction_subject","kind":"json-schema","title":"eviction_subject","data":{"title":"eviction_subject","type":"object","description":"Identity information for the subject of the eviction record, as reported by the data provider.","properties":{"full_name":{"type":["string","null"],"description":"Full name of the subject as recorded on the eviction record.","example":"Patricia Ann Holloway"},"dob":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth of the subject in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), if available."},"children":[]}]}]}],"example":"1985-03-14"},"address":{"type":["string","null"],"description":"Address of the subject as recorded on the eviction record.","example":"482 Birch Lane, Springfield, IL 62704"},"aliases":{"type":["string","null"],"description":"Known aliases or alternate names for the subject, as reported by the data provider.","example":"P. Holloway"},"state":{"type":["string","null"],"description":"State associated with the subject record.","example":"IL"},"jurisdiction":{"type":["string","null"],"description":"Jurisdiction in which the eviction record originates.","example":"Sangamon County"},"source":{"type":["string","null"],"description":"Data source identifier for the record, as assigned by the data provider.","example":"IL_SANG_EVICT"},"case_number":{"type":["string","null"],"description":"Case number as recorded on the subject record.","example":"2023-EV-004471"},"category":{"type":["string","null"],"description":"Match category assigned by the data provider (e.g. the type of match or record classification).","example":"Eviction"},"status":{"type":["string","null"],"description":"Status of the subject record as reported by the data provider.","example":"Active"},"comments":{"type":["string","null"],"description":"Free-text comments associated with the subject record, if any.","example":null}}}},"components/schemas/eviction_plaintiff":{"id":"components/schemas/eviction_plaintiff","kind":"json-schema","title":"eviction_plaintiff","data":{"title":"eviction_plaintiff","type":"object","description":"Information about the plaintiff in the eviction case.","properties":{"name":{"type":["string","null"],"description":"Name of the plaintiff (typically the landlord or property management company).","example":"Riverstone Property Management LLC"},"phone":{"type":["string","null"],"description":"Phone number of the plaintiff.","example":"217-555-0182"},"attorney":{"type":["string","null"],"description":"Name of the plaintiff's attorney, if represented.","example":"Gregory L. Marsh"},"attorney_phone":{"type":["string","null"],"description":"Phone number of the plaintiff's attorney.","example":"217-555-0199"}}}},"components/schemas/eviction_judgement":{"id":"components/schemas/eviction_judgement","kind":"json-schema","title":"eviction_judgement","data":{"title":"eviction_judgement","type":"object","description":"Details of the judgement rendered in the eviction case.","properties":{"date":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the judgement was entered, in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"2023-07-05"},"amount_cents":{"type":["integer","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Monetary amount of the judgement in cents (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"250000"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" = $2,500.00). Null if no monetary judgement."},"children":[]}]}]}],"example":347500},"type":{"type":["string","null"],"description":"Type of judgement as reported by the court (format varies by jurisdiction).","example":"Judgment for Plaintiff"},"for":{"type":["string","null"],"description":"Party in whose favor the judgement was rendered.","example":"Plaintiff"},"satisfaction_amount_cents":{"type":["integer","null"],"description":"Amount in cents by which the judgement has been satisfied. Null if not satisfied.","example":null},"release_date":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the judgement was released or satisfied, in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Null if not yet released."},"children":[]}]}]}],"example":null}}}},"components/schemas/eviction_case":{"id":"components/schemas/eviction_case","kind":"json-schema","title":"eviction_case","data":{"title":"eviction_case","type":"object","description":"Court filing and judgement details for the eviction case.","properties":{"court":{"type":["string","null"],"description":"Name of the court where the eviction case was filed.","example":"Sangamon County Circuit Court"},"case_number":{"type":["string","null"],"description":"Case number assigned by the court.","example":"2023-EV-004471"},"filing_date":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the eviction case was filed, in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":"2023-06-12"},"notice_type":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The type of eviction notice that was filed (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"Unlawful Detainer\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"Forcible Entry and Detainer\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"Pay or Quit\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Format varies by jurisdiction."},"children":[]}]}]}],"example":"Forcible Entry and Detainer"},"agency_state":{"type":["string","null"],"description":"Two-letter state code of the agency that handled the case.","example":"IL"},"agency_county":{"type":["string","null"],"description":"County of the agency that handled the case.","example":"Sangamon"},"dismissal_date":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date the case was dismissed, in ISO 8601 format ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYY-MM-DD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). Null if not dismissed."},"children":[]}]}]}],"example":null},"default_judgement":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the judgement was entered by default — i.e. the defendant did not appear or respond."},"children":[]}]}]}],"example":true},"restored_premises":{"type":"boolean","description":"Whether the premises were restored (returned) to the plaintiff following the judgement.","example":false},"plaintiff":{"$ref":"#/components/schemas/eviction_plaintiff"},"judgement":{"$ref":"#/components/schemas/eviction_judgement"}}}},"components/schemas/eviction_result":{"id":"components/schemas/eviction_result","kind":"json-schema","title":"eviction_result","data":{"title":"eviction_result","type":"object","description":"A single matched candidate record from an eviction search.","properties":{"first_name":{"type":"string","description":"First name of the matched candidate.","example":"Patricia"},"last_name":{"type":"string","description":"Last name of the matched candidate.","example":"Holloway"},"middle_name":{"type":["string","null"],"description":"Middle name of the matched candidate, if available.","example":"Ann"},"address":{"type":["string","null"],"description":"Street address associated with the matched candidate.","example":"482 Birch Lane"},"city":{"type":["string","null"],"description":"City associated with the matched candidate.","example":"Springfield"},"state":{"type":["string","null"],"description":"Two-letter state code associated with the matched candidate.","example":"IL"},"zip_code":{"type":["string","null"],"description":"ZIP code associated with the matched candidate.","example":"62704"},"zone":{"type":["string","null"],"description":"The geographic search zone that produced this match.\nTypically corresponds to a metropolitan area, county, or regional search boundary used by the data provider.\n","example":"Springfield Metro"},"subject":{"$ref":"#/components/schemas/eviction_subject"},"case":{"$ref":"#/components/schemas/eviction_case"}}}},"components/schemas/eviction_check":{"id":"components/schemas/eviction_check","kind":"json-schema","title":"eviction_check","data":{"type":"object","description":"An eviction check and its results.","properties":{"id":{"$ref":"#/components/schemas/uuid"},"created_at":{"$ref":"#/components/schemas/datetime"},"completed_at":{"$ref":"#/components/schemas/datetime"},"reference_id":{"$ref":"#/components/schemas/reference_id"},"results":{"description":"Array of matched candidate records. Each item represents one person matched against the search inputs.\nWhen no eviction records are found, this will be an empty array.\n","type":"array","items":{"$ref":"#/components/schemas/eviction_result"}},"run_notes":{"description":"An unstructured array of human-readable notes about this particular check.\nMay contain notes about how input was parsed or other information about results.\nNot intended to be parsed by computer, as these notes are not guaranteed to be in any given format.\n","type":"array","items":{"type":"string","example":"changed last_name from 'Smith Jr' to 'Smith'"}}},"oneOf":[{"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"}},"title":"eviction check with profile id"},{"properties":{"profile":{"$ref":"#/components/schemas/profile"}},"title":"eviction check with profile object"}]}},"components/schemas/property_zip":{"id":"components/schemas/property_zip","kind":"json-schema","title":"property_zip","data":{"type":"string","pattern":"^\\d{5}(-\\d{4})?$","description":"ZIP code of the property being evaluated. When provided, eviction records are\nfiltered to those reportable under FCRA for that property location.\n","example":"62704"}},"components/schemas/eviction-check-request-from-pii":{"id":"components/schemas/eviction-check-request-from-pii","kind":"json-schema","title":"eviction-check-request-from-pii","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an eviction check by providing PII directly. Provide either "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"full_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"last_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (not both). "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are also required."},"children":[]}]}]}],"properties":{"first_name":{"type":"string","description":"First name (given name). Do not include prefixes like \"Ms.\" or \"Dr.\"","example":"Patricia"},"middle_name":{"type":"string","description":"Middle name(s).","example":"Ann"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"last_name":{"type":"string","description":"Last name (surname). Do not include suffixes like \"Jr.\" or \"2nd\".","example":"Holloway"},"full_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either send the full name, or first, middle (optional), and last names, but not both."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you send a full name, we will attempt to parse it into first name, middle name(s) and last name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"With "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name: true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", any parsed middle token is folded into the last name instead of"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"being stored as a middle name."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you already know the first and last names, we suggest sending them."},"children":[]}]}]}],"example":"Patricia Ann Holloway"},"dob":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Date of birth in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"YYYYMMDD"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" format. Strongly encouraged — providing a DOB significantly reduces false positives."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Must be a valid date and cannot be in the future."},"children":[]}]}]}],"allOf":[{"$ref":"#/components/schemas/date_string_complete"}]},"ssn":{"description":"Social Security Number. Required to run an eviction search.","allOf":[{"$ref":"#/components/schemas/ssn_string"}]},"addresses":{"description":[{"$$mdtype":"Node","type":"tag","tag":"partial","attributes":{"file":"_partials/schema-eviction-addresses-field-inline.md"},"children":[]}],"$ref":"#/components/schemas/addresses"},"property_zip":{"$ref":"#/components/schemas/property_zip"},"permissible_purpose":{"description":"The permissible purpose for requesting this eviction check, as required by the Fair Credit Reporting Act (FCRA).\nThis must be provided for all regulated eviction checks to ensure compliance with federal regulations.\n","allOf":[{"$ref":"#/components/schemas/permissible_purpose"}]},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"required":["ssn","addresses","permissible_purpose"],"allOf":[{"$ref":"#/components/schemas/name_full_or_split_required"},{"$ref":"#/components/schemas/middle_name_no_middle_name_exclusive"}],"example":{"first_name":"Patricia","last_name":"Holloway","dob":"19850314","ssn":"123-45-6789","permissible_purpose":"Employment","addresses":[{"street":"482 Birch Lane","city":"Springfield","state":"IL","zip_code":"62704"}]}}},"components/schemas/eviction-check-request-from-profile":{"id":"components/schemas/eviction-check-request-from-profile","kind":"json-schema","title":"eviction-check-request-from-profile","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Create an eviction check from an existing profile. Do not include inline name/identity fields ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"first_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"dob"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"ssn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", etc.) alongside "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"—the API rejects combined requests with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"400 Bad Request"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"addresses"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"permissible_purpose"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (both required), plus "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"property_zip"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", may accompany "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The profile must have an SSN on record — it is required to run an eviction search."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"no_middle_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided, it is persisted to the referenced profile, updating"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"any previously stored value."},"children":[]}]}]}],"properties":{"profile_id":{"$ref":"#/components/schemas/profile_id"},"no_middle_name":{"$ref":"#/components/schemas/no_middle_name"},"addresses":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An array of addresses associated with the person. Required — at least"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"one address is needed to scope the eviction search. Addresses stored on"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the profile are not used as a fallback and must be explicitly provided"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in the request."},"children":[]}]}]}],"$ref":"#/components/schemas/addresses"},"property_zip":{"$ref":"#/components/schemas/property_zip"},"permissible_purpose":{"description":"The permissible purpose for requesting this eviction check, as required by the Fair Credit Reporting Act (FCRA).\nThis must be provided for all regulated eviction checks to ensure compliance with federal regulations.\n","allOf":[{"$ref":"#/components/schemas/permissible_purpose"}]},"reference_id":{"$ref":"#/components/schemas/reference_id"}},"required":["profile_id","addresses","permissible_purpose"],"example":{"profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080","permissible_purpose":"Employment","addresses":[{"street":"482 Birch Lane","city":"Springfield","state":"IL","zip_code":"62704"}]}}},"schema_51":{"kind":"json-schema","data":{"type":"object","properties":{"client_id":{"type":"string","example":"your-client-id"},"client_secret":{"type":"string","example":"your-client-secret"},"grant_type":{"type":"string","enum":["client_credentials"],"example":"client_credentials","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"OAuth 2.0 grant type. If omitted, client_credentials is assumed. Any other value is rejected."},"children":[]}]}]}]},"scope":{"type":"string","example":"read:account create:account","description":"Optional. Ignored; scopes are assigned from the client configuration."}},"required":["client_id","client_secret"]},"id":"schema_51"},"schema_52":{"kind":"json-schema","data":{"type":"integer","minimum":0,"maximum":999999,"default":10},"id":"schema_52"},"schema_53":{"kind":"json-schema","data":{"type":"integer","minimum":0,"maximum":999999,"default":0},"id":"schema_53"},"schema_54":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/bulk_upload"}},"id":"schema_54"},"schema_55":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"2b8313e8-b578-45a1-4efd-952b8313e890"},"id":"schema_55"},"schema_56":{"kind":"json-schema","data":{"type":"string","format":"binary"},"id":"schema_56"},"schema_57":{"kind":"json-schema","data":{"type":"string","enum":["csv","xlsx"],"default":"csv"},"id":"schema_57"},"schema_58":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Bulk upload enqueued for processing"}},"required":["message"]},"id":"schema_58"},"schema_59":{"kind":"json-schema","data":{"type":"object","properties":{"message":{"type":"string","example":"Result file regeneration enqueued"}},"required":["message"]},"id":"schema_59"},"schema_60":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile","results_found"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"results_found":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results_found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (boolean) instead of the full "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]}]}]}]}}},"id":"schema_60"},"schema_61":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/check"}},"id":"schema_61"},"schema_62":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile","rulesets_applied"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"rulesets_applied":"Embeds the rulesets applied when filtering this check's results."}}},"id":"schema_62"},"schema_63":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/check-request-from-pii"},{"$ref":"#/components/schemas/check-request-from-address"},{"$ref":"#/components/schemas/check-request-from-profile"}]},"id":"schema_63"},"schema_64":{"kind":"json-schema","data":{"type":"object","properties":{"X-RateLimit-Limit":{"type":"string","example":"100","description":"Maximum number of API calls allowed for this product configuration."},"X-RateLimit-Remaining":{"type":"string","example":"0","description":"Number of calls remaining in the current limit period."},"X-RateLimit-Expires":{"type":["string","null"],"format":"date-time","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ISO 8601 timestamp after which product access expires (present only when access_expires_at is set)."},"children":[]}]}]}]}}},"id":"schema_64"},"schema_65":{"kind":"json-schema","data":{"type":"string","format":"uuid","example":"2b8313e8-4efd-45a1-b578-952b8313e890"},"id":"schema_65"},"schema_66":{"kind":"json-schema","data":{"type":"object","properties":{"Content-Disposition":{"type":"string","example":"attachment; filename=\"checkr_trust_report2b8313e8-4efd-45a1-b578-952b8313e890.pdf\"","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attachment with suggested filename "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"checkr_trust_report{check_id}.pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"id":"schema_66"},"schema_67":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Report not found"}},"required":["error"]},"id":"schema_67"},"schema_68":{"kind":"json-schema","data":{"type":"object","properties":{"error":{"type":"string","example":"Results are not yet available for this check"}},"required":["error"]},"id":"schema_68"},"schema_69":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full submitted profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"id":"schema_69"},"schema_70":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/profile_criminal_check_request_from_pii"},{"$ref":"#/components/schemas/profile_criminal_check_request_from_profile"}]},"id":"schema_70"},"schema_71":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/criminal_check"}},"id":"schema_71"},"schema_72":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"id":"schema_72"},"schema_73":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/criminal-check-request-from-pii"},{"$ref":"#/components/schemas/criminal-check-request-from-profile"}]},"id":"schema_73"},"schema_74":{"kind":"json-schema","data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the created check"},"status":{"type":"string","enum":["pending"],"description":"Status of the check (always 'pending' on creation)"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the check was created"}}},"id":"schema_74"},"schema_75":{"kind":"json-schema","data":{"$ref":"#/components/schemas/criminal-check-completed-event-body"},"id":"schema_75"},"schema_76":{"kind":"json-schema","data":{"type":"string","format":"uuid"},"id":"schema_76"},"schema_77":{"kind":"json-schema","data":{"type":"string","example":"sha256=4f1e2d3c4b5a69788796a5b4c3d2e1f00112233445566778899aabbccddeeff0"},"id":"schema_77"},"schema_78":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/county-criminal-completed-event-body"},{"$ref":"#/components/schemas/county-criminal-not-available-event-body"}]},"id":"schema_78"},"schema_79":{"kind":"json-schema","data":{"type":"array","items":{"anyOf":[{"$ref":"#/components/schemas/driver_check_driver_license_status"},{"$ref":"#/components/schemas/driver_check_motor_vehicle_report"}]}},"id":"schema_79"},"schema_80":{"kind":"json-schema","data":{"type":"boolean","default":false},"id":"schema_80"},"schema_81":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/driver-check-request-from-pii"},{"$ref":"#/components/schemas/driver-check-request-from-profile"}]},"id":"schema_81"},"schema_82":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/driver-license-status-completed-event-body"},{"$ref":"#/components/schemas/motor-vehicle-report-completed-event-body"}]},"id":"schema_82"},"schema_83":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/identity_verification"}},"id":"schema_83"},"schema_84":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/identity-verification-request-from-pii"},{"$ref":"#/components/schemas/identity-verification-request-from-profile"},{"$ref":"#/components/schemas/identity-verification-request-from-phone"}]},"id":"schema_84"},"schema_85":{"kind":"json-schema","data":{"$ref":"#/components/schemas/document-verification-completed-event-body"},"id":"schema_85"},"schema_86":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/profile"}},"id":"schema_86"},"schema_87":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/profile_request_from_pii"},{"$ref":"#/components/schemas/profile_request_from_address"},{"$ref":"#/components/schemas/profile_request_from_profile"}]},"id":"schema_87"},"schema_88":{"kind":"json-schema","data":{"$ref":"#/components/schemas/pre-adverse-action-completed-event-body"},"id":"schema_88"},"schema_89":{"kind":"json-schema","data":{"$ref":"#/components/schemas/adverse-action-dispute-filed-event-body"},"id":"schema_89"},"schema_90":{"kind":"json-schema","data":{"$ref":"#/components/schemas/adverse-action-dispute-resolved-event-body"},"id":"schema_90"},"schema_91":{"kind":"json-schema","data":{"$ref":"#/components/schemas/uuid"},"id":"schema_91"},"schema_92":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile","results_found","review"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"results_found":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results_found"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (boolean) instead of the full "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"results"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array."},"children":[]}]}]}],"review":"Embeds the regulated check review object (accept/decline/dispute status)."}}},"id":"schema_92"},"schema_93":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/regulated_check"}},"id":"schema_93"},"schema_94":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile","rulesets_applied","review"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"rulesets_applied":"Embeds the rulesets applied when filtering this check's results.","review":"Embeds the regulated check review object (accept/decline/dispute status)."}}},"id":"schema_94"},"schema_95":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/regulated_check_request_from_pii"},{"$ref":"#/components/schemas/regulated_check_request_from_profile"}]},"id":"schema_95"},"schema_96":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["profile","review"],"x-enumDescriptions":{"profile":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embeds the full profile object in place of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"profile_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"review":"Embeds the regulated check review object (accept/decline/dispute status)."}}},"id":"schema_96"},"schema_97":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/county-check-completed-event-body"},{"$ref":"#/components/schemas/county-check-not-available-event-body"}]},"id":"schema_97"},"schema_98":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/regulated_criminal_report"}},"id":"schema_98"},"schema_99":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/criminal_report_request_from_pii"},{"$ref":"#/components/schemas/criminal_report_request_from_profile"}]},"id":"schema_99"},"schema_100":{"kind":"json-schema","data":{"type":"array","items":{"$ref":"#/components/schemas/eviction_check"}},"id":"schema_100"},"schema_101":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/eviction-check-request-from-pii"},{"$ref":"#/components/schemas/eviction-check-request-from-profile"}]},"id":"schema_101"}},"exampleStore":{"paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results":{"value":{"id":"2b8313e8-4efd-45a1-b578-952b8313e890","profile_id":"014f2478-fc46-46d3-9f1a-b9641e1aa080","created_at":"2024-03-15T10:22:04Z","completed_at":"2024-03-15T10:22:05Z","results":[{"first_name":"Patricia","last_name":"Holloway","middle_name":"Ann","address":"482 Birch Lane","city":"Springfield","state":"IL","zip_code":"62704","zone":"Springfield Metro","subject":{"full_name":"Patricia Ann Holloway","dob":"1985-03-14","address":"482 Birch Lane, Springfield, IL 62704","aliases":"P. Holloway","state":"IL","jurisdiction":"Sangamon County","source":"IL_SANG_EVICT","case_number":"2023-EV-004471","category":"Eviction","status":"Active","comments":null},"case":{"court":"Sangamon County Circuit Court","case_number":"2023-EV-004471","filing_date":"2023-06-12","notice_type":"Forcible Entry and Detainer","agency_state":"IL","agency_county":"Sangamon","dismissal_date":null,"default_judgement":true,"restored_premises":false,"plaintiff":{"name":"Riverstone Property Management LLC","phone":"217-555-0182","attorney":"Gregory L. Marsh","attorney_phone":"217-555-0199"},"judgement":{"date":"2023-07-05","amount_cents":347500,"type":"Judgment for Plaintiff","for":"Plaintiff","satisfaction_amount_cents":null,"release_date":null}}}],"run_notes":["changed last_name from 'Holloway Jr' to 'Holloway'"]},"key":"with_results","summary":"Response with eviction records found","id":"paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/with_results"},"paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results":{"value":{"id":"7c1a2d3b-9fae-41bc-8d2e-6f4c5e7b8a90","profile_id":"5e8f3c12-1b47-4d9a-a6e5-2c8d4f6e1b34","created_at":"2024-03-15T10:25:00Z","completed_at":"2024-03-15T10:25:01Z","results":[],"run_notes":[]},"key":"no_results","summary":"Response with no eviction records found","id":"paths/~1regulated~1eviction_checks/post/responses/201/content/application~1json/examples/no_results"}},"securitySchemeStore":{"get-bearer-token-using-oauth2":{"id":"get-bearer-token-using-oauth2","type":"oauth2","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Machine-to-machine (M2M) OAuth 2.0 "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"client credentials"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" flow."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchange your "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"client_secret"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" at"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"#operation/post-accounts-token"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"POST /accounts/token"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/#authentication"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Authentication"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Call protected endpoints with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Authorization: Bearer <access_token>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Access tokens are JWTs. Lifetime is returned as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expires_in"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (typically 24 hours)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Request a new token when the current one expires — there is no refresh-token"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"grant on this public token endpoint."},"children":[]}]}]}],"flows":{"clientCredentials":{"tokenUrl":"https://api.checkrtrust.com/v1/accounts/token","scopes":{"read:account":"Read a single account","create:account":"Create an account","delete:account":"Delete an account","read:users":"List users","create:user":"Create / invite a user","read:user":"Read a single user","update:user":"Update a user","delete:user":"Delete a user","read:role":"Read Auth0 role metadata for a user","update:role":"Assign Auth0 roles to a user","delete:role":"Remove Auth0 roles from a user"}}}}},"servers":[{"url":"https://api.checkrtrust.com/v1","description":"Checkr Trust API"}]},"options":{"schemasExpansionLevel":2,"showExtensions":true,"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/v1.json?download"},{"url":"/_bundle/v1.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Checkr Trust API","summary":"Checkr Trust is a modern, RESTful API-driven service designed to enhance trust and safety for your platform. The Checkr Trust API uses resource-oriented URLs, supports HTTPS for authentication and requests, and returns JSON responses.\n\nThe Checkr Trust API provides access to a rich set of data, including criminal records, traffic infractions, and registry checks. Once credentialed, you can start testing locally in minutes.\n\n## Intended Use Cases\n\nImportant: Checkr Trust is not a “consumer reporting agency” or otherwise a producer of “consumer reports,” as those terms are defined in the Fair Credit Reporting Act (“FCRA”). Checkr Trust data must not be accessed, obtained, disclosed, or otherwise used to make any decisions related to credit, insurance, employment, or any other purposes described in 15 U.S.C. § 1681b of FCRA\n"}},"baseSlug":"/v1","routesMapping":{}}