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

# Get Stateproof

> Returns the  contents of the address book file, signature files, and record file that can be used to validate the transaction occurred on the Hedera network given transaction id.

Get stateproof information

This method will use `20` [Compute Units](/nodeapi/about/billing).

***


## OpenAPI

````yaml nodeapi/openapi/hedera-openapi-5.json GET /api/v1/transactions/{transactionId}/stateproof
openapi: 3.0.0
info:
  title: Hedera Mirror Node REST API
  version: 0.85.1
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  description: >-
    The Mirror Node REST API offers the ability to query cryptocurrency
    transactions and account information from a Hedera managed mirror node.


    Base url: [/api/v1](/api/v1)


    OpenAPI Spec: [/api/v1/docs/openapi.yml](/api/v1/docs/openapi.yml)
  contact:
    name: Hedera Mirror Node Team
    email: mirrornode@hedera.com
    url: https://github.com/hashgraph/hedera-mirror-node
servers:
  - url: https://{network}.hedera.validationcloud.io/v1/{API_KEY}
    variables:
      API_KEY:
        default: YOUR_API_KEY
        description: API key for the user.
      network:
        default: mainnet
        description: The Hedera network in use
        enum:
          - mainnet
          - testnet
security: []
tags:
  - name: accounts
    description: >-
      The accounts object represents the information associated with an account
      entity and returns a list of account information.
    externalDocs:
      url: >-
        https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#accounts
  - name: balances
    description: >-
      The balance object represents the balance of accounts on the Hedera
      network.
    externalDocs:
      url: >-
        https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#balances
  - name: contracts
    description: >-
      The contracts objects represents the information associated with contract
      entities.
  - name: schedules
    description: >-
      The schedules object represents the information associated with a schedule
      entity.
  - name: transactions
    description: >-
      The transaction object represents the transactions processed on the Hedera
      network.
    externalDocs:
      url: >-
        https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#transactions
  - name: topics
    description: >-
      The topics object represents the information associated with a topic
      entity and returns topic messages information.
    externalDocs:
      url: >-
        https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api#topic-messages
  - name: tokens
    description: >-
      The tokens object represents the information associated with a token
      entity and returns a list of token information.
externalDocs:
  description: Hedera REST API Docs
  url: https://docs.hedera.com/guides/docs/mirror-node-api/cryptocurrency-api
paths:
  /api/v1/transactions/{transactionId}/stateproof:
    get:
      tags:
        - transactions
      summary: Get stateproof information
      description: >-
        Returns the  contents of the address book file, signature files, and
        record file that can be used to validate the transaction occurred on the
        Hedera network given transaction id.
      operationId: getStateproofInfo
      parameters:
        - $ref: '#/components/parameters/transactionIdPathParam'
        - $ref: '#/components/parameters/nonceQueryParamWithDefault'
        - $ref: '#/components/parameters/scheduledQueryParamWithDefault'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/StateProofResponseCompact'
                  - $ref: '#/components/schemas/StateProofResponseFull'
        '400':
          $ref: '#/components/responses/InvalidParameterError'
        '404':
          $ref: '#/components/responses/TransactionNotFound'
        '502':
          $ref: '#/components/responses/ServiceUnavailableError'
