> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockscout.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List current holders of a specific NFT

> Retrieves current holders of a specific NFT instance. For ERC-721, this will typically be a single address. For ERC-1155, multiple addresses may hold the same token ID.



## OpenAPI

````yaml /openapi-specs/pro-api-v11.yaml get /v2/tokens/{address_hash_param}/instances/{token_id_param}/holders
openapi: 3.0.0
info:
  contact:
    email: info@blockscout.com
  title: Blockscout
  version: 11.0.3
servers:
  - url: http://localhost/api
    variables: {}
security: []
tags:
  - name: blocks
  - name: transactions
  - name: addresses
  - name: internal-transactions
  - name: tokens
  - name: token-transfers
  - name: smart-contracts
  - name: config
  - name: main-page
  - name: search
  - name: stats
  - name: csv-export
  - name: account-abstraction
  - name: withdrawals
  - name: advanced-filters
  - name: arbitrum
  - name: legacy
  - name: optimism
  - name: mud
  - name: celo
  - name: scroll
  - name: zilliqa
paths:
  /v2/tokens/{address_hash_param}/instances/{token_id_param}/holders:
    get:
      tags:
        - tokens
      summary: List current holders of a specific NFT
      description: >-
        Retrieves current holders of a specific NFT instance. For ERC-721, this
        will typically be a single address. For ERC-1155, multiple addresses may
        hold the same token ID.
      operationId: BlockScoutWeb.API.V2.TokenController.holders_by_instance
      parameters:
        - description: API key for rate limiting or for sensitive endpoints
          in: query
          name: apikey
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Secret key for getting access to restricted resources
          in: query
          name: key
          required: false
          schema:
            type: string
            x-struct: null
            x-validate: null
        - description: Address hash in the path
          in: path
          name: address_hash_param
          required: true
          schema:
            $ref: '#/components/schemas/AddressHash'
        - description: Token ID for ERC-721/1155/404 tokens
          in: path
          name: token_id_param
          required: true
          schema:
            $ref: '#/components/schemas/IntegerStringNullable'
        - description: Address hash for paging
          in: query
          name: address_hash
          required: false
          schema:
            $ref: '#/components/schemas/AddressHash'
        - description: Number of items returned per page
          in: query
          name: items_count
          required: false
          schema:
            maximum: 50
            minimum: 1
            type: integer
            x-struct: null
            x-validate: null
        - description: Token ID for paging
          in: query
          name: token_id
          required: false
          schema:
            $ref: '#/components/schemas/IntegerStringNullable'
        - description: Transaction value for paging
          in: query
          name: value
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/IntegerString'
              - $ref: '#/components/schemas/EmptyString'
              - $ref: '#/components/schemas/NullString'
            x-struct: null
            x-validate: null
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                nullable: false
                properties:
                  items:
                    items:
                      $ref: '#/components/schemas/TokenHolderResponse'
                    nullable: false
                    type: array
                    x-struct: null
                    x-validate: null
                  next_page_params:
                    example:
                      address_hash: '0x1d2c163fbda9486c3a384b6fa5e34c96fe948e9a'
                      items_count: 50
                      token_id: '0'
                      value: '4217417051704137590935'
                    nullable: true
                    type: object
                    x-struct: null
                    x-validate: null
                required:
                  - items
                  - next_page_params
                type: object
                x-struct: null
                x-validate: null
          description: Current holders of the specified NFT instance, with pagination.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonErrorResponse'
          description: Unprocessable Entity
      callbacks: {}
