# Badge endpoints

## Retrieves holders of the badge

 - [GET /badges/{badge}/holders](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1%7Bbadge%7D~1holders/get.md): Retrieves a list of addresses that hold the badge

## Retrieves details about a badge

 - [GET /badges/{badge}](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1%7Bbadge%7D/get.md): Retrieves details about a badge, including definition and usage statistics.

## Validates that a given user holds a badge

 - [GET /badges/{badge}/validate/{address}](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1%7Bbadge%7D~1validate~1%7Baddress%7D/get.md): Validates that a given user holds a badge

## Generates a badge based on a provided marketplace link

 - [POST /badges/claim](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1claim/post.md): Creates a badge based on a provided marketplace link, such as OpenSea, Zuse.market, etc. The badge must be purchased to be activated before it can be claimed by other domains.

## Retrieve badge rankings by domain

 - [GET /badges/rankings/domains](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1rankings~1domains/get.md): Generates a list of domains ordered by largest badge collection

## Retrieve badge rankings

 - [GET /badges/rankings](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1rankings/get.md): Generates a list of badges ordered by number of holders

## Retrieve badge rankings by sponsor

 - [GET /badges/rankings/sponsors](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1badges~1rankings~1sponsors/get.md): Generates a list of sponsors ordered by largest number of sponsored badges

## Updates badges for a wallet address

 - [POST /user/{address}/badges](https://docs.unstoppabledomains.com/apis/profile-v1/openapi/badge-endpoints/paths/~1user~1%7Baddress%7D~1badges/post.md): Update specific badge visibility if provided in request body. If body has no elements, requests badge refresh for a wallet address. Authentication is required using domain owner signature.