Skip to main content
Version: V1

Read a Profile

In this section, we'll help make a simple call to fetch a user's profile by using the profile endpoint:{id}

We will write a simple function to fetch the profile:

type DataEnsAvatar = {
record: string,
type: 'uri:https' | 'uri:data' | 'uri:ipfs' | 'nft:erc721' | 'nft:erc1155',
nftMetadata: string | null,
nftOwner: string | null,
nftBalance: string | null,
nftOwned: boolean | null,
url: string | null,

type Data = {
address: string,
name: string | null,
primaryName: string | null,
ensAvatar: DataEnsAvatar | null,

const fetchProfile = async (id: string): Promise<Data> => {
const res = await fetch(`${id}`, {
method: 'GET',
headers: { 'Content-Type': 'application/json' },
return await res.json()

In our example we call the fetchProfile function and pass “pisofa.eth” as the id param. If successful, you'll retrieve the user's address, name, and ensAvatar including its record, type, nftOwner, and url among other information:

"address": "0xeBeD0BF2701e905b4C576B3dC943D797bAc226ed",
"name": "pisofa.eth",
"primaryName": "pisofa.eth",
"ensAvatar": {
"record": "eip155:1/erc721:0x49cF6f5d44E70224e2E23fDcdd2C053F30aDA28B/11850",
"type": "nft:erc721",
"nftMetadata": "{\"name\":\"CloneX #18924\",\"description\":\"🧬 CLONE X 🧬\\n\\n20,000 next-gen Avatars, by RTFKT and Takashi Murakami 🌸\\n\\nIf you own a clone without any Murakami trait please read the terms regarding RTFKT - Owned Content here:\\n\\nYou are also entitled to a commercial license, please read the terms to that here:\",\"attributes\":[{\"trait_type\":\"DNA\",\"value\":\"Human\"},{\"trait_type\":\"Eye Color\",\"value\":\"BLU\"},{\"trait_type\":\"Hair\",\"value\":\"BLU Curtains\"},{\"trait_type\":\"Clothing\",\"value\":\"BLCK VARSITY JCKT\"},{\"trait_type\":\"Mouth\",\"value\":\"ROBO\"}],\"image\":\"\"}",
"nftOwner": "0xeBeD0BF2701e905b4C576B3dC943D797bAc226ed",
"nftBalance": null,
"nftOwned": true,
"url": ""

Make sure to check out the full list of fields available in Profile API.


Feel free to test it out in Next Swagger Doc Demo App or experiment with our code in the sandbox below!

Designed by