List batches

Retrieve a paginated list of transaction batches processed by the sequencer. This endpoint provides access to batch information including status, signatures, and associated actions. Batches can be filtered by various criteria including action ID, batch ID, hash, status, signer, and creation timestamps.

GET
/batches

Query Parameters

id?string

Filter resources by their unique identifier

org_id?string

Filter resources by the organization they belong to

autocomplete?string

Search term for autocomplete functionality

limit?integer

How many items to return at one time (max 100)

Formatint64
next?string

Pagination token for retrieving the next page of results

order?string

Sort order for the results (ascending or descending)

Value in"asc" | "desc"
sortBy?string

Field name to sort the results by

sequence?integer

Filter batches by sequencer ID

Formatuint64
action_id?string

Filter batches by action ID

batch_id?string

Filter batches by batch ID

hash?string

Filter batches by transaction hash

status?string

Filter batches by processing status

signer?string

Filter batches by signer address

when_created[$gt]?string

Filter batches created after this date and time

Formatdate-time
when_created[$lt]?string

Filter batches created before this date and time

Formatdate-time
when_created[$gte]?string

Filter batches created on or after this date and time

Formatdate-time
when_created[$lte]?string

Filter batches created on or before this date and time

Formatdate-time
when_modified[$gt]?string

Filter batches modified after this date and time

Formatdate-time
when_modified[$lt]?string

Filter batches modified before this date and time

Formatdate-time
when_modified[$gte]?string

Filter batches modified on or after this date and time

Formatdate-time
when_modified[$lte]?string

Filter batches modified on or before this date and time

Formatdate-time

Response Body

application/json

application/json

application/json

curl -X GET "https://api-testnet.dual.network/batches"
{
  "batches": [
    {
      "id": "string",
      "sequence": 0,
      "hash": "string",
      "prev_hash": "string",
      "integrity_root": "string",
      "prev_integrity_root": "string",
      "sender": "string",
      "l2_tx_hash": "string",
      "l2_finalization_tx_hash": "string",
      "commitment": "string",
      "actions_hash": "string",
      "affected_actions": [
        {
          "id": "string",
          "hash": "string",
          "name": "string",
          "alias": "string"
        }
      ],
      "actions_count": 0,
      "total_fee": "string",
      "total_fee_wei": "string",
      "version": 0,
      "ipfs_url": "string",
      "status": "building",
      "proof": {
        "type": "string",
        "value": "string",
        "public_values": "string",
        "vkey": "string",
        "message": "string"
      },
      "proof_id": "string",
      "error": "string",
      "challenge_window_end": "2019-08-24T14:15:22Z",
      "when_completed": "2019-08-24T14:15:22Z",
      "when_modified": "2019-08-24T14:15:22Z",
      "when_created": "2019-08-24T14:15:22Z"
    }
  ],
  "next": "string"
}
{
  "code": 0,
  "message": "string",
  "details": {}
}
{
  "code": 0,
  "message": "string",
  "details": {}
}