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

# Lookup NFT By Token ID

> Retrieves detailed information about a specific NFT token within a collection, identified by its token ID.



## OpenAPI

````yaml /open-api/0xapi.yaml get /v2/{chain_name}/collections/{collection_address}/nfts/{token_id}
openapi: 3.0.0
info:
  description: >-
    API for accessing blockchain data including tokens, NFTs, transactions,
    events, ENS, and blocks. Authentication is optional; providing an API key
    via Bearer token may grant higher rate limits or access to additional
    features.
  title: Ormi Data API
  version: v2
servers:
  - url: https://api.data.ormilabs.com
security:
  - OrmiApiKey: []
tags:
  - description: Operations related to fungible tokens and wallet balances.
    name: Tokens
  - description: Operations related to Non-Fungible Tokens (NFTs).
    name: NFTs
  - description: Operations related to blockchain transactions.
    name: Transactions
  - description: Operations related to smart contract events.
    name: Events
  - description: Operations related to blockchain blocks.
    name: Blocks
paths:
  /v2/{chain_name}/collections/{collection_address}/nfts/{token_id}:
    get:
      tags:
        - NFTs
      summary: Lookup NFT By Token ID
      description: >-
        Retrieves detailed information about a specific NFT token within a
        collection, identified by its token ID.
      operationId: lookupNFT
      parameters:
        - $ref: '#/components/parameters/CollectionAddressParameter'
        - description: The unique identifier of the NFT token.
          in: path
          name: token_id
          required: true
          schema:
            example: 3123121
            format: uint64
            type: integer
        - $ref: '#/components/parameters/ChainNameParameter'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NFTDetailResponse'
          description: Successfully retrieved NFT details.
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '429':
          $ref: '#/components/responses/RateLimitError'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    CollectionAddressParameter:
      description: The NFT collection contract address.
      in: path
      name: collection_address
      required: true
      schema:
        example: '0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D'
        pattern: ^0x[a-fA-F0-9]{40}$
        type: string
    ChainNameParameter:
      description: The name or ID of the blockchain.
      in: path
      name: chain_name
      required: true
      schema:
        enum:
          - ethereum
          - apechain
          - arbitrum
          - avalanche
          - base
          - bsc
          - polygon
        example: ethereum
        type: string
  schemas:
    NFTDetailResponse:
      properties:
        nft:
          $ref: '#/components/schemas/NFTItem'
      required:
        - nft
      type: object
    NFTItem:
      properties:
        attributes:
          example: []
          items:
            type: object
          type: array
        description:
          example: ''
          type: string
        external_uri:
          example: ''
          format: uri
          type: string
        image_uri:
          example: ''
          format: uri
          type: string
        logo:
          example: https://asdadassa.com/adsad.png
          format: uri
          type: string
        mint_block_number:
          example: 12321312
          format: int64
          type: integer
        mint_block_timestamp:
          example: '2025-05-12T13:00:05Z'
          format: date-time
          type: string
        name:
          example: Bacacacac
          type: string
        owner_address:
          description: The address of the owner of this specific NFT.
          example: '0x312e67b47a2a29ae200184949093d92369f80b53'
          pattern: ^0x[a-fA-F0-9]{40}$
          type: string
        standard:
          example: ERC-721
          type: string
        symbol:
          example: BAC
          type: string
        token_address:
          example: '0x312e67b47a2a29ae200184949093d92369f80b53'
          pattern: ^0x[a-fA-F0-9]{40}$
          type: string
        token_id:
          example: '3123121'
          type: string
        token_uri:
          example: ''
          format: uri
          type: string
      required:
        - standard
        - token_address
        - token_id
        - token_uri
        - symbol
        - name
        - logo
        - attributes
        - description
        - image_uri
        - external_uri
        - mint_block_number
        - mint_block_timestamp
        - owner_address
      type: object
    ApiError:
      properties:
        code:
          description: Internal application-specific error code.
          example: 20001
          type: integer
        data:
          additionalProperties: true
          description: Additional data related to the error, if applicable.
          example: {}
          type: object
        msg:
          description: A human-readable message providing more details about the error.
          example: Invalid API key provided.
          type: string
      required:
        - code
        - msg
      type: object
  responses:
    BadRequestError:
      content:
        application/json:
          examples:
            genericBadRequest:
              summary: Generic Bad Request
              value:
                code: 20101
                data: {}
                msg: Bad request. Please check your input.
            missingData:
              summary: Missing data
              value:
                code: 20301
                data: {}
                msg: Data missing. Please check your input.
            validationFailed:
              summary: Validation Failed
              value:
                code: 20201
                data:
                  errors:
                    - field: email
                      message: Email is not valid
                    - field: age
                      message: Age must be a positive number
                msg: Validation failed. Please check your input
          schema:
            $ref: '#/components/schemas/ApiError'
      description: >-
        Bad Request - The server cannot or will not process the request due to
        something that is perceived to be a client error (e.g., malformed
        request syntax, invalid request message framing, or deceptive request
        routing).
    UnauthorizedError:
      content:
        application/json:
          examples:
            invalidApiKey:
              summary: Invalid API Key
              value:
                code: 10005
                data: {}
                msg: Invalid API key provided.
            missingApiKey:
              summary: Missing API Key
              value:
                code: 10003
                data: {}
                msg: API key is missing from the Authorization header.
          schema:
            $ref: '#/components/schemas/ApiError'
      description: >-
        Unauthorized - The client request has not been completed because it
        lacks valid authentication credentials for the requested resource.
        Typically for an invalid or missing API key.
    RateLimitError:
      content:
        application/json:
          examples:
            rateLimited:
              summary: Rate Limit Exceeded
              value:
                code: 10020
                data:
                  retry_after_seconds: 60
                msg: Rate limit exceeded. Please try again later.
          schema:
            $ref: '#/components/schemas/ApiError'
      description: >-
        Too Many Requests - The user has sent too many requests in a given
        amount of time ("rate limiting").
    InternalServerError:
      content:
        application/json:
          examples:
            serverError:
              summary: Internal Server Error
              value:
                code: 20901
                data: {}
                msg: An unexpected internal server error occurred.
          schema:
            $ref: '#/components/schemas/ApiError'
      description: >-
        Internal Server Error - The server encountered an unexpected condition
        that prevented it from fulfilling the request.
  securitySchemes:
    OrmiApiKey:
      description: >
        Enter your API key in the format: Bearer <api_key>.

        Providing an API key may grant higher rate limits or access to
        additional features.

        The API will function without an API key for basic access.
      scheme: bearer
      type: http

````