Skip to main content
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": "<string>",
    "blockNumberGte": "<string>",
    "blockNumberLte": "<string>",
    "id": "<string>",
    "initiator": "<string>",
    "targetIpId": "<string>"
  }
}
'
{
  "data": [
    {
      "arbitrationPolicy": "<string>",
      "blockNumber": "<string>",
      "counterEvidenceHash": "<string>",
      "currentTag": "<string>",
      "data": "<string>",
      "disputeTimestamp": "<string>",
      "evidenceHash": "<string>",
      "id": "<string>",
      "initiator": "<string>",
      "liveness": "<string>",
      "status": "<string>",
      "targetIpId": "<string>",
      "targetTag": "<string>",
      "transactionHash": "<string>",
      "blockTimestamp": "<string>",
      "deletedAt": "<string>",
      "logIndex": "<string>",
      "umaLink": "<string>"
    }
  ],
  "$schema": "<string>",
  "pagination": {
    "hasMore": true,
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.story.foundation/llms.txt

Use this file to discover all available pages before exploring further.

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>
read-only

A URL to the JSON Schema for this object.

Example:

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

​
pagination
object

Pagination metadata (v4 enhancement, not in v3)