# Holders by Rune

This endpoint is commonly used to pass a rune ID, and get the full list of wallets holding the rune, and the amount they hold.

## GET /v1/runes/{identifier}/holders

> Get holders for a specific Rune by identifier.

```json
{"openapi":"3.0.3","info":{"title":"SecretKeyLabs API","version":"1.0.0"},"tags":[{"name":"Ordinals"}],"servers":[{"url":"https://api.secretkeylabs.io"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header"}}},"paths":{"/v1/runes/{identifier}/holders":{"get":{"tags":["Ordinals","Runes"],"description":"Get holders for a specific Rune by identifier.","parameters":[{"schema":{"minimum":0,"type":"number"},"in":"query","name":"offset","required":false},{"schema":{"minimum":1,"maximum":25,"type":"number"},"in":"query","name":"limit","required":false},{"schema":{"default":0,"minimum":0,"type":"number"},"in":"query","name":"lastModifiedBlockGte","required":false},{"schema":{"type":"string"},"in":"path","name":"identifier","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"offset":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"items":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string"},"amount":{"type":"string"},"lastUpdatedBlockHeight":{"type":"number"}},"required":["address","amount","lastUpdatedBlockHeight"]}}},"required":["offset","limit","total","items"]}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"description":"Invalid input","type":"string"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"description":"Unauthorized","type":"string"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"description":"Not found","type":"string"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"description":"Rate limit exceeded","type":"string"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"description":"Internal server error","type":"string"}}}}}}}}}
```
