> ## 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.

# Transactions

> Allows searching for transactions by various criteria (account, block, etc.) on the ICRC-1 ledger.



## OpenAPI

````yaml nodeapi/openapi/icrc-openapiv3-vc3.json POST /search/transactions
openapi: 3.0.3
info:
  title: ICRC-1 Rosetta API
  description: >-
    OpenAPI v3 specification for ICRC-1 Rosetta endpoints on the Internet
    Computer.
  version: 1.0.0
servers:
  - url: https://icrc-mainnet.icp.validationcloud.io/v1/<YOUR_API_KEY_HERE>
security: []
paths:
  /search/transactions:
    post:
      tags:
        - Search
      summary: Search for transactions
      description: >-
        Allows searching for transactions by various criteria (account, block,
        etc.) on the ICRC-1 ledger.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchTransactionsRequest'
      responses:
        '200':
          description: Search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchTransactionsResponse'
        '500':
          description: Internal server error
components:
  schemas:
    SearchTransactionsRequest:
      type: object
      properties:
        network_identifier:
          $ref: '#/components/schemas/NetworkIdentifier'
        operator:
          type: string
        max_block:
          type: integer
        offset:
          type: integer
        limit:
          type: integer
        transaction_identifier:
          $ref: '#/components/schemas/TransactionIdentifier'
        account_identifier:
          $ref: '#/components/schemas/AccountIdentifier'
        coin_identifier:
          $ref: '#/components/schemas/CoinIdentifier'
        currency:
          $ref: '#/components/schemas/Currency'
    SearchTransactionsResponse:
      type: object
      properties:
        transactions:
          type: array
          items:
            $ref: '#/components/schemas/Transaction'
        total_count:
          type: integer
        next_offset:
          type: integer
    NetworkIdentifier:
      type: object
      required:
        - blockchain
        - network
      properties:
        blockchain:
          type: string
          example: Internet Computer
        network:
          type: string
          example: mxzaz-hqaaa-aaaar-qaada-cai
        sub_network_identifier:
          $ref: '#/components/schemas/SubNetworkIdentifier'
    TransactionIdentifier:
      type: object
      properties:
        hash:
          type: string
    AccountIdentifier:
      type: object
      required:
        - address
      properties:
        address:
          type: string
          description: For ICRC-1, this may be a principal or derived hex string.
        sub_account:
          $ref: '#/components/schemas/SubAccountIdentifier'
        metadata:
          type: object
          additionalProperties: true
    CoinIdentifier:
      type: object
      properties:
        identifier:
          type: string
    Currency:
      type: object
      properties:
        symbol:
          type: string
        decimals:
          type: integer
          format: int32
        metadata:
          type: object
          additionalProperties: true
    Transaction:
      type: object
      properties:
        transaction_identifier:
          $ref: '#/components/schemas/TransactionIdentifier'
        operations:
          type: array
          items:
            $ref: '#/components/schemas/Operation'
        metadata:
          type: object
          additionalProperties: true
    SubNetworkIdentifier:
      type: object
      required:
        - network
      properties:
        network:
          type: string
        metadata:
          type: object
          additionalProperties: true
    SubAccountIdentifier:
      type: object
      required:
        - address
      properties:
        address:
          type: string
          description: Typically a 32-byte hex-encoded subaccount in ICRC-1.
        metadata:
          type: object
          additionalProperties: true
    Operation:
      type: object
      properties:
        operation_identifier:
          $ref: '#/components/schemas/OperationIdentifier'
        related_operations:
          type: array
          items:
            $ref: '#/components/schemas/OperationIdentifier'
        type:
          type: string
        status:
          type: string
        account:
          $ref: '#/components/schemas/AccountIdentifier'
        amount:
          $ref: '#/components/schemas/Amount'
        metadata:
          type: object
          additionalProperties: true
    OperationIdentifier:
      type: object
      properties:
        index:
          type: integer
          format: int64
        network_index:
          type: integer
          format: int64
    Amount:
      type: object
      properties:
        value:
          type: string
        currency:
          $ref: '#/components/schemas/Currency'
        metadata:
          type: object
          additionalProperties: true

````

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