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

# Get proof record by id

> Returns the proof record and verification state. Payload is shaped for the caller (public vs owner vs private).



## OpenAPI

````yaml /openapi/public-api.json get /api/v1/proofs/{qHash}
openapi: 3.0.3
info:
  title: NEUS API — Public Integrator API
  version: 1.0.0
  description: >-
    Public HTTP API for NEUS integrators.


    Recommended integration order (simplest first):

    1. Browser — VerifyGate widget or hosted verify at
    https://neus.network/verify (wallet, passkey, and OAuth handled by NEUS).

    2. JavaScript — `@neus/sdk` `client.verify()` signs and submits for
    signature-based verifiers; use VerifyGate for hosted/interactive verifiers.

    3. Server gate checks — `GET /api/v1/proofs/check` with `gateId` or criteria
    before granting access.

    4. Raw HTTP — two-phase signing below only when you cannot use the SDK or
    hosted flows.


    Raw HTTP verification uses POST /api/v1/verification/standardize → sign
    signerString → POST /api/v1/verification with the same body plus signature.
    Session-authenticated callers may skip the signature when a valid session is
    present.


    Use your deployment base URL (for example https://api.neus.network). Some
    verifiers require pro access. Administrative endpoints are not included in
    this specification.
  license:
    name: Business Source License 1.1
    url: https://mariadb.com/bsl11/
servers:
  - url: https://api.neus.network
    description: Production API
security: []
paths:
  /api/v1/proofs/{qHash}:
    get:
      tags:
        - Proofs
      summary: Get proof record by id
      description: >-
        Returns the proof record and verification state. Payload is shaped for
        the caller (public vs owner vs private).
      operationId: getProofRecord
      parameters:
        - name: qHash
          in: path
          required: true
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{64}$
        - name: latestScope
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
              - 'yes'
        - name: trackView
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
        - name: walletAddress
          in: query
          required: false
          schema:
            type: string
        - name: verifierId
          in: query
          required: false
          schema:
            type: string
        - name: scopeKey
          in: query
          required: false
          schema:
            type: string
        - name: x-wallet-address
          in: header
          required: false
          schema:
            type: string
        - name: x-track-view
          in: header
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
        - name: x-signature
          in: header
          required: false
          schema:
            type: string
        - name: x-signed-timestamp
          in: header
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProofRecordResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ProofRecordResponse:
      type: object
      description: >-
        Proof record and verification state. The `data` object is shaped for the
        caller (public, owner-authenticated, or minimal private).
      properties:
        success:
          type: boolean
        data:
          type: object
          additionalProperties: true
        status:
          type: string
        qHash:
          type: string
        cached:
          type: boolean
        cachedAt:
          type: number
      additionalProperties: true
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          enum:
            - false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
            type:
              type: string
            details: {}
          additionalProperties: true
        timestamp:
          $ref: '#/components/schemas/Timestamp'
        requestId:
          type: string
      additionalProperties: true
    Timestamp:
      oneOf:
        - type: string
          format: date-time
        - type: number

````