Create Screening Result

curl -X POST https://api.fortresstech.io/v1/screening-results \
     -H "Content-Type: application/json" \
     -d '{
  "idempotencyId": "idempotencyId",
  "screeningRequestId": "screeningRequestId",
  "providerIdentifier": "providerIdentifier",
  "status": "APPROVED",
  "screeningMethods": [
    {
      "screeningMethodId": "screeningMethodId",
      "status": "APPROVED"
    }
  ]
}'

{
  "idempotencyId": "idempotencyId",
  "providerIdentifier": "providerIdentifier",
  "screeningMethods": [
    {
      "screeningMethodId": "screeningMethodId",
      "status": "APPROVED",
      "notes": "notes"
    }
  ],
  "screeningRequestId": "screeningRequestId",
  "status": "APPROVED",
  "adverseFactors": [
    "adverseFactors"
  ],
  "applicationRecommendation": "applicationRecommendation",
  "createdAt": "2024-01-15T09:30:00Z",
  "deletedAt": "2024-01-15T09:30:00Z",
  "fortressStatus": "Accept",
  "id": "id",
  "notes": "notes",
  "providerStatus": "providerStatus",
  "report": "report",
  "transactionId": "transactionId",
  "updatedAt": "2024-01-15T09:30:00Z"
}

Onboarding Required

Create a screening result

Screening endpoints require an additional onboarding process. Please contact our team to begin the onboarding process for screening integration.

<Badge>Onboarding Required</Badge> Create a screening result <Info> Screening endpoints require an additional onboarding process. Please contact our team to begin the onboarding process for screening integration. </Info>

Request

This endpoint expects an object.

Response

Expected response to a valid request

idempotencyIdstringformat: "uuid"

providerIdentifierstring

Unique identifier for the screening result

screeningMethodslist of objects

Array of screening method details. Must include one entry for each screening method configured for the property. The number of methods provided must match the number of methods associated with the screening request.

screeningRequestIdstringformat: "uuid"

statusenum

The status of the screening result

adverseFactorslist of stringsOptional

Array of adverse factors for the screening result

applicationRecommendationstringOptional

Similar to the providerStatus field but more details provided for the overall application.

createdAtdatetimeOptional

deletedAtdatetimeOptional

fortressStatusenumOptional

The status of the screening result as determined by and used inside of Fortress

idstringOptionalformat: "uuid"

notesstringOptional

General notes about the screening result

providerStatusstringOptional

A code that maps to a specific description from the screening provider

reportstringOptional

Link to a report for the screening result, if available

transactionIdstringOptional

Transaction ID associated with the screening result

updatedAtdatetimeOptional