# Metadata

The Unstoppable Domains Metadata APIs provide standard NFT metadata routes for our various onchain assets. This includes ERC721, ERC1155 and ERC7572 metadata endpoints for various collections and tokens.

**Note:** While this API is public, endpoints are rate limited. While the default rate limit should be sufficient for client applications, if you would like a higher limit rate for a backend system, please send a request to [UD Partner Engineering](mailto:partnerengineering@unstoppabledomains.com) to acquire an API key.


Version: 1.0.0

## Servers

Production
```
https://api.unstoppabledomains.com/metadata
```

Sandbox
```
https://api.ud-sandbox.com/metadata
```

## Download OpenAPI description

[Metadata](https://docs.unstoppabledomains.com/_bundle/apis/metadata/openapi.yaml)

## Domains

Metadata for our Web3 and tokenized Web2 Domains, available at [unstoppabledomains.com](https://unstoppabledomains.com).

Metadata is returned for all UD domains, regardless of the underlying blockchain or smart contract it is associated with. All endpoints accept either the domain name (`example.x`) or the the numeric token ID as the path parameter.


### Get Domain metadata

 - [GET /{domainOrToken}](https://docs.unstoppabledomains.com/apis/metadata/openapi/domains/domains_getmetadata.md)

### Get Domain image

 - [GET /image/{domainOrToken}](https://docs.unstoppabledomains.com/apis/metadata/openapi/domains/domains_getimage.md): Get the domain image SVG data

### Get Domain image source

 - [GET /image-src/{domainOrToken}](https://docs.unstoppabledomains.com/apis/metadata/openapi/domains/domains_getimagesrc.md): URL to use as the src when rendering the domain image on a UI.

## Onchain Badges

Metadata for our NFT Badge and NFT Badge collection service. Both the collections and badges are dynamically created, so the collection address must be included as a path parameter for all requests.


### Get Badge Collection metadata

 - [GET /badges/c/{contractAddress}](https://docs.unstoppabledomains.com/apis/metadata/openapi/badges/getcontractmetadata.md)

### Get Badge metadata

 - [GET /badges/c/{contractAddress}/b/{tokenId}](https://docs.unstoppabledomains.com/apis/metadata/openapi/badges/getbadgemetadata.md)