> For the complete documentation index, see [llms.txt](https://docs.ltonetwork.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ltonetwork.com/node/identity-node/rest-api.md).

# REST API

{% hint style="info" %}
In the following examples, replace`https://lto.example.com` with the domain or IP address of **your** node. 
{% endhint %}

### Authorization

A node can be configured with an authorization token. This can be done in case the api of the node is exposed publicly. Once the token is configured the anchoring of hash on the chain requires an authorization header

```
Authorization: bearer <token>
```

## Decentralized identifiers (DID)

## Resolve DID

<mark style="color:blue;">`GET`</mark> `https://lto.example.com/identities/:address`

Resolve a DID into a DID document

#### Path Parameters

| Name    | Type   | Description        |
| ------- | ------ | ------------------ |
| address | string | DID or LTO address |

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

```
```

{% endtab %}
{% endtabs %}

## Resolve derived DID

<mark style="color:blue;">`GET`</mark> `https://lto.example.com/identities/:address/derived/:secret`

#### Path Parameters

| Name    | Type   | Description                  |
| ------- | ------ | ---------------------------- |
| address | string | DID or LTO address           |
| secret  | string | Base58 encoded random secret |

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

```
```

{% endtab %}
{% endtabs %}

## Trust network

## Get all the roles of an identity

<mark style="color:blue;">`GET`</mark> `https://lto.example.com/trust/:address`

Resolves the roles from an identity

#### Query Parameters

| Name    | Type   | Description                        |
| ------- | ------ | ---------------------------------- |
| address | string | Account's address in Base58 format |

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

```
{
  "roles": [
    "authority",
    "notary"
  ],
  "issues_roles": [
    { "type": 100, "role": "notary" }
  ],
  "issues_authorization": [
    "https://www.w3.org/2018/credentials/examples/v1"
  ]
}
```

{% endtab %}

{% tab title="400 " %}

```
{
  "error": "invalid address"
}
```

{% endtab %}
{% endtabs %}