List requests
GET {{baseUrl}}/requests
Retrieve statuses of all current and past asynchronous operations.
Running
and Pending
asynchronous operations execute for up to 30 days.
Each listed async operation features a trigger
object, including the invocation details of a request as well as the computedConfig
documenting the automatically determined settings of the request based on the default behavior of the requested endpoint's configuration headers. In some cases, a failed request ID might lack some or all information in the computedConfig
object.
The content
objects represents the last known state of the request ID.
Use available query parameters to filter down the results further. Many queries can be combined and stacked several times.
The default pagination is cursor based, as such you need to use the nextPageToken
returned to scroll to the next result page.
If a pageToken
is set the offset
parameter is ignored. In a case where you want to switch pagination techniques, you need to
set the offset
parameter instead.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
pageToken | string | (Optional query) The pageToken parameter identifies a specific page in the result set that should be returned. | |
In an API response, the nextPageToken property identifies other pages that could be retrieved. | |||
offset | number | (Optional query) Skip number of results. |
Accepts a positive integer between 0
and 9999
.
Example: 100
|
| limit
| number | | (Optional query) Limit the number of results.
Accepts a positive integer between 1
and 100
. Default: 0
Example: 20
|
| sort
| string | | (Optional query) Change the sorting order of requests.
Defaults to newest requests first. |
| status
| string | | (Optional query) Filter for given operation status.
Accepts: completed
,running
, pending
, failed
.
Multiple queries can be stacked via the OR boolean operator (?status=running&status=pending
). |
| id
| string | | (Optional query) Filter for specific async request IDs.
Accepts valid ID values.
Multiple queries can be stacked via the OR boolean operator (?id=123&id=abc
). |
| createdAfter
| string | | (Optional query) Filter results created after given UTC date.
Accepts ISO-8601-compliant strings as well as epoch timestamps
Examples: 2021-12-17T03:24:00
, 2021-12-17
, 1640575440
|
| createdBefore
| string | | (Optional query) Filter results created before given UTC date.
Accepts ISO-8601-compliant strings as well as epoch timestamps
Examples: 2021-12-17T03:24:00
, 2021-12-17
, 1640575440
|
| updatedBefore
| string | | (Optional query) Filter results updated before given UTC date.
Accepts ISO-8601-compliant strings as well as epoch timestamps
Examples: 2021-12-17T03:24:00
, 2021-12-17
, 1640575440
|
| updatedAfter
| string | | (Optional query) Filter results updated after given UTC date.
Accepts ISO-8601-compliant strings as well as epoch timestamps
Examples: 2021-12-17T03:24:00
, 2021-12-17
, 1640575440
|
| httpStatusCode
| number | | (Optional query) Filter for given HTTP response status code.
Accepts: 200
, 202
, 500
.
Multiple queries can be stacked via the OR boolean operator (?httpStatusCode=200&httpStatusCode=202
). |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
tangany-version | number | (Required) Default header that directs the request towards desired Tangany Custody Api version (e.g 2 directs to Tangany Custody APi v2). |
Supports only major versions. |
| Accept
| string | | |
RESPONSES
status: OK
{"pageInfo":{"totalResults":42,"resultsPerPage":20},"items":[{"requestId":"b2f1bebc-32e2-407b-b2cd-d7b9d89904fe","trigger":{"url":"http://localhost:7071/api/eth/wallet/func-spec/send-async","headers":{"tangany-network":"sepolia","tangany-tx-confirmations":"secure","tangany-use-gas-tank":"true"},"body":{"list":[{"wallet":"my-wallet","amount":"0.00156"},{"wallet":"my-wallet","amount":"0.00156"}]},"computedConfig":{"from":"0x9C2E011c0CE0d75c2B62B9C5A0Ba0a7456593803","to":"0x546f69Fc836D781dB24e4F8A250Fc26557E12679","nonce":197,"transactionType":2,"gasLimit":"21000","value":"0.000457","data":"0x","maxFeePerGas":"33271984188","maxPriorityFeePerGas":"2500000000"}},"content":{"status":"Completed","stage":"FailedWalletRecovery","created":"2022-09-12T06:18:08.683Z","updated":"1981-08-05T15:09:31.529Z","output":{"hash":7.205679926776284e+76,"blockNr":7675874,"data":15731623,"status":"confirmed"}}},{"requestId":"b2f1bebc-32e2-407b-b2cd-d7b9d89904fe","trigger":{"url":"http://localhost:7071/api/eth/wallet/func-spec/send-async","headers":{"tangany-network":"sepolia","tangany-tx-confirmations":"secure","tangany-use-gas-tank":"true"},"body":{"list":[{"wallet":"my-wallet","amount":"0.00156"},{"wallet":"my-wallet","amount":"0.00156"}]},"computedConfig":{"from":"0x9C2E011c0CE0d75c2B62B9C5A0Ba0a7456593803","to":"0x546f69Fc836D781dB24e4F8A250Fc26557E12679","nonce":197,"transactionType":2,"gasLimit":"21000","value":"0.000457","data":"0x","maxFeePerGas":"33271984188","maxPriorityFeePerGas":"2500000000"}},"content":{"status":"Completed","stage":"RecoveringWallet","created":"2022-08-10T03:49:00.296Z","updated":"1956-02-02T11:12:06.637Z","output":{"hash":7.205679926776284e+76,"blockNr":7675874,"data":15731623,"status":"confirmed"}}}],"nextPageToken":"NDg2ODg="}