---
title: "Add Choice Screening Result"
method: POST
path: "/v2/choice-screening/result"
tags: ["Choice Screening"]
---

# Add Choice Screening Result

`POST /v2/choice-screening/result`

## Request

- Base URL: `https://api.avionte.com/talent`
- URL: `https://api.avionte.com/talent/v2/choice-screening/result`
- Auth: API key in header `x-api-key`

Adds the result of the Choice Screening.

## Headers

- `RequestId` string
- `Tenant` string, required
- `Authorization` string, required

## Request body

- object
  - `order` object: Choice order details.
    - `id` integer: The identifier for the order.
    - `trackingId` string: Tracking number of the order.
    - `isError` boolean: An indicator of whether an error occurred.
    - `isComplete` boolean: An identifier of whether the order is completed or not.
    - `status` string: The status of the order.
    - `statusDateTime` string, date-time: The date and time the status has been updated.
    - `error` object: Error details.
      - `code` string: The error code.
      - `message` string: The error message.
    - `applicant` object: Talent details.
      - `firstName` string: The talent's first name.
      - `lastName` string: The talent's last name.
      - `address` string: The talent's address.
      - `city` string: The talent's city.
      - `state` string: The talent's state.
      - `zipCode` string: The talent's ZIP code.
      - `reference` string: References associated with the talent.
      - `consentStatus` string: The status showing whether the talent has provided the consent before the screening.
    - `items` object: Details about the order result items.
      - `item` object[]: A list of order results items.
        - `Id` integer: The identifier for the order results item.
        - `line` integer: The identifier for the line of the screening order item.
        - `product` string: The product name of the screening order item.
        - `statusId` integer: The identifier for the status.
        - `statusText` string: The text of the status.
        - `contents` object: Response item details.
          - `isVerified` boolean: An indicator of whether the choice item response is verified or not.
          - `ssnIsValid` string: An indicator of whether the SSN is valid or not.
          - `ssnState` string: The state the SSN was issued in.
          - `ssnYears` string: The year the SSN was issued.
          - `requestinformation` object: Choice request details.
            - `code` string: Choice request code.
            - `codemessage` string: The code message.
            - `inputs` object: Choice inputs.
              - …
          - `addressinformation` object: Choice address information.
            - `message` string: A message related to the address.
            - `year` string: The year associated with the address.
            - `records` object: Choice records details.
              - …
            - `summaryinformation` object: Choice summary information.
              - …
          - `criminalinformation` object: Choice criminal information.
            - `records` object: Choice records details.
              - …
  - `AvionteReportUrl` string: URL to the background check report in Avionté.

## Response `201`

ChoiceOrderResponse

- object
  - `order` object: Choice order details.
    - `id` integer: The identifier for the order.
    - `trackingId` string: Tracking number of the order.
    - `isError` boolean: An indicator of whether an error occurred.
    - `isComplete` boolean: An identifier of whether the order is completed or not.
    - `status` string: The status of the order.
    - `statusDateTime` string, date-time: The date and time the status has been updated.
    - `error` object: Error details.
      - `code` string: The error code.
      - `message` string: The error message.
    - `applicant` object: Talent details.
      - `firstName` string: The talent's first name.
      - `lastName` string: The talent's last name.
      - `address` string: The talent's address.
      - `city` string: The talent's city.
      - `state` string: The talent's state.
      - `zipCode` string: The talent's ZIP code.
      - `reference` string: References associated with the talent.
      - `consentStatus` string: The status showing whether the talent has provided the consent before the screening.
    - `items` object: Details about the order result items.
      - `item` object[]: A list of order results items.
        - `Id` integer: The identifier for the order results item.
        - `line` integer: The identifier for the line of the screening order item.
        - `product` string: The product name of the screening order item.
        - `statusId` integer: The identifier for the status.
        - `statusText` string: The text of the status.
        - `contents` object: Response item details.
          - `isVerified` boolean: An indicator of whether the choice item response is verified or not.
          - `ssnIsValid` string: An indicator of whether the SSN is valid or not.
          - `ssnState` string: The state the SSN was issued in.
          - `ssnYears` string: The year the SSN was issued.
          - `requestinformation` object: Choice request details.
            - `code` string: Choice request code.
            - `codemessage` string: The code message.
            - `inputs` object: Choice inputs.
              - …
          - `addressinformation` object: Choice address information.
            - `message` string: A message related to the address.
            - `year` string: The year associated with the address.
            - `records` object: Choice records details.
              - …
            - `summaryinformation` object: Choice summary information.
              - …
          - `criminalinformation` object: Choice criminal information.
            - `records` object: Choice records details.
              - …
  - `AvionteReportUrl` string: URL to the background check report in Avionté.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Access Denied
- `406`: Unsupported format(s) indicated by Accept header
- `415`: Unsupported format(s) indicated by the Content-Type header
- `429`: Too many requests
- `500`: An unexpected error occurred
- `502`: The request could not be completed because an error occurred in an upstream service

---

[API](https://skmtc.dev/avionte/apis/aviont-talent-api.md) - [All operations](https://skmtc.dev/avionte/apis/aviont-talent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/avionte/apis/aviont-talent-api/revisions/41cf396009af?raw)