> ## 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 proofs by wallet or DID



## OpenAPI

````yaml /openapi/public-api.json get /api/v1/proofs/by-wallet/{address}
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/by-wallet/{address}:
    get:
      tags:
        - Proofs
      summary: Get proofs by wallet or DID
      operationId: getProofsByWallet
      parameters:
        - name: address
          in: path
          required: true
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
        - name: status
          in: query
          required: false
          schema:
            type: string
        - name: visibility
          in: query
          required: false
          schema:
            type: string
            enum:
              - public
        - name: isPublicRead
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
              - 'yes'
        - name: includeHistory
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
              - 'yes'
        - name: tag
          in: query
          required: false
          schema:
            type: string
        - name: tags
          in: query
          required: false
          schema:
            type: string
        - name: includeSecrets
          in: query
          required: false
          schema:
            type: string
            enum:
              - '1'
              - 'true'
              - 'yes'
              - '0'
              - 'false'
              - 'no'
        - name: qHash
          in: query
          required: false
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{64}$
            description: Filter to single proof by qHash
        - name: x-wallet-address
          in: header
          required: false
          schema:
            type: string
        - name: x-signature
          in: header
          required: false
          schema:
            type: string
        - name: x-signed-timestamp
          in: header
          required: false
          schema:
            type: string
        - name: x-chain
          in: header
          required: false
          schema:
            type: string
            description: >-
              CAIP-2 chain reference for non-EVM signature verification (e.g.
              solana:mainnet)
        - name: x-signature-method
          in: header
          required: false
          schema:
            type: string
            description: Signature method hint for non-EVM signatures (e.g. ed25519)
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProofsByWalletResponse'
        '304':
          description: Not modified
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    ProofsByWalletResponse:
      type: object
      required:
        - success
        - data
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          type: object
          required:
            - proofs
            - totalCount
            - hasMore
            - resolved
            - pagination
          properties:
            proofs:
              type: array
              items:
                type: object
                additionalProperties: true
            totalCount:
              nullable: true
              type: number
            hasMore:
              type: boolean
            nextOffset:
              nullable: true
              type: number
            nextCursor:
              nullable: true
              type: string
            pageInfo:
              type: object
              additionalProperties: true
              properties:
                limit:
                  type: integer
                hasNextPage:
                  type: boolean
                nextCursor:
                  nullable: true
                  type: string
            resolved:
              type: object
              additionalProperties: true
            pagination:
              type: object
              additionalProperties: true
          additionalProperties: true
        timestamp:
          $ref: '#/components/schemas/Timestamp'
      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

````