Get transaction(s)

Transaction · Reads onchain state

Returns the transactions Plug has saved for an address: every intent created through the platform, with its status, schedule, and execution record, narrowed by whatever filters are applied. These are Plug's own records, not chain history. A row exists from the moment a transaction is created, tracks its life through scheduling, simulation, submission, and settlement, and keeps the verdict when something fails. Listing is all this surface does. Reach for it to show a user their pending and past transactions or to poll the state of an intent that was submitted earlier. Compiling new calldata belongs to the create step, not here.

Send a request

Response

{
    links: {
        self: string
        prev: string | undefined
        next: string | undefined
    } | undefined
    headers: unknown | undefined
    data: ({
        id: string
        status: string
        chain_id: number
        address: string
        value: string | integer | undefined
        gas_limit: number | null
        inputs: any[] | null
        steps: any | null
        created_at: string
        updated_at: string
        tx_hash: string | null
        execution_mode: string | undefined
        owner_address: string | undefined
        plugs_hash: string | undefined
        scheduler_status: string | undefined
        last_error: string | undefined
        verdict: string | undefined
        failing_condition: number | undefined
        last_simmed_block: number | undefined
    })[] | null
}

Code samples

Language

Prompt

Call the Plug API endpoint "Get transaction(s)".

## Endpoint
GET /address/{address}/transaction/
Base URL: https://api.plug.to

## Description
Returns the transactions Plug has saved for an address: every intent created through the platform, with its status, schedule, and execution record, narrowed by whatever filters are applied.

These are Plug's own records, not chain history. A row exists from the moment a transaction is created, tracks its life through scheduling, simulation, submission, and settlement, and keeps the verdict when something fails. Listing is all this surface does.

Reach for it to show a user their pending and past transactions or to poll the state of an intent that was submitted earlier. Compiling new calldata belongs to the create step, not here.

## Path Parameters
- address (string, required) — The EVM address to get information for. In the case that you request an address we have never indexed, we will immediately index it.
  Current value: 0x62180042606624f02d8a130da8a3171e9b33894d

## Query Parameters
- filter[id] (string, optional) — Filter results to a specific transaction id.
- filter[chain_id] (integer, optional) — Filter results to specific chains from the listed of supported options.
- filter[status] (string, optional) — Filter results to specific transaction statuses. [pending, confirmed, failed]

## Headers
- Accept (string, required) — For a typical single-time JSON response, set this to application/json. To receive realtime updates through a stream, set this to text/event-stream. (default: application/json) [application/json, text/event-stream]
  Current value: application/json

## Response Schema
- links (object, optional)
  - self (string, required)
  - prev (string, optional)
  - next (string, optional)
- headers (unknown, optional)
- data (array
  - id (string, required)
  - status (string, required)
  - chain_id (integer, required)
  - address (string, required)
  - value (string | integer, optional)
  - gas_limit (integer, optional)
  - inputs (array of any, optional)
  - steps (any, optional)
  - created_at (string, required)
  - updated_at (string, required)
  - tx_hash (string, optional)
  - execution_mode (string, optional)
  - owner_address (string, optional)
  - plugs_hash (string, optional)
  - scheduler_status (string, optional)
  - last_error (string, optional)
  - verdict (string, optional)
  - failing_condition (integer, optional)
  - last_simmed_block (integer, optional), optional)

## Example Request
GET https://api.plug.to/address/0x62180042606624f02d8a130da8a3171e9b33894d/transaction/

Get context

Create transaction

Back