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

# Get CNFT item data and proof

> Returns item metadata and Merkle proof for a single CNFT by collection address and item index. The proof can be used for on-chain verification.



## OpenAPI

````yaml /openapi.yaml get /badges/cnft/{address}/v1/items/{index}
openapi: 3.1.0
info:
  title: Identity Hub API
  version: 1.0.0
  description: TON ecosystem identity and reputation platform.
servers:
  - url: https://api.identityhub.app
    description: Production
security: []
tags:
  - name: Health
    description: Server health checks
  - name: Users
    description: Public user profiles, scores, badges, and contributions
  - name: Contests
    description: Contest listings and submissions
  - name: Blog
    description: Blog posts
  - name: Stats
    description: Platform statistics
paths:
  /badges/cnft/{address}/v1/items/{index}:
    get:
      tags:
        - CNFT Augmenting API
      summary: Get CNFT item data and proof
      description: >-
        Returns item metadata and Merkle proof for a single CNFT by collection
        address and item index. The proof can be used for on-chain verification.
      parameters:
        - schema:
            type: string
          in: path
          name: address
          required: true
          description: CNFT collection address on TON
        - schema:
            type: integer
            minimum: 0
            maximum: 9007199254740991
          in: path
          name: index
          required: true
          description: Item index
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CnftItemResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    CnftItemResponse:
      type: object
      properties:
        item:
          $ref: '#/components/schemas/CnftItemData'
        proof_cell:
          type: string
          description: Base64-encoded Merkle proof BOC for claim
      required:
        - item
        - proof_cell
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          const: false
        error:
          type: string
        code:
          $ref: '#/components/schemas/ErrorCode'
        details:
          type: array
          items:
            type: object
            properties:
              path:
                type: string
                description: Normalized field path, e.g. "email" or "profile.displayName"
              location:
                type: string
                enum:
                  - body
                  - querystring
                  - params
                  - headers
                  - unknown
                description: Request part where validation failed
              message:
                type: string
                description: Human-readable validation error
              rule:
                description: Validation rule/code (e.g. invalid_type, format)
                type: string
            required:
              - path
              - location
              - message
            additionalProperties: false
      required:
        - success
        - error
      additionalProperties: false
      example:
        success: false
        error: User not found
        code: NOT_FOUND
    CnftItemData:
      type: object
      properties:
        metadata:
          type: object
          properties:
            owner:
              type: string
            individual_content:
              type: string
              description: Base64-encoded item content BOC
          required:
            - owner
            - individual_content
          additionalProperties: false
        index:
          type: string
          description: Item index as string
      required:
        - metadata
        - index
      additionalProperties: false
    ErrorCode:
      type: string
      enum:
        - UNAUTHORIZED
        - INVALID_TOKEN
        - TOKEN_EXPIRED
        - TOKEN_RIGHTS_OUTDATED
        - ACCOUNT_DEACTIVATED
        - ACCOUNT_ALREADY_DEACTIVATED
        - REFRESH_TOKEN_EXPIRED
        - REFRESH_TOKEN_REUSED
        - REFRESH_TOKEN_INVALID
        - API_KEY_MISSING
        - API_KEY_INVALID
        - AGENT_KEY_INVALID
        - AGENT_KEY_REVOKED
        - AGENT_KEY_RATE_LIMITED
        - AGENT_PROFILE_NOT_FOUND
        - AGENT_NAME_TAKEN
        - AGENT_CLAIM_INVALID
        - AGENT_CLAIM_EXPIRED
        - AGENT_ALREADY_CLAIMED
        - AGENT_NOT_PUBLISHED
        - AGENT_LIMIT_REACHED
        - AGENT_REGISTER_RATE_LIMITED
        - AGENT_CLAIM_RATE_LIMITED
        - SOCIAL_ACCOUNT_ALREADY_LINKED
        - PLATFORM_ALREADY_LINKED
        - LAST_LOGIN_METHOD
        - OAUTH_TOKEN_INVALID
        - OAUTH_PROVIDER_UNSUPPORTED
        - USERNAME_TAKEN
        - USERNAME_RESERVED
        - DISPLAY_NAME_RESERVED
        - RATE_LIMIT_EXCEEDED
        - AUTH_RATE_LIMIT_EXCEEDED
        - GATEWAY_NOT_ELIGIBLE
        - VALIDATION_ERROR
        - NOT_FOUND
        - CONFLICT
        - FORBIDDEN
        - INTERNAL_ERROR
        - DATABASE_ERROR
        - PARSER_ERROR
        - EMAIL_ALREADY_TAKEN
        - EMAIL_CODE_INVALID
        - EMAIL_CODE_EXPIRED
        - EMAIL_RATE_LIMITED
        - EMAIL_SEND_FAILED
        - EMAIL_NOT_LINKED
        - PROOF_PAYLOAD_INVALID
        - PROOF_USER_MISMATCH
        - PROOF_UNSUPPORTED_WALLET
        - PROOF_PUBLIC_KEY_MISMATCH
        - PROOF_ADDRESS_MISMATCH
        - PROOF_DOMAIN_NOT_ALLOWED
        - PROOF_EXPIRED
        - PROOF_SIGNATURE_INVALID
        - PROOF_VERIFICATION_FAILED

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.