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

# getNullifierQueueElements

> Retrieve queued nullifiers for a tree in ascending sequence order.

## Queue Pagination

This method supports nullifier tree maintenance. It returns `result.elements` in ascending `seq` order, starting at `startSeq` inclusively. Each element contains its sequence number and base58-encoded nullifier `value`.

To read the next page, set `startSeq` to the final returned `seq` plus one. An empty page means no further elements are currently indexed.

## Request Parameters

**limit** `number` *required*

Maximum number of elements to return, from 1 to 1,000.

**startSeq** `number` (default: 0)

Return queued elements with seq greater than or equal to this value.

**treeAccount** `string` *required*

Tree account to query. The state tree and nullifier tree share one account.


## OpenAPI

````yaml openapi/privacy/getNullifierQueueElements.yaml POST /v1/spr/getNullifierQueueElements
openapi: 3.0.3
info:
  title: Solana Privacy Rings API
  version: 0.51.2
  description: >-
    Privacy indexer JSON-RPC API for encrypted state, history, proofs, and
    public registry records.
servers:
  - url: https://devnet.helius-rpc.com
    description: Devnet Solana Privacy Rings API
security: []
paths:
  /v1/spr/getNullifierQueueElements:
    post:
      summary: getNullifierQueueElements
      description: Retrieve queued nullifiers for a tree in ascending sequence order.
      operationId: getNullifierQueueElements
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                id:
                  type: string
                  description: An ID to identify the request.
                  default: '1'
                jsonrpc:
                  type: string
                  description: The JSON-RPC protocol version.
                  enum:
                    - '2.0'
                  default: '2.0'
                method:
                  type: string
                  description: The method to invoke. Must match the final URL path segment.
                  enum:
                    - getNullifierQueueElements
                  default: getNullifierQueueElements
                params:
                  type: object
                  required:
                    - treeAccount
                    - limit
                  properties:
                    limit:
                      allOf:
                        - $ref: '#/components/schemas/Limit'
                      description: Maximum number of elements to return, from 1 to 1,000.
                    startSeq:
                      type: integer
                      format: uint64
                      description: >-
                        Return queued elements with seq greater than or equal to
                        this value.
                      minimum: 0
                      maximum: 9223372036854776000
                      default: 0
                    treeAccount:
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      description: >-
                        Tree account to query. The state tree and nullifier tree
                        share one account.
                  additionalProperties: false
                  example:
                    treeAccount: 33KVhbT4QtdQDrrrGwwThqD47Dh4Q6tA443t9jMNcWFN
                    startSeq: 0
                    limit: 100
            example:
              jsonrpc: '2.0'
              id: '1'
              method: getNullifierQueueElements
              params:
                treeAccount: 33KVhbT4QtdQDrrrGwwThqD47Dh4Q6tA443t9jMNcWFN
                startSeq: 0
                limit: 100
        required: true
      responses:
        '200':
          description: JSON-RPC response. Inspect error before reading result.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                properties:
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
                  id:
                    type: string
                    description: The request ID.
                  jsonrpc:
                    type: string
                    description: The version of the JSON-RPC protocol.
                    enum:
                      - '2.0'
                  result:
                    type: object
                    required:
                      - context
                      - elements
                    properties:
                      context:
                        $ref: '#/components/schemas/Context'
                      elements:
                        type: array
                        items:
                          $ref: '#/components/schemas/NullifierQueueElement'
                    additionalProperties: false
        '400':
          description: >-
            Rejected before execution. A method/path mismatch, duplicate method
            fields, or a batch request returns -32601. An unreadable or
            oversized body returns -32600.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      The request id, or null when the body is not a single
                      JSON-RPC call.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      The request id, or null when the body is not a single
                      JSON-RPC call.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                required:
                  - jsonrpc
                  - id
                  - error
                properties:
                  jsonrpc:
                    type: string
                    enum:
                      - '2.0'
                  id:
                    type: string
                    nullable: true
                    description: >-
                      The request id, or null when the body is not a single
                      JSON-RPC call.
                  error:
                    type: object
                    required:
                      - code
                      - message
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                      data:
                        type: object
                        additionalProperties: true
      security:
        - ApiKeyQuery: []
components:
  schemas:
    Limit:
      type: integer
      format: uint64
      maximum: 1000
      minimum: 1
    SerializablePubkey:
      type: string
      description: A base58-encoded Solana public key.
    Context:
      type: object
      required:
        - blockTime
        - slot
      properties:
        blockTime:
          type: integer
          format: int64
        slot:
          type: integer
          format: uint64
          description: >-
            Highest slot the indexer has persisted, for slot-based freshness
            checks.
          minimum: 0
    NullifierQueueElement:
      type: object
      description: One queued nullifier, in on-chain input-queue order.
      required:
        - seq
        - value
      properties:
        seq:
          type: integer
          format: uint64
          minimum: 0
        value:
          $ref: '#/components/schemas/Hash'
      additionalProperties: false
    Hash:
      type: string
      description: A base58-encoded 32-byte hash.
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: Your Helius API key.

````

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