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

# Internal Transactions Advanced Filter

> Retrieves Internal Transactions with advanced from and to address filtering.

<Badge icon="flask" color="yellow">Beta</Badge>

Explore and preview data from our [Advanced Filter](https://etherscan.io/advanced-filter) page.

<ResponseExample>
  ```json Example response theme={null}
  {
     "status":"1",
     "message":"OK",
     "result":[
        {
           "blockNumber":"2535368",
           "timeStamp":"1477837690",
           "hash":"0x8a1a9989bda84f80143181a68bc137ecefa64d0d4ebde45dd94fc0cf49e70cb6",
           "from":"0x20d42f2e99a421147acf198d775395cac2e8b03d",
           "to":"",
           "value":"0",
           "contractAddress":"0x2c1ba59d6f58433fb1eaee7d20b26ed83bda51a3",
           "input":"",
           "type":"create",
           "gas":"254791",
           "gasUsed":"46750",
           "traceId":"0",
           "isError":"0",
           "errCode":""
        }
     ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml openapi/api-reference/endpoint/advanced-filter-txlistinternal.json GET /v2/api
openapi: 3.1.0
info:
  title: Internal Transactions Advanced Filter
  version: 2.0.0
  description: Retrieves Internal Transactions with advanced from and to address filtering.
  license:
    name: Etherscan API Terms
    url: https://etherscan.io/terms
servers:
  - url: https://api.etherscan.io
    description: Etherscan API.
security:
  - apiKey: []
paths:
  /v2/api:
    get:
      summary: Internal Transactions Advanced Filter
      description: >-
        Retrieves Internal Transactions with advanced from and to address
        filtering.
      operationId: getAdvancedFilterTxlistinternal
      parameters:
        - name: chainid
          in: query
          required: true
          description: >-
            Chain ID to query, such as 1 for Ethereum or 42161 for Arbitrum from
            our [supported chains](/supported-chains).
          schema:
            type: string
          example: '1'
        - name: module
          in: query
          required: true
          description: Set to account for this endpoint.
          schema:
            type: string
            default: account
          example: account
        - name: action
          in: query
          required: true
          description: Set to txlistinternal for this endpoint.
          schema:
            type: string
            default: txlistinternal
          example: txlistinternal
        - name: from
          in: query
          required: false
          description: >-
            The sender address to filter transactions by. Provide from or to, or
            provide both startblock and endblock.
          schema:
            type: string
          example: '0x73605779985A11B8Fe32E6eD5ae5F249FFD0D7f0'
        - name: to
          in: query
          required: false
          description: >-
            The recipient address to filter transactions by. Provide to or from,
            or provide both startblock and endblock.
          schema:
            type: string
          example: '0x71c7656ec7ab88b098defb751b7401b5f6d8976f'
        - name: fromto_opr
          in: query
          required: false
          description: >-
            Required when from or to is provided. Use and when both addresses
            must match, or or when either address can match.
          schema:
            type: string
          example: or
        - name: startblock
          in: query
          required: false
          description: Starting block number to search from.
          schema:
            type: integer
          example: 0
        - name: endblock
          in: query
          required: false
          description: Ending block number to search to, or latest for the latest block.
          schema:
            type: string
          example: latest
        - name: sort
          in: query
          required: false
          description: >-
            Sort order, either `desc` for the latest transactions first or `asc`
            for the oldest transactions first.
          schema:
            type: string
          example: desc
        - name: page
          in: query
          required: false
          description: Page number for pagination.
          schema:
            type: integer
          example: 1
        - name: offset
          in: query
          required: false
          description: >-
            Number of records per page. Use the page parameter for subsequent
            records.
          schema:
            type: integer
          example: 10
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: >-
                      1 if the request returned data, 0 otherwise. A status of 0
                      can indicate an error or a valid request that returned no
                      records.
                  message:
                    type: string
                    description: >-
                      OK on success, otherwise an error description such as
                      NOTOK. See [common error
                      messages](/common-error-messages).
                  result:
                    type: array
                    items:
                      type: object
                      properties:
                        blockNumber:
                          type: string
                          description: Block number in which the transaction was included.
                        timeStamp:
                          type: string
                          description: >-
                            Time the block was mined, as a UNIX timestamp in
                            seconds.
                        hash:
                          type: string
                          description: The transaction hash.
                        from:
                          type: string
                          description: Address that sent the transaction.
                        to:
                          type: string
                          description: >-
                            Recipient address. Empty for contract-creation
                            transactions.
                        value:
                          type: string
                          description: >-
                            Amount of the native token transferred, in wei. Use
                            the [unit
                            converter](https://etherscan.io/unitconverter) to
                            convert between units.
                        contractAddress:
                          type: string
                          description: >-
                            Address of the contract created, if the transaction
                            deployed one. Otherwise empty.
                        input:
                          type: string
                          description: >-
                            Input data sent with the transaction, as a hex
                            string.
                        type:
                          type: string
                          description: >-
                            Type of internal call, such as call, create,
                            create2, or self-destruct.
                        gas:
                          type: string
                          description: >-
                            Maximum units of gas the sender allowed for the
                            transaction.
                        gasUsed:
                          type: string
                          description: Units of gas actually consumed by the transaction.
                        traceId:
                          type: string
                          description: >-
                            Identifier for the position of this internal call
                            within the transaction's trace.
                        isError:
                          type: string
                          description: >-
                            0 if the transaction executed successfully, 1 if it
                            failed.
                        errCode:
                          type: string
                          description: >-
                            Error code when the internal call failed. Empty on
                            success.
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: apikey
      description: >-
        Enter your Etherscan API key, or [set one up](/set-up-your-api-key) if
        you don't have one.

````