v1

latestOpenAPI 3.0.32026-07-14265579.8 KB

Adjudication

Adjudicate an Order

Accurate’s API allows you adjudicate orders without having to log into the Client Portal. Additionally, as position location information is an important aspect of adjudication, you can also update position location information through this API.

post/order/{orderId}/adjudication

Path parameters

orderIdstring required

Order ID to adjudicate. Orders that did not originate from API v3 will not have an order ID. Instead use the package ID. This starts with a "Y" and is followed by 7 digits.

Request body

resultstring required

The adjudication result you want to set for the order.

adjudicatorstring email required

Email address of adjudicator.

completedIndividualizedAssesmentboolean

Attests that an the client has performed an individualized assessment on the candidate before PA/AA letters are sent out. This field is required when the adjudication result is 'FAIL' (or equivalent) and the position location is in California.

clientNotesstring

Accompanying notes for the adjudication decision. This is not passed to the candidate/employee and will not show on the consumer report.

reasonTypestring

Accepts "criminal" or "not criminal" only. Required when Accurate is providing Adverse Action notices on your company’s behalf, the adjudication result is fail, and the position location country is US.

reasonstring

Required when Accurate is providing Adverse Action notices on your company’s behalf, the adjudication result is fail, the position location country is US, the reasonType is criminal, and the job location is considered a special jurisdiction which requires a reason to be specified in Adverse Action notices.

assessmentForm.Company_Namestring

County of Los Angeles Unincorporated Cities*: Employer name. City of Los Angeles*: Employer name. New York*: Contact information for candidate to provide additional information if desired.

assessmentForm.Candidate_FullNamestring

County of Los Angeles Unincorporated Cities*: Applicant full name. City of Los Angeles*: Applicant full name. New York*: Applicant full name.

assessmentForm.Job_Positionstring

County of Los Angeles Unincorporated Cities*: Position applied for. City of Los Angeles*: Position applied for. New York*: Position applied for.

assessmentForm.Date_ConditionalOfferstring date

County of Los Angeles Unincorporated Cities*: Date of conditional job offer in YYYY-MM-DD format. City of Los Angeles*: Date of conditional job offer in YYYY-MM-DD format.

assessmentForm.Date_CriminalHistorystring date

County of Los Angeles Unincorporated Cities*: Date of the Criminal History Report in YYYY-MM-DD format City of Los Angeles*: Date of the Criminal History Report in YYYY-MM-DD format

assessmentForm.Rep_Assessmentstring

County of Los Angeles Unincorporated Cities*: Name of person performing assessment City of Los Angeles*: Name of person performing assessment

assessmentForm.Date_Assessmentstring date

County of Los Angeles Unincorporated Cities*: Date of assessment in YYYY-MM-DD format City of Los Angeles*: Date of assessment in YYYY-MM-DD format

assessmentForm.Job_Duty1string

City of Los Angeles*: Specific job duty/responsibility. New York*: Specific job duty/responsibility.

assessmentForm.Job_Duty2string

City of Los Angeles: Specific job duty/responsibility. New York: Specific job duty/responsibility.

assessmentForm.Job_Duty3string

City of Los Angeles: Specific job duty/responsibility. New York: Specific job duty/responsibility.

assessmentForm.Job_Duty4string

City of Los Angeles: Specific job duty/responsibility. New York: Specific job duty/responsibility.

assessmentForm.Job_DutyRiskstring

City of Los Angeles*: Link between applicant’s criminal history and the risks inherent with duties of employment position. New York: At least one field must be provided. Link between applicant’s criminal history and the risks inherent with duties of employment position.

assessmentForm.SpecialJurisdiction_Reasonsstring

City of Los Angeles*: Description of criminal conduct and why it is of concern. New York: At least one field must be provided. Description of criminal conduct and why it is of concern.

assessmentForm.Duration_CriminalActivitystring

City of Los Angeles*: How long ago the criminal activity in question occurred.

assessmentForm.Age_CriminalActivitystring

City of Los Angeles*: Age of candidate at the time of criminal activity . New York: At least one field must be provided. Age of candidate at the time of criminal activity.

assessmentForm.Criminal_Activity1string

City of Los Angeles*: Activities since criminal activity such as work experience, job training, etc.

assessmentForm.Criminal_Activity2string

City of Los Angeles: Activities since criminal activity such as work experience, job training, etc.

assessmentForm.Criminal_Activity3string

City of Los Angeles: Activities since criminal activity such as work experience, job training, etc.

assessmentForm.Criminal_Activity4string

City of Los Angeles: Activities since criminal activity such as work experience, job training, etc.

assessmentForm.Year_CriminalActivitystring

New York: At least one field must be provided. Must be passed with month. How long ago the criminal activity occurred in years and months (passed in separate fields).

assessmentForm.Month_CriminalActivitystring

