> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/identity-operation-center/conversion-ops/status-check-api.md).

# Status Check API

The Status Check API is a feature provided by VIDA that enables partners to retrieve the current status of a specific identity verification request. Partners can use either the unique transactionId or the partnerTrxId, which is generated when the Fraud Assessment API is initially called, to check the progress or outcome of the assessment process. This allows for efficient tracking and monitoring of individual transactions in real-time.

### Get Status by `transactionId`

<mark style="color:blue;">`GET`</mark> `/v2/services/fraud/{transactionId}/status`&#x20;

#### Path Parameters

| Name            | Type   | Description                                             |
| --------------- | ------ | ------------------------------------------------------- |
| `transactionId` | String | Transaction ID that is produced on transaction request. |

#### Headers

| Name                                            | Type             | Description                                                           |
| ----------------------------------------------- | ---------------- | --------------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String           | OAuth access token. Get the token by calling the Get Access Token API |
| Content-Type                                    | application/json | Format type of request body                                           |

#### Success Response

<details>

<summary>JSON Response</summary>

```json
{
  "data": {
    "partnerTrxId": "3282d003-c62c-4b7b-87e4_12112",
    "transactionType": "FULL_FRAUD_ASSESSMENT",
    "transactionId": "3282d003-c62c-4b7b-87e4-9d0a1bbf0c18",
    "status": "<code>"
  }
}
```

</details>

### Get Status by `partnerTrxId`

<mark style="color:blue;">`GET`</mark> `/v2/services/fraud/partner/{partnerTrxId}/status`&#x20;

#### Path Parameters

| Name           | Type   | Description                                                                                                 |
| -------------- | ------ | ----------------------------------------------------------------------------------------------------------- |
| `partnerTrxId` | String | Reference ID supplied by the customer, used for identifying the transaction and **it can't be duplicated.** |

#### Headers

| Name                                            | Type             | Description                                                           |
| ----------------------------------------------- | ---------------- | --------------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String           | OAuth access token. Get the token by calling the Get Access Token API |
| Content-Type                                    | application/json | Format type of request body                                           |

#### Response Format

<details>

<summary>JSON Response</summary>

```json
{
  "data": {
    "partnerTrxId": "3282d003-c62c-4b7b-87e4_12112",
    "transactionType": "FULL_FRAUD_ASSESSMENT",
    "transactionId": "3282d003-c62c-4b7b-87e4-9d0a1bbf0c18",
    "status": "<code>"
  }
}
```

</details>

### Status Table

The `status` field provides detailed information about the current state of the fraud transaction. It may contain the following values:

<table><thead><tr><th width="157">Status</th><th>Description</th></tr></thead><tbody><tr><td>001</td><td>The fraud assessment is in progress</td></tr><tr><td>002</td><td>The fraud assessment transaction is submitted for manual review</td></tr><tr><td>003</td><td>The fraud assessment result is accepted and the certificate issued after manual review</td></tr><tr><td>004</td><td>The fraud assessment result is rejected and the certificate have been not issued after manual review</td></tr><tr><td>006</td><td>The certificate not issued</td></tr><tr><td>007</td><td>Certificate is issued</td></tr></tbody></table>