# Entity Secret Read

### Environment

<table><thead><tr><th width="218">Environment</th><th>IAM Base URL</th></tr></thead><tbody><tr><td>Saafe Hackathon</td><td><code>https://api.sandbox.sahamati.org.in/iam</code></td></tr><tr><td>Saafe Sandbox</td><td><code>https://api.uat.sahamati.org.in/iam</code></td></tr></tbody></table>

### API Request

<mark style="color:green;">`POST`</mark> `{{IAM Base URL}}/v1/entity/secret/read`

Lets the FIU fetch the entity id's secret key.

**Headers**

| Name          | Value                     |
| ------------- | ------------------------- |
| Content-Type  | `application/json`        |
| Authorization | `Bearer <IAM User Token>` |

**Body**

```json
{
    "ver": "1.0.0",
    "timestamp": "2024-10-10T10:48:45.030353256Z", //Current timestamp
    "txnId": "79ecd03d-867a-491d-8f5d-ec521a31c159", //unique UUID
    "entityId": "your entity id" //Entity ID under the user
}
```

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
    "ver": "1.0.0",
    "timestamp": "2024-10-10T10:48:45.030353256Z",
    "txnId": "79ecd03d-867a-491d-8f5d-ec521a31c159",
    "entityId": "your entity id",
    "secret": "string", //Your Entity ID's secret key
    "expiresOn": 1733226041466
}
```

{% endtab %}
{% endtabs %}