New York: At least one field must be provided. Must be passed with years. How long ago the criminal activity occurred in years and months (passed in separate fields).

assessmentForm.Good_Conduct1string

New York: Evidence of good conduct or rehabilitation.

assessmentForm.Good_Conduct2string

New York: Evidence of good conduct or rehabilitation.

assessmentForm.Good_Conduct3string

New York: Evidence of good conduct or rehabilitation.

assessmentForm.Protection_Reasonsstring

New York: At least one field must be provided. Interest in protecting property or safety/welfare of individuals/public.

assessmentForm.Rescinding_Reasonsstring

New York*: Must provide at least one of these fields. Reason for rescinding job offer as it relates to criminal activity and job function.

assessmentForm.Criminal_Riskstring

New York*: Must provide at least one of these fields. Reason for rescinding job offer as it relates to risk of property, persons, public.

assessmentForm.AssessmentNatureOffensestring

County of Los Angeles Unincorporated Cities*: The nature and gravity of the offense or conduct, as a factor in consideration of the decison.

assessmentForm.AssessmentNatureJobPositionstring

County of Los Angeles Unincorporated Cities*: The nature of the Employment position sought or held, including consideration of the specific duties of the job, as a factor in consideration of the decison.

assessmentForm.AssessmentMitigatingEvidencestring

County of Los Angeles Unincorporated Cities: Evidence of Rehabilitation or Mitigating Circumstances voluntarily provided by the Applicant or Employee to the Employer before or during the Initial Individualized Assessment.

assessmentForm.AssessmentReasonUndueBurdenstring

County of Los Angeles Unincorporated Cities;: Reasons why it is an undue burden for the Employer to continue to wait for receipt of the Criminal Background Check Report if the cause of rescinding the offer is related to a delay in the receipt of the Criminal Background Check Report.

Example request

{
  "result": "fail",
  "adjudicator": "adjudicator_email@sample.com",
  "completedIndividualizedAssesment": true,
  "clientNotes": "Failing because criminal charge is related to job function",
  "reasonType": "criminal",
  "reason": "Theft charge in July 2019 is directly related to the role applied for as cashier."
}

Response

Success Response

resourcestring

idstring

createdstring date-time

updatedstring date-time

maskedboolean

packageType'PKG_BASIC' | 'PKG_STANDARD' | 'PKG_PRO' | 'PKG_EMPTY'

workflow'EXPRESS' | 'INTERACTIVE'

copyOfReportboolean

clientCommentsstring

referenceCodesstring[]

candidateIdstring

candidateInfoCompleteboolean

statusstring

resultstring

percentageCompleteinteger

candidateInfoChangedboolean

sourcestring

searchIdinteger

subjectIdinteger

submittedstring date-time

supportReferenceIdstring

adjudicatorstring

adjudicatorNotesstring

clientNotesstring

reasonTypestring

reasonstring

assesmentFormobject

Example response

{
  "clientComments": "Client comments",
  "complianceTokens": {
    "companyName": "Accurate",
    "companyAddress": "200 Spectrum Ctr",
    "companyCity": "Irvine",
    "companyRegion": "CA",
    "companyCountry": "US",
    "companyEmail": "elmer@wb.com"
  },
  "jobLocation": {
    "country": "US",
    "region": "CA",
    "region2": "Orange",
    "city": "Irvine"
  },
  "candidateId": "56eb1389a78e5bf65e414cfc",
  "candidate": {
    "firstName": "Elmer",
    "lastName": "Fudd",
    "middleName": "Fiddlesticks",
    "suffix": "Jr",
    "dateOfBirth": "1945-01-01T00:00:00.000Z",
    "email": "Elmer@wb.com",
    "address": "123 Silly Street",
    "city": "Lousville",
    "region": "KY",
    "country": "US",
    "governmentId": {
      "country": "US",
      "type": "SpyCard",
      "number": "ABC12345"
    }
  },
  "status": "RECEIVED",
  "result": "PASS",
  "reports": [
    {
      "base64encodedHTML": "/report/572d0904f1b9a4602bc83a09"
    }
  ],
  "additionalProductTypes": [
    {
      "productType": "TERB"
    }
  ],
  "products": [
    {
      "id": 53756466,
      "productType": "NCRIM",
      "status": "PENDING",
      "result": "PENDING"
    }
  ],
  "documents": [
    {
      "documentId": "602ad78042dcb1000c24c7a7",
      "documentUrl": "/order/602ad1744b9ccf1bbb4fa292/document/602ad78042dcb1000c24c7a7",
      "documentName": "Addtl doc.jpg",
      "externalDocumentId": "602ad780a424f6000bf08b59"
    }
  ],
  "percentageComplete": 50,
  "source": "INTEGRATION::API-V3",
  "searchId": 197111504,
  "subjectId": 25600748,
  "adjudicator": "test@email.com"
}