Get Reputation NFT

Endpoint

GET /api/public/sbt

This endpoint allows retrieving information about a user's Soulbound Token (SBT) in Lens Reputation. If the user has minted their NFT, details of the NFT and their score will be returned. If they haven't minted the NFT, the response will indicate this status.

Query Parameters

Parameter	Type	Required	Description
wallet	string	Yes	Wallet address of the user in hexadecimal format (e.g., 0xabc123...).
lensAccountAddress	string	No	Optional Lens account address. If not provided, defaults to 0x000...000

---

Example Request

Request

GET https://lensreputation.xyz/api/public/sbt?wallet=0xabc123...

GET https://lensreputation.xyz/api/public/sbt?wallet=0xabc123...&lensAccountAddress=0xdef456...

Responses

200 - OK (User has minted the NFT)

If the user has minted the NFT, the response will have the following structure:

{
  "minted": true,
  "nft": {
    "tokenId": "123",
    "image": "https://example.com/nft-image.png"
  },
  "score": {
    "total": 85,
    "categories": {
      "protocol": 34,
      "network": 25,
      "financial": 20,
      "testnet": 6
    }
  },
  "timestamp": 1741898964
}

Field	Type	Description
minted	bool	Indicates that the user has minted the NFT.
nft.tokenId	string	ID of the minted NFT.
nft.image	string	URL of the image associated with the NFT.
score	object	The user's current score in Lens Reputation.
score.total	integer	The user's total score in Lens Reputation
score.categories	object	Score breakdown by categories with weights applied
score.categories.protocol	integer	Protocol score
score.categories.network	integer	Network score
score.categories.financial	integer	Financial score
score.categories.testnet	integer	Testnet score
timestamp	integer	Timestamp of the minting or last update

---

200 - OK (User has not minted the NFT yet)

If the user has not minted the NFT, the response will be:

{
  "minted": false,
  "message": "The user has not minted the NFT yet."
}

Field	Type	Description
minted	bool	Indicates that the user has not minted the NFT.
message	string	Informative message.

---

400 - Bad Request

If the wallet parameter is missing or has an invalid format:

{
  "error": "Invalid or missing 'address' parameter."
}

Field	Type	Description
error	string	Description of the error.

---

500 - Internal Server Error

If an unexpected server error occurs:

{
  "error": "Internal server error. Please try again later."
}

Field	Type	Description
error	string	Generic error message.