> For the complete documentation index, see [llms.txt](https://docs.mimic.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mimic.fi/developers/api/executions.md).

# Executions

Trigger execution records

## GET /executions

> List executions

```json
{"openapi":"3.0.3","info":{"title":"Mimic Protocol API","version":"1.0.1"},"tags":[{"name":"Executions","description":"Trigger execution records"}],"servers":[{"url":"https://api-protocol.mimic.fi"}],"paths":{"/executions":{"get":{"summary":"List executions","operationId":"getExecutions","tags":["Executions"],"parameters":[{"name":"triggerSig","in":"query","description":"Filter by trigger signature","schema":{"type":"string"}},{"name":"createdAfter","in":"query","schema":{"$ref":"#/components/schemas/Timestamp"}},{"name":"createdBefore","in":"query","schema":{"$ref":"#/components/schemas/Timestamp"}},{"$ref":"#/components/parameters/OffsetParam"},{"$ref":"#/components/parameters/LimitParam"},{"$ref":"#/components/parameters/SortParam"}],"responses":{"200":{"description":"List of executions","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionResponse"}}}}}}}}},"components":{"schemas":{"Timestamp":{"type":"integer","description":"Unix timestamp in milliseconds."},"ExecutionResponse":{"description":"An execution record with relayer, status, fee, and validation details","allOf":[{"$ref":"#/components/schemas/ExecutionCreateRequest"},{"type":"object","required":["relayer","status","createdAt"],"properties":{"relayer":{"$ref":"#/components/schemas/Address"},"status":{"type":"string","enum":["pending","valid","invalid"]},"createdAt":{"type":"string","format":"date-time"},"logs":{"type":"array","items":{"type":"string"}},"fee":{"$ref":"#/components/schemas/ExecutionFee"},"solverFees":{"type":"array","items":{"$ref":"#/components/schemas/SolverFee"}},"validations":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionValidation"}}}}]},"ExecutionCreateRequest":{"type":"object","required":["triggerSig","triggerType","triggerData","hash","timestamp","fuelUsed","logs","inputs","outputs","signature","result"],"properties":{"triggerSig":{"$ref":"#/components/schemas/Signature"},"triggerType":{"$ref":"#/components/schemas/TriggerType"},"triggerData":{"allOf":[{"$ref":"#/components/schemas/HexString"}],"description":"ABI-encoded trigger-specific execution data"},"hash":{"$ref":"#/components/schemas/HexString"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"fuelUsed":{"type":"integer","minimum":0},"logs":{"type":"array","items":{"type":"string"}},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/OracleResponse"}},"outputs":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionIntent"}},"signature":{"allOf":[{"$ref":"#/components/schemas/Signature"}],"description":"Relayer signature over the execution"},"result":{"type":"string","enum":["succeeded","failed"]}}},"Signature":{"type":"string","description":"A 65-byte hex-encoded ECDSA signature (130 hex chars + 0x prefix)."},"TriggerType":{"type":"integer","enum":[0,1,2],"description":"Trigger execution mode:\n- `0` — Cron: fires on a recurring cron schedule\n- `1` — Event: fires on an on-chain event\n- `2` — Once: fires exactly once at a specific time\n"},"HexString":{"type":"string","description":"An arbitrary 0x-prefixed hex string."},"OracleResponse":{"type":"object","description":"An oracle-signed query response. The shape of `query.params` and `result.value` depends on `query.name` (TokenPriceQuery, EvmCallQuery, SvmAccountsInfoQuery, RelevantTokensQuery, SubgraphQuery).\n","required":["signature","query","result"],"properties":{"signature":{"$ref":"#/components/schemas/Signature"},"query":{"type":"object","required":["name","hash","params"],"properties":{"name":{"type":"string","enum":["TokenPriceQuery","EvmCallQuery","SvmAccountsInfoQuery","RelevantTokensQuery","SubgraphQuery"]},"hash":{"$ref":"#/components/schemas/HexString"},"params":{"type":"object","additionalProperties":true}}},"result":{"type":"object","required":["value"],"properties":{"value":{}}}}},"ExecutionIntent":{"description":"An intent output produced by an execution","allOf":[{"$ref":"#/components/schemas/Intent"},{"type":"object","required":["hash"],"properties":{"hash":{"$ref":"#/components/schemas/HexString"}}}]},"Intent":{"type":"object","required":["op","user","settler","nonce","deadline","data","maxFees","events","configSig","minValidations"],"properties":{"op":{"$ref":"#/components/schemas/OpType"},"user":{"$ref":"#/components/schemas/Address"},"settler":{"allOf":[{"$ref":"#/components/schemas/Address"}],"description":"Address of the settler contract that will settle this intent"},"nonce":{"$ref":"#/components/schemas/HexString"},"deadline":{"allOf":[{"$ref":"#/components/schemas/BigInteger"}],"description":"Unix epoch in seconds after which the intent expires"},"data":{"allOf":[{"$ref":"#/components/schemas/HexString"}],"description":"ABI-encoded operation-specific data"},"maxFees":{"type":"array","items":{"$ref":"#/components/schemas/MaxFee"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/IntentEvent"}},"configSig":{"$ref":"#/components/schemas/Signature"},"minValidations":{"type":"number","minimum":0}}},"OpType":{"type":"integer","enum":[0,1,2,3],"description":"Intent operation type:\n- `0` — Swap\n- `1` — Transfer\n- `2` — EvmCall\n- `3` — SvmCall\n"},"Address":{"type":"string","description":"A valid EVM (0x-prefixed hex) address."},"BigInteger":{"type":"string","description":"A non-negative integer represented as a decimal string."},"MaxFee":{"type":"object","required":["token","amount"],"properties":{"token":{"$ref":"#/components/schemas/Address"},"amount":{"$ref":"#/components/schemas/BigInteger"}}},"IntentEvent":{"type":"object","required":["topic","data"],"properties":{"topic":{"$ref":"#/components/schemas/HexString"},"data":{"$ref":"#/components/schemas/HexString"}}},"ExecutionFee":{"type":"object","required":["trigger","relayer","oracles","validators","intents","protocol","total"],"properties":{"trigger":{"$ref":"#/components/schemas/BigInteger"},"relayer":{"$ref":"#/components/schemas/BigInteger"},"oracles":{"$ref":"#/components/schemas/BigInteger"},"validators":{"$ref":"#/components/schemas/BigInteger"},"intents":{"$ref":"#/components/schemas/BigInteger"},"protocol":{"$ref":"#/components/schemas/BigInteger"},"total":{"$ref":"#/components/schemas/BigInteger"}}},"SolverFee":{"type":"object","required":["address","amount"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"amount":{"$ref":"#/components/schemas/BigInteger"}}},"ExecutionValidation":{"type":"object","required":["signature","succeeded"],"properties":{"signature":{"$ref":"#/components/schemas/Signature"},"succeeded":{"type":"boolean"},"description":{"type":"string"}}}},"parameters":{"OffsetParam":{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},"LimitParam":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},"SortParam":{"name":"sort","in":"query","description":"Sort order: `1` for ascending, `-1` for descending","schema":{"type":"integer","enum":[1,-1],"default":-1}}}}}
```

## GET /executions/{hash}

> Get an execution by hash

```json
{"openapi":"3.0.3","info":{"title":"Mimic Protocol API","version":"1.0.1"},"tags":[{"name":"Executions","description":"Trigger execution records"}],"servers":[{"url":"https://api-protocol.mimic.fi"}],"paths":{"/executions/{hash}":{"get":{"summary":"Get an execution by hash","operationId":"getExecution","tags":["Executions"],"parameters":[{"name":"hash","in":"path","required":true,"schema":{"$ref":"#/components/schemas/HexString"}}],"responses":{"200":{"description":"Execution details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"schemas":{"HexString":{"type":"string","description":"An arbitrary 0x-prefixed hex string."},"ExecutionResponse":{"description":"An execution record with relayer, status, fee, and validation details","allOf":[{"$ref":"#/components/schemas/ExecutionCreateRequest"},{"type":"object","required":["relayer","status","createdAt"],"properties":{"relayer":{"$ref":"#/components/schemas/Address"},"status":{"type":"string","enum":["pending","valid","invalid"]},"createdAt":{"type":"string","format":"date-time"},"logs":{"type":"array","items":{"type":"string"}},"fee":{"$ref":"#/components/schemas/ExecutionFee"},"solverFees":{"type":"array","items":{"$ref":"#/components/schemas/SolverFee"}},"validations":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionValidation"}}}}]},"ExecutionCreateRequest":{"type":"object","required":["triggerSig","triggerType","triggerData","hash","timestamp","fuelUsed","logs","inputs","outputs","signature","result"],"properties":{"triggerSig":{"$ref":"#/components/schemas/Signature"},"triggerType":{"$ref":"#/components/schemas/TriggerType"},"triggerData":{"allOf":[{"$ref":"#/components/schemas/HexString"}],"description":"ABI-encoded trigger-specific execution data"},"hash":{"$ref":"#/components/schemas/HexString"},"timestamp":{"$ref":"#/components/schemas/Timestamp"},"fuelUsed":{"type":"integer","minimum":0},"logs":{"type":"array","items":{"type":"string"}},"inputs":{"type":"array","items":{"$ref":"#/components/schemas/OracleResponse"}},"outputs":{"type":"array","items":{"$ref":"#/components/schemas/ExecutionIntent"}},"signature":{"allOf":[{"$ref":"#/components/schemas/Signature"}],"description":"Relayer signature over the execution"},"result":{"type":"string","enum":["succeeded","failed"]}}},"Signature":{"type":"string","description":"A 65-byte hex-encoded ECDSA signature (130 hex chars + 0x prefix)."},"TriggerType":{"type":"integer","enum":[0,1,2],"description":"Trigger execution mode:\n- `0` — Cron: fires on a recurring cron schedule\n- `1` — Event: fires on an on-chain event\n- `2` — Once: fires exactly once at a specific time\n"},"Timestamp":{"type":"integer","description":"Unix timestamp in milliseconds."},"OracleResponse":{"type":"object","description":"An oracle-signed query response. The shape of `query.params` and `result.value` depends on `query.name` (TokenPriceQuery, EvmCallQuery, SvmAccountsInfoQuery, RelevantTokensQuery, SubgraphQuery).\n","required":["signature","query","result"],"properties":{"signature":{"$ref":"#/components/schemas/Signature"},"query":{"type":"object","required":["name","hash","params"],"properties":{"name":{"type":"string","enum":["TokenPriceQuery","EvmCallQuery","SvmAccountsInfoQuery","RelevantTokensQuery","SubgraphQuery"]},"hash":{"$ref":"#/components/schemas/HexString"},"params":{"type":"object","additionalProperties":true}}},"result":{"type":"object","required":["value"],"properties":{"value":{}}}}},"ExecutionIntent":{"description":"An intent output produced by an execution","allOf":[{"$ref":"#/components/schemas/Intent"},{"type":"object","required":["hash"],"properties":{"hash":{"$ref":"#/components/schemas/HexString"}}}]},"Intent":{"type":"object","required":["op","user","settler","nonce","deadline","data","maxFees","events","configSig","minValidations"],"properties":{"op":{"$ref":"#/components/schemas/OpType"},"user":{"$ref":"#/components/schemas/Address"},"settler":{"allOf":[{"$ref":"#/components/schemas/Address"}],"description":"Address of the settler contract that will settle this intent"},"nonce":{"$ref":"#/components/schemas/HexString"},"deadline":{"allOf":[{"$ref":"#/components/schemas/BigInteger"}],"description":"Unix epoch in seconds after which the intent expires"},"data":{"allOf":[{"$ref":"#/components/schemas/HexString"}],"description":"ABI-encoded operation-specific data"},"maxFees":{"type":"array","items":{"$ref":"#/components/schemas/MaxFee"}},"events":{"type":"array","items":{"$ref":"#/components/schemas/IntentEvent"}},"configSig":{"$ref":"#/components/schemas/Signature"},"minValidations":{"type":"number","minimum":0}}},"OpType":{"type":"integer","enum":[0,1,2,3],"description":"Intent operation type:\n- `0` — Swap\n- `1` — Transfer\n- `2` — EvmCall\n- `3` — SvmCall\n"},"Address":{"type":"string","description":"A valid EVM (0x-prefixed hex) address."},"BigInteger":{"type":"string","description":"A non-negative integer represented as a decimal string."},"MaxFee":{"type":"object","required":["token","amount"],"properties":{"token":{"$ref":"#/components/schemas/Address"},"amount":{"$ref":"#/components/schemas/BigInteger"}}},"IntentEvent":{"type":"object","required":["topic","data"],"properties":{"topic":{"$ref":"#/components/schemas/HexString"},"data":{"$ref":"#/components/schemas/HexString"}}},"ExecutionFee":{"type":"object","required":["trigger","relayer","oracles","validators","intents","protocol","total"],"properties":{"trigger":{"$ref":"#/components/schemas/BigInteger"},"relayer":{"$ref":"#/components/schemas/BigInteger"},"oracles":{"$ref":"#/components/schemas/BigInteger"},"validators":{"$ref":"#/components/schemas/BigInteger"},"intents":{"$ref":"#/components/schemas/BigInteger"},"protocol":{"$ref":"#/components/schemas/BigInteger"},"total":{"$ref":"#/components/schemas/BigInteger"}}},"SolverFee":{"type":"object","required":["address","amount"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"amount":{"$ref":"#/components/schemas/BigInteger"}}},"ExecutionValidation":{"type":"object","required":["signature","succeeded"],"properties":{"signature":{"$ref":"#/components/schemas/Signature"},"succeeded":{"type":"boolean"},"description":{"type":"string"}}},"Error":{"type":"object","properties":{"message":{"type":"string"}}}},"responses":{"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}
```