components:
  parameters:
    transactionIdPathParam:
      name: transactionId
      in: path
      required: true
      description: Transaction id
      example: 0.0.10-1234567890-000000000
      schema:
        type: string
    nonceQueryParamWithDefault:
      name: nonce
      in: query
      description: >-
        Filter the query result by the nonce of the transaction. A zero nonce
        represents user submitted transactions while a non-zero nonce is
        generated by main nodes. The filter honors the last value. Default is 0
        when not specified.
      example: 1
      schema:
        format: int32
        type: integer
        default: 0
        minimum: 0
    scheduledQueryParamWithDefault:
      name: scheduled
      in: query
      description: >-
        Filter transactions by the scheduled flag. If true, return information
        for the scheduled transaction. If false, return information for the
        non-scheduled transaction.
      schema:
        type: boolean
        default: false
  schemas:
    StateProofResponseCompact:
      type: object
      required:
        - address_books
        - record_file
        - signature_files
        - version
      properties:
        address_books:
          description: The network address book valid at the time of the transaction
          type: array
          items:
            type: string
            format: byte
        record_file:
          description: The record file the transaction belongs to, in compact format
          type: object
          required:
            - head
            - start_running_hash_object
            - end_running_hash_object
            - hashes_before
            - hashes_after
            - record_stream_object
            - block_number
          properties:
            head:
              description: The record file head
              type: string
              format: byte
            start_running_hash_object:
              description: The start running hash object
              type: string
              format: byte
            end_running_hash_object:
              description: THe end running hash object
              type: string
              format: byte
            hashes_before:
              description: >
                The hashes of the transactions before the transaction in query,
                in consensus timestamp ascending order
              type: array
              items:
                type: string
                format: byte
            hashes_after:
              description: >
                The hashes of the transactions after the transaction in query,
                in consensus timestamp ascending order
              type: array
              items:
                type: string
                format: byte
            record_stream_object:
              description: The record stream object of the transaction in query
              type: string
              format: byte
            block_number:
              description: >-
                The block number, in base64 encoding. Only present if version is
                6
              type: string
              format: byte
              nullable: true
        signature_files:
          description: The nodes' signature files for the record file
          type: object
          additionalProperties:
            type: string
            format: byte
        version:
          description: The record file format version, either 5 or 6
          format: int32
          minimum: 0
          type: integer
      example:
        address_books:
          - >-
            MjljY2IxNGNjNWY2NWM1MmZlYjc0MjkyYjAxZDUyZmRjZjJkZTY0NWQzOTRiNTM3MDQ2ODBkYjZkMTMyZWM2Yw==
        record_file:
          head: AAAABQAAAAAAAAAbAAAAAAAAAAE==
          start_running_hash_object: >-
            9CLag6JRdB4AAAABWP+BGwAAADCTEm5j2O9qy33fqKR/F0sKXYqPPQCt92kA2koMvkg4h6uhnEX/H0iXWL4CxWCK+C8=
          end_running_hash_object: >-
            9CLag6JRdB4AAAABWP+BGwAAADAkK6BKPFKbOX46Kul0OiAYR5x52X0cJLgPvmOjupycWgXRyItITx7HrfSjH5LpU6Q=
          hashes_before:
            - RxKzucDUGgqBgR+CXXfAKgYuE/xhIaBlo+hmMKyxrm8nmSiaG3a9hlLGHh6+yXFm
          hashes_after:
            - TOJuZz3EUX1RNdRJBfz7n+V9cYyEm//ER9h3s/y1d8nzs0VqYltJFE0dPangRC6c
            - RiRHvjPQPqUXNlvDJ6lPiv40ZOPVV3VcWRH8GOKFf6Xv9jK0vUjR2qGfjI/IRZRy
          record_stream_object: >-
            43CSm6VCnYsAAAABAAAA2gpgCBYqJAoQCLDqARCA3AsaBgjQ6f2WBhIQCLDqARCm5QsaBgjghf6WBjiR6EhCMDNd1b7xmTuNNiLcn2bdlAI=
          block_number: AAECoA==
        signature_files:
          0.0.3: >-
            MWFmYzZlNWVjNGJiZTg0ZWJjNTVkMGViNDViMjE2Mzg2ZTQ2NjUzZTYyYmM1NjE2YThmZGJjNzQ1ZWIyMTQxNQ==
          0.0.4: >-
            ZDI4ZDIwMGJiYTdkNDhmNTA3ZTE0MGZhNjIyOGFiYTdmMjlmZjhiMmEzZjJhOGVlYjg1NzQyZGMwNTNjZWM3MQ==
          0.0.5: >-
            MWY0YmU5OGE3NWE4N2NkNjQ5ZTNlMWE1ODI1OTI3NTgwNWM1Y2RmNjNmYjA0YjMzMTdlZmI1MTEwNzQ2NDVjNw==
          0.0.6: >-
            NzNiZTVmMTZkNmY4NTQ4MjdiN2M4MTEzZmFlY2I1YzIwNGI5ZjFkNjhiMzdkMzczNTg4OTRkOWFiZmM5N2U4Mw==
          0.0.7: >-
            NDJiZTVmMTZkNmY4NTQ4MjdiN2M4MTEzZmFlY2I1YzIwNGI5ZjFkNjhiMzdkMzczNTg4OTRkOWFiZmM5N2U4Mw==
        version: 6
    StateProofResponseFull:
      type: object
      required:
        - address_books
        - record_file
        - signature_files
      properties:
        address_books:
          description: The network address book valid at the time of the transaction
          type: array
          items:
            type: string
            format: byte
        record_file:
          description: The content of the record file the transaction belongs to
          type: string
          format: byte
        signature_files:
          description: The nodes' signature files for the record file
          type: object
          additionalProperties:
            type: string
            format: byte
      example:
        record_file: >-
          YzNkOTg3Yzg3NDI5NGViOTViMmRmOWZkMzZiMDY1NjYyMzMxNTc2OWFmMmVmMzQ0YzM1ODY4NzgwMTAyYjVjMA==
        address_books:
          - >-
            MjljY2IxNGNjNWY2NWM1MmZlYjc0MjkyYjAxZDUyZmRjZjJkZTY0NWQzOTRiNTM3MDQ2ODBkYjZkMTMyZWM2Yw==
        signature_files:
          0.0.3: >-
            MWFmYzZlNWVjNGJiZTg0ZWJjNTVkMGViNDViMjE2Mzg2ZTQ2NjUzZTYyYmM1NjE2YThmZGJjNzQ1ZWIyMTQxNQ==
          0.0.4: >-
            ZDI4ZDIwMGJiYTdkNDhmNTA3ZTE0MGZhNjIyOGFiYTdmMjlmZjhiMmEzZjJhOGVlYjg1NzQyZGMwNTNjZWM3MQ==
          0.0.5: >-
            MWY0YmU5OGE3NWE4N2NkNjQ5ZTNlMWE1ODI1OTI3NTgwNWM1Y2RmNjNmYjA0YjMzMTdlZmI1MTEwNzQ2NDVjNw==
          0.0.6: >-
            NzNiZTVmMTZkNmY4NTQ4MjdiN2M4MTEzZmFlY2I1YzIwNGI5ZjFkNjhiMzdkMzczNTg4OTRkOWFiZmM5N2U4Mw==
          0.0.7: >-
            NDJiZTVmMTZkNmY4NTQ4MjdiN2M4MTEzZmFlY2I1YzIwNGI5ZjFkNjhiMzdkMzczNTg4OTRkOWFiZmM5N2U4Mw==
    Error:
      type: object
      properties:
        _status:
          type: object
          properties:
            messages:
              type: array
              items:
                type: object
                properties:
                  data:
                    description: Error message in hexadecimal
                    example: '0x3000'
                    format: binary
                    nullable: true
                    pattern: ^0x[0-9a-fA-F]+$
                    type: string
                  detail:
                    description: Detailed error message
                    example: Generic detailed error message
                    nullable: true
                    type: string
                  message:
                    description: Error message
                    example: Generic error message
                    nullable: false
                    type: string
  responses:
    InvalidParameterError:
      description: Invalid parameter
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            _status:
              messages:
                - message: 'Invalid parameter: account.id'
                - message: >-
                    Invalid Transaction id. Please use \shard.realm.num-sss-nnn\
                    format where sss are seconds and nnn are nanoseconds
    TransactionNotFound:
      description: Transaction Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            _status:
              messages:
                - message: Transaction not found
    ServiceUnavailableError:
      description: Service Unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            _status:
              messages:
                - message: >-
                    Require at least 1/3 signature files to prove consensus, got
                    1 out of 4 for file 2019-10-11T13_33_25.526889Z.rcd_sig

````

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