components:
  schemas:
    AddressHash:
      nullable: false
      pattern: ^0x([A-Fa-f0-9]{40})$
      title: AddressHash
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.AddressHash
      x-validate: null
    IntegerStringNullable:
      nullable: true
      pattern: ^-?([1-9][0-9]*|0)$
      title: IntegerStringNullable
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerStringNullable
      x-validate: null
    IntegerString:
      nullable: false
      pattern: ^-?([1-9][0-9]*|0)$
      title: IntegerString
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.IntegerString
      x-validate: null
    EmptyString:
      maxLength: 0
      minLength: 0
      title: EmptyString
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.EmptyString
      x-validate: null
    NullString:
      pattern: ^null$
      title: NullString
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.NullString
      x-validate: null
    TokenHolderResponse:
      additionalProperties: false
      description: Token holder response
      example:
        address:
          ens_domain_name: null
          hash: '0xF977814e90dA44bFA03b6295A0616a897441aceC'
          implementations: []
          is_contract: false
          is_scam: false
          is_verified: false
          metadata:
            tags:
              - meta:
                  main_entity: Binance
                  tooltipUrl: https://www.binance.com/
                name: 'Binance: Hot Wallet 20'
                ordinal: 10
                slug: binance-hot-wallet-20
                tagType: name
              - meta:
                  tooltipUrl: https://www.binance.com
                name: Binance 8
                ordinal: 10
                slug: binance-8
                tagType: name
              - meta: {}
                name: HOT WALLET
                ordinal: 0
                slug: hot-wallet
                tagType: generic
              - meta: {}
                name: Exchange
                ordinal: 0
                slug: exchange
                tagType: generic
              - meta: {}
                name: Binance
                ordinal: 0
                slug: binance
                tagType: protocol
          name: null
          private_tags: []
          proxy_type: null
          public_tags: []
          reputation: ok
          watchlist_names: []
        token_id: null
        value: '19474530513868000'
      properties:
        address:
          additionalProperties: false
          description: Address
          properties:
            ens_domain_name:
              description: ENS domain name associated with the address
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            hash:
              $ref: '#/components/schemas/AddressHash'
            implementations:
              description: Implementations linked with the contract
              items:
                $ref: '#/components/schemas/Implementation'
              type: array
              x-struct: null
              x-validate: null
            is_contract:
              description: Has address contract code?
              nullable: true
              type: boolean
              x-struct: null
              x-validate: null
            is_scam:
              description: Has address scam badge?
              nullable: false
              type: boolean
              x-struct: null
              x-validate: null
            is_verified:
              description: Has address associated source code?
              nullable: true
              type: boolean
              x-struct: null
              x-validate: null
            metadata:
              allOf:
                - $ref: '#/components/schemas/Metadata'
              nullable: true
              x-struct: null
              x-validate: null
            name:
              description: Name associated with the address
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            private_tags:
              description: Private tags associated with the address
              items:
                $ref: '#/components/schemas/Tag'
              type: array
              x-struct: null
              x-validate: null
            proxy_type:
              $ref: '#/components/schemas/ProxyType'
            public_tags:
              description: Public tags associated with the address
              items:
                $ref: '#/components/schemas/Tag'
              type: array
              x-struct: null
              x-validate: null
            reputation:
              description: Reputation of the address
              enum:
                - ok
                - scam
              nullable: false
              type: string
              x-struct: null
              x-validate: null
            watchlist_names:
              description: Watchlist name associated with the address
              items:
                $ref: '#/components/schemas/WatchlistName'
              type: array
              x-struct: null
              x-validate: null
          required:
            - hash
            - is_contract
            - name
            - is_scam
            - reputation
            - proxy_type
            - implementations
            - is_verified
            - ens_domain_name
            - metadata
          title: Address
          type: object
          x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Address
          x-validate: null
        token_id:
          $ref: '#/components/schemas/IntegerStringNullable'
        value:
          $ref: '#/components/schemas/IntegerStringNullable'
      required:
        - address
        - token_id
        - value
      title: TokenHolderResponse
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Token.Holder
      x-validate: null
    NotFoundResponse:
      description: Response returned when the requested resource is not found
      properties:
        message:
          description: Error message indicating the requested resource was not found
          example: Resource not found
          type: string
          x-struct: null
          x-validate: null
      title: NotFoundResponse
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.ErrorResponses.NotFoundResponse
      x-validate: null
    JsonErrorResponse:
      properties:
        errors:
          items:
            properties:
              detail:
                example: null value where string expected
                type: string
                x-struct: null
                x-validate: null
              source:
                properties:
                  pointer:
                    example: /data/attributes/petName
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - pointer
                type: object
                x-struct: null
                x-validate: null
              title:
                example: Invalid value
                type: string
                x-struct: null
                x-validate: null
            required:
              - title
              - source
              - detail
            type: object
            x-struct: null
            x-validate: null
          type: array
          x-struct: null
          x-validate: null
      required:
        - errors
      title: JsonErrorResponse
      type: object
      x-struct: Elixir.OpenApiSpex.JsonErrorResponse
      x-validate: null
    Implementation:
      additionalProperties: false
      description: Proxy smart contract implementation
      properties:
        address_hash:
          $ref: '#/components/schemas/AddressHash'
        name:
          nullable: true
          type: string
          x-struct: null
          x-validate: null
      required:
        - address_hash
        - name
      title: Implementation
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Implementation
      x-validate: null
    Metadata:
      additionalProperties: false
      description: Metadata struct
      properties:
        tags:
          description: Metadata tags linked with the address
          items:
            $ref: '#/components/schemas/MetadataTag'
          type: array
          x-struct: null
          x-validate: null
      required:
        - tags
      title: Metadata
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.Metadata
      x-validate: null
    Tag:
      additionalProperties: false
      description: Address tag struct
      properties:
        address_hash:
          $ref: '#/components/schemas/AddressHash'
        display_name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        label:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - address_hash
        - display_name
        - label
      title: Tag
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.Tag
      x-validate: null
    ProxyType:
      enum:
        - eip1167
        - eip1967
        - eip1822
        - eip1967_oz
        - eip1967_beacon
        - master_copy
        - basic_implementation
        - basic_get_implementation
        - comptroller
        - eip2535
        - clone_with_immutable_arguments
        - eip7702
        - resolved_delegate_proxy
        - erc7760
      nullable: true
      title: ProxyType
      type: string
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.ProxyType
      x-validate: null
    WatchlistName:
      additionalProperties: false
      description: Watchlist name struct
      properties:
        display_name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        label:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - display_name
        - label
      title: WatchlistName
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.General.WatchlistName
      x-validate: null
    MetadataTag:
      additionalProperties: false
      description: Metadata tag struct
      properties:
        meta:
          nullable: false
          type: object
          x-struct: null
          x-validate: null
        name:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        ordinal:
          nullable: false
          type: integer
          x-struct: null
          x-validate: null
        slug:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
        tagType:
          nullable: false
          type: string
          x-struct: null
          x-validate: null
      required:
        - slug
        - name
        - tagType
        - ordinal
        - meta
      title: MetadataTag
      type: object
      x-struct: Elixir.BlockScoutWeb.Schemas.API.V2.Proxy.MetadataTag
      x-validate: null

````