POST
/
disputes
List Disputes
curl --request POST \
  --url https://api.storyapis.com/api/v4/disputes \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "orderBy": "<string>",
  "orderDirection": "<string>",
  "pagination": {
    "limit": 100,
    "offset": 0
  },
  "where": {
    "blockNumber": "1500000",
    "blockNumberGte": "1000000",
    "blockNumberLte": "2000000",
    "id": "123",
    "initiator": "0xabcdef1234567890abcdef1234567890abcdef12",
    "targetIpId": "0x1234567890abcdef1234567890abcdef12345678"
  }
}'
{
  "$schema": "https://api.storyapis.com/api/v4/ListDisputesResponseHumaBody.json",
  "data": [
    {
      "arbitrationPolicy": "<string>",
      "blockNumber": "<string>",
      "blockTimestamp": "<string>",
      "counterEvidenceHash": "<string>",
      "currentTag": "<string>",
      "data": "<string>",
      "deletedAt": "<string>",
      "disputeTimestamp": "<string>",
      "evidenceHash": "<string>",
      "id": "<string>",
      "initiator": "<string>",
      "liveness": "<string>",
      "logIndex": "<string>",
      "status": "<string>",
      "targetIpId": "<string>",
      "targetTag": "<string>",
      "transactionHash": "<string>",
      "umaLink": "<string>"
    }
  ],
  "pagination": {
    "hasMore": true,
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

X-Api-Key
string
header
required

Body

application/json
orderBy
string

Field to order results by (must be blockNumber or empty)

orderDirection
string

Order direction for results (asc or desc)

pagination
object

Pagination configuration

where
object

Filter options for disputes

Response

OK

data
object[] | null
required

List of disputes

$schema
string<uri>

A URL to the JSON Schema for this object.

Examples:

"https://api.storyapis.com/api/v4/ListDisputesResponseHumaBody.json"

pagination
object

Pagination metadata (v4 enhancement, not in v3)