> ## Documentation Index
> Fetch the complete documentation index at: https://docs.masterid.co.ug/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /verifications/{sessionId}

> GET /verifications/{sessionId}: retrieve the status and formatted result of a verification session.

Retrieve the status and result of a verification session. Only records in the issuing workspace are returned. Store the `sessionId` from submission; it is different from the API request ID.

```text theme={null}
GET https://masterid.me/api/public/v1/verifications/{sessionId}
```

## Authentication

**X-API-Key** `string` *required*

Your workspace API key.

**X-API-Secret** `string` *required*

Your workspace API secret.

**Content-Type** `string` *required*

Must be `application/json`.

## Path parameters

**sessionId** `string` *required*

The verification session ID returned by [POST /verifications](https://docs.masterid.co.ug/api-reference/verifications/create-verification.md). Contains 6-12 digits.

## Response fields

**id** `string` *required*

API request ID.

**data** `object`

**properties**

**sessionId** `string` *required*

The verification session ID.

**product** `string`

The product code used for the verification.

**status** `string`

One of: `pending`, `legitimate`, `fake`, `failed`.

**charged** `integer`

Amount charged in UGX. Only present on final results. Pending checks have no charge until a final result. Failed checks are not charged.

**details** `array`

Formatted integration results as an array of `{label, value}` objects. Not present when the result is pending or failed.

**shareholding** `object | null`

Additional structured data when available. Structure is not documented.

## Status codes

| Status | Meaning |
| - | - |
| 200 | OK. Status and result returned. |
| 401 | Missing, invalid or revoked credentials. |
| 403 | Suspended account. |
| 404 | Unknown operation or resource outside your workspace. |
| 429 | API request limit reached. Check `Retry-After`. |
| 500/503 | Temporary processing error or unavailability. |

> [!NOTE]
>
> Poll a pending session no more frequently than every 15 seconds.

```bash cURL theme={null}
curl -X GET "https://masterid.me/api/public/v1/verifications/<SESSION_ID>" \
  -H "X-API-Key: $MASTERID_API_KEY" \
  -H "X-API-Secret: $MASTERID_API_SECRET" \
  -H "Content-Type: application/json"
```

```javascript Node.js theme={null}
const response = await fetch(
  `https://masterid.me/api/public/v1/verifications/${process.env.SESSION_ID}`,
  {
    method: "GET",
    headers: {
      "X-API-Key": process.env.MASTERID_API_KEY,
      "X-API-Secret": process.env.MASTERID_API_SECRET,
      "Content-Type": "application/json",
    },
  }
);
const body = await response.json();
console.log(body.data.status);
```

```python Python theme={null}
import os, requests

r = requests.get(
    f"https://masterid.me/api/public/v1/verifications/{os.environ['SESSION_ID']}",
    headers={
        "X-API-Key": os.environ["MASTERID_API_KEY"],
        "X-API-Secret": os.environ["MASTERID_API_SECRET"],
        "Content-Type": "application/json",
    },
)
print(r.json()["data"]["status"])
```

```json 200 theme={null}
{
  "id": "<REQUEST_ID>",
  "data": {
    "sessionId": "<SESSION_ID>",
    "product": "tin",
    "status": "legitimate",
    "charged": 1500,
    "details": [
      { "label": "Result", "value": "Verified" }
    ],
    "shareholding": null
  }
}
```


## Related topics

- [POST /verifications](https://docs.masterid.co.ug/api-reference/verifications/create-verification.md)
- [Responses and status codes](https://docs.masterid.co.ug/concepts/responses.md)
- [Run a verification](https://docs.masterid.co.ug/guides/verifications.md)
- [MasterID Integration API](https://docs.masterid.co.ug/index.md)
- [Receive webhooks](https://docs.masterid.co.ug/guides/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.