---
title: "Challenge an attestation"
method: POST
path: "/v1/oracle/attestations/{id}/challenge"
tags: ["Oracle"]
---

# Challenge an attestation

`POST /v1/oracle/attestations/{id}/challenge`

## Request

- Base URL: `https://origin.predictasiax.com`
- URL: `https://origin.predictasiax.com/v1/oracle/attestations/{id}/challenge`
- Auth: API key in header `X-API-Key`

Requires an api-key with the oracle:write scope and a funded PAX bond. Opens a dispute within the liveness window.

## Path parameters

- `id` string, required

## Request body

- ChallengeAttestationRequest
  - `disputer_outcome` string, required: The outcome the disputer asserts instead.
  - `evidence_urls` string[]

## Response `200`

Dispute recorded; disputer bond locked.

- OracleAttestation: An optimistic-oracle attestation and its dispute lifecycle.
  - `id` string
  - `market_id` string
  - `proposer_user_id` string
  - `provider_id` string, nullable
  - `proposed_outcome` string
  - `evidence_urls` string[]
  - `bond_pax` string: Decimal string with up to 6 fractional digits
  - `state` 'proposed' | 'disputed' | 'resolved'
  - `liveness_expires_at` string, date-time, nullable
  - `disputer_user_id` string, nullable
  - `disputer_outcome` string, nullable
  - `disputer_evidence_urls` string[], nullable
  - `disputer_bond_pax` string, nullable
  - `disputed_at` string, date-time, nullable
  - `resolved_outcome` string, nullable
  - `proposer_won` boolean, nullable
  - `reward_pax` string: Decimal string with up to 6 fractional digits
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `finalized_at` string, date-time, nullable

## Other responses

- `400`: Empty outcome, or attempt to dispute your own attestation.
- `402`: Insufficient available PAX bond.
- `403`: Key lacks the oracle:write scope.
- `409`: Attestation not open for dispute, or liveness window closed.

---

[API](https://skmtc.dev/predictasiax/apis/predictasiax-network-api.md) · [All operations](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/predictasiax/apis/predictasiax-network-api/revisions/c2ed1a03ce79?raw)
