---
title: "returns the token identifiers for a given {address} and the provided role."
method: GET
path: "/address/{address}/esdts-with-role/{role}"
tags: ["address"]
---

# returns the token identifiers for a given {address} and the provided role.

`GET /address/{address}/esdts-with-role/{role}`

## Path parameters

- `address` string, required
- `role` string, required

## Response `200`

successful operation

- AddressEsdtTokens
  - `data` AddressEsdtTokensData[]
    - `tokens` string[]
  - `error` string
  - `code` string

## Changes

- **2023-04-05** `02f72d3e7338` — 1 breaking, 3 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the optional property `code` to the response with the `200` status
  - added the optional property `data` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
- **2023-03-24** `878e0c35bb6b` — 1 breaking, 3 warning
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `code` from the response with the `200` status
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `error` from the response with the `200` status
- **2023-02-17** `d6ee9b93c7dc` — 1 breaking, 3 info
  - the response's body type changed from `array` to `object` for status `200`
  - added the optional property `code` to the response with the `200` status
  - added the optional property `data` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
- **2023-02-08** `82d543636074` — 1 breaking, 3 warning
  - the response's body type changed from `object` to `array` for status `200`
  - removed the optional property `code` from the response with the `200` status
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `error` from the response with the `200` status

[Change history](https://skmtc.dev/multiversx/apis/multiversx-gateway-api/changes/address/:address/esdts-with-role/:role/get.md)

---

[API](https://skmtc.dev/multiversx/apis/multiversx-gateway-api.md) · [All operations](https://skmtc.dev/multiversx/apis/multiversx-gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multiversx/multiversx-gateway-api/revisions/44c49bc12621/schema)