# Get Validation Status

Retrieve validation status for given records.

Endpoint: POST /organisations/{orgId}/validation/status
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `orgId` (string, required)
    The organisation identity

## Header parameters:

  - `contentType` (string, required)

## Request fields (application/json):

  - `records` (array, required)
    List of record URIs that you want to confirm are valid based on provided Criteria.

  - `includeRulesets` (boolean, required)
    List of criteria to apply for validation.

  - `includedRiskAssessments` (array)
    If Risk Assessments are included in Criteria, this allows definition of which types of Risk Assessment are included in the check. If not included then risk assessments will be ignored.
    Enum: "COUNTRY", "DELIVERY", "LOCATION", "MATERIAL", "ORGANISTION", "PRODUCT"

  - `treatMissingAsError` (boolean)
    If this is set to true then if a risk assessment is missing (or has expired - effectively missing) then it will cause validation to fail.

## Response 201 fields (application/json):

  - `records` (array, required)
    List of records that have been evaluated.

  - `records.recordUri` (string, required)
    URI of the record whose status you want to confirm

  - `records.validated` (boolean, required)
    The validation status. If true it means that the record passes the provided Criteria.

  - `records.failingRulesets` (array)
    If rulesets applicable to the record have not validated, this returns the name of the rulesets that have failed.

  - `records.failingRiskAssessments` (array)
    If Risk Assessments were included in the request then this contains the list of risk assessment types that have not passed the validation.

  - `records.failingRiskAssessments.recordUri` (string, required)
    The URI of the record that does not have a valid Risk Assessment

  - `records.failingRiskAssessments.recordName` (string, required)
    Contains a user friendly identifier to help recognise the record that has the invalid risk assessment. (Location - Name, Organisation - Name, Country - Name, Material - Name, Deliveries - Delivery ID)

  - `records.failingRiskAssessments.reason` (string, required)
    Gives the reason for the failure.
    Enum: "EXPIRED", "MISSING", "UNACCEPTABLE_RISK"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields