Tournament results & verification

Tournament outcome reads, verification evidence, public result links, and exports.

Get tournament results

GET

https://api.pokerworks.io

/api/v1/management/tournaments/{tournamentId}/results

Read projection-backed tournament results

Get tournament results › path Parameters

tournamentId

string · required

Tournament identifier.

Get tournament results › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Get tournament results › Responses

TournamentResults

apiVersion

string · enum · required

Enum values:

2026-06-03

environment

string · enum · required

Enum values:

test

live

object · required

livemode

boolean · required

object

string · enum · required

Enum values:

developer_tournament_results

object[] · required

object · required

object

GET/api/v1/management/tournaments/{tournamentId}/results

curl https://api.pokerworks.io/api/v1/management/tournaments/:tournamentId/results \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "apiVersion": "2026-06-03",
  "environment": "test",
  "evidence": {
    "fairness": {
      "description": "description",
      "status": "available"
    },
    "replay": {
      "status": "available",
      "url": "https://www.example.com/path/to/resource"
    },
    "resultProjection": {
      "authority": "TournamentResultsProjectionService",
      "generatedAt": "2024-08-25T15:00:00Z",
      "projectionSequence": 0.1,
      "readSurface": "platform.tournament.results",
      "status": "available"
    }
  },
  "integrity": {
    "botsAllowed": true,
    "declaredBotSeats": {
      "count": 0,
      "present": true
    },
    "supportEvidence": {
      "trustModePolicyRef": "docs/architecture/developer-integrity-rules-and-trust-modes.md"
    },
    "trustMode": "human_only"
  },
  "livemode": true,
  "object": "developer_tournament_results",
  "payoutSummary": {
    "kind": "play_chips",
    "paidPlaces": 0,
    "totalAmount": 0
  },
  "standings": [
    {
      "bountyWon": 0,
      "displayName": "displayName",
      "finalChips": 0,
      "knockouts": 0,
      "payout": {
        "amount": 0,
        "kind": "play_chips"
      },
      "publicParticipantId": "publicParticipantId",
      "rank": 1
    }
  ],
  "support": {
    "projectId": "projectId",
    "requestId": "requestId",
    "webhookDeliveryId": "webhookDeliveryId",
    "webhookEventId": "webhookEventId"
  },
  "tournament": {
    "completedAt": "2024-08-25T15:00:00Z",
    "displayName": "displayName",
    "id": "id",
    "productKey": "productKey",
    "status": "completed",
    "visibility": "invite"
  },
  "winner": {
    "displayName": "displayName",
    "publicParticipantId": "publicParticipantId",
    "rank": 1
  }
}

json

application/json

Export tournament results proof

GET

https://api.pokerworks.io

/api/v1/management/tournaments/{tournamentId}/results/export

Export a tamper-evident tournament results proof envelope

Export tournament results proof › path Parameters

tournamentId

string · required

Tournament identifier.

Export tournament results proof › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Export tournament results proof › Responses

TournamentResultsExport

apiVersion

string · enum · required

Enum values:

2026-06-03

object · required

generatedAt

string · date-time · required

object

string · enum · required

Enum values:

developer_tournament_results_export

privacyTier

string · enum · required

Enum values:

management

public

resultProofId

string · pattern: ^rpf_[A-Za-z0-9_-]{2… · required

object · required

schemaVersion

string · enum · required

Enum values:

2026-06-08.tournament-results-export.v1

object · required

object

GET/api/v1/management/tournaments/{tournamentId}/results/export

curl https://api.pokerworks.io/api/v1/management/tournaments/:tournamentId/results/export \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "apiVersion": "2026-06-03",
  "canonicalization": {
    "algorithm": "json_stable_stringify",
    "digestInput": "envelope_without_verification",
    "version": "2026-06-08.tournament-results-export.v1"
  },
  "generatedAt": "2024-08-25T15:00:00Z",
  "object": "developer_tournament_results_export",
  "privacyTier": "management",
  "resultProofId": "resultProofId",
  "results": {
    "apiVersion": "2026-06-03",
    "environment": "test",
    "evidence": {
      "fairness": {
        "description": "description",
        "status": "available"
      },
      "replay": {
        "status": "available",
        "url": "https://www.example.com/path/to/resource"
      },
      "resultProjection": {
        "authority": "TournamentResultsProjectionService",
        "generatedAt": "2024-08-25T15:00:00Z",
        "projectionSequence": 0.1,
        "readSurface": "platform.tournament.results",
        "status": "available"
      }
    },
    "integrity": {
      "botsAllowed": true,
      "declaredBotSeats": {
        "count": 0,
        "present": true
      },
      "supportEvidence": {
        "trustModePolicyRef": "docs/architecture/developer-integrity-rules-and-trust-modes.md"
      },
      "trustMode": "human_only"
    },
    "livemode": true,
    "object": "developer_tournament_results",
    "payoutSummary": {
      "kind": "play_chips",
      "paidPlaces": 0,
      "totalAmount": 0
    },
    "standings": [
      {
        "bountyWon": 0,
        "displayName": "displayName",
        "finalChips": 0,
        "knockouts": 0,
        "payout": {
          "amount": 0,
          "kind": "play_chips"
        },
        "publicParticipantId": "publicParticipantId",
        "rank": 1
      }
    ],
    "support": {
      "projectId": "projectId",
      "requestId": "requestId",
      "webhookDeliveryId": "webhookDeliveryId",
      "webhookEventId": "webhookEventId"
    },
    "tournament": {
      "completedAt": "2024-08-25T15:00:00Z",
      "displayName": "displayName",
      "id": "id",
      "productKey": "productKey",
      "status": "completed",
      "visibility": "invite"
    },
    "winner": {
      "displayName": "displayName",
      "publicParticipantId": "publicParticipantId",
      "rank": 1
    }
  },
  "schemaVersion": "2026-06-08.tournament-results-export.v1",
  "verification": {
    "digest": {
      "algorithm": "sha256",
      "encoding": "base64url",
      "value": "value"
    },
    "method": "sha256_digest",
    "signature": {},
    "verifierKeyRef": {}
  },
  "webhookCorrelation": {
    "deliveryId": "deliveryId",
    "eventId": "eventId"
  }
}

json

application/json

Get public tournament results

GET

https://api.pokerworks.io

/api/v1/public/tournaments/{tournamentId}/results

Read public tournament results

Get public tournament results › path Parameters

tournamentId

string · required

Tournament identifier.

Get public tournament results › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Get public tournament results › Responses

TournamentResults

apiVersion

string · enum · required

Enum values:

2026-06-03

environment

string · enum · required

Enum values:

test

live

object · required

livemode

boolean · required

object

string · enum · required

Enum values:

developer_tournament_results

object[] · required

object · required

object

GET/api/v1/public/tournaments/{tournamentId}/results

curl https://api.pokerworks.io/api/v1/public/tournaments/:tournamentId/results

Example Responses

{
  "apiVersion": "2026-06-03",
  "environment": "test",
  "evidence": {
    "fairness": {
      "description": "description",
      "status": "available"
    },
    "replay": {
      "status": "available",
      "url": "https://www.example.com/path/to/resource"
    },
    "resultProjection": {
      "authority": "TournamentResultsProjectionService",
      "generatedAt": "2024-08-25T15:00:00Z",
      "projectionSequence": 0.1,
      "readSurface": "platform.tournament.results",
      "status": "available"
    }
  },
  "integrity": {
    "botsAllowed": true,
    "declaredBotSeats": {
      "count": 0,
      "present": true
    },
    "supportEvidence": {
      "trustModePolicyRef": "docs/architecture/developer-integrity-rules-and-trust-modes.md"
    },
    "trustMode": "human_only"
  },
  "livemode": true,
  "object": "developer_tournament_results",
  "payoutSummary": {
    "kind": "play_chips",
    "paidPlaces": 0,
    "totalAmount": 0
  },
  "standings": [
    {
      "bountyWon": 0,
      "displayName": "displayName",
      "finalChips": 0,
      "knockouts": 0,
      "payout": {
        "amount": 0,
        "kind": "play_chips"
      },
      "publicParticipantId": "publicParticipantId",
      "rank": 1
    }
  ],
  "support": {
    "projectId": "projectId",
    "requestId": "requestId",
    "webhookDeliveryId": "webhookDeliveryId",
    "webhookEventId": "webhookEventId"
  },
  "tournament": {
    "completedAt": "2024-08-25T15:00:00Z",
    "displayName": "displayName",
    "id": "id",
    "productKey": "productKey",
    "status": "completed",
    "visibility": "invite"
  },
  "winner": {
    "displayName": "displayName",
    "publicParticipantId": "publicParticipantId",
    "rank": 1
  }
}

json

application/json

Export public tournament results proof

GET

https://api.pokerworks.io

/api/v1/public/tournaments/{tournamentId}/results/export

Export a public tournament results proof envelope

Export public tournament results proof › path Parameters

tournamentId

string · required

Tournament identifier.

Export public tournament results proof › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Export public tournament results proof › Responses

TournamentResultsExport

apiVersion

string · enum · required

Enum values:

2026-06-03

object · required

generatedAt

string · date-time · required

object

string · enum · required

Enum values:

developer_tournament_results_export

privacyTier

string · enum · required

Enum values:

management

public

resultProofId

string · pattern: ^rpf_[A-Za-z0-9_-]{2… · required

object · required

schemaVersion

string · enum · required

Enum values:

2026-06-08.tournament-results-export.v1

object · required

object

GET/api/v1/public/tournaments/{tournamentId}/results/export

curl https://api.pokerworks.io/api/v1/public/tournaments/:tournamentId/results/export

Example Responses

{
  "apiVersion": "2026-06-03",
  "canonicalization": {
    "algorithm": "json_stable_stringify",
    "digestInput": "envelope_without_verification",
    "version": "2026-06-08.tournament-results-export.v1"
  },
  "generatedAt": "2024-08-25T15:00:00Z",
  "object": "developer_tournament_results_export",
  "privacyTier": "management",
  "resultProofId": "resultProofId",
  "results": {
    "apiVersion": "2026-06-03",
    "environment": "test",
    "evidence": {
      "fairness": {
        "description": "description",
        "status": "available"
      },
      "replay": {
        "status": "available",
        "url": "https://www.example.com/path/to/resource"
      },
      "resultProjection": {
        "authority": "TournamentResultsProjectionService",
        "generatedAt": "2024-08-25T15:00:00Z",
        "projectionSequence": 0.1,
        "readSurface": "platform.tournament.results",
        "status": "available"
      }
    },
    "integrity": {
      "botsAllowed": true,
      "declaredBotSeats": {
        "count": 0,
        "present": true
      },
      "supportEvidence": {
        "trustModePolicyRef": "docs/architecture/developer-integrity-rules-and-trust-modes.md"
      },
      "trustMode": "human_only"
    },
    "livemode": true,
    "object": "developer_tournament_results",
    "payoutSummary": {
      "kind": "play_chips",
      "paidPlaces": 0,
      "totalAmount": 0
    },
    "standings": [
      {
        "bountyWon": 0,
        "displayName": "displayName",
        "finalChips": 0,
        "knockouts": 0,
        "payout": {
          "amount": 0,
          "kind": "play_chips"
        },
        "publicParticipantId": "publicParticipantId",
        "rank": 1
      }
    ],
    "support": {
      "projectId": "projectId",
      "requestId": "requestId",
      "webhookDeliveryId": "webhookDeliveryId",
      "webhookEventId": "webhookEventId"
    },
    "tournament": {
      "completedAt": "2024-08-25T15:00:00Z",
      "displayName": "displayName",
      "id": "id",
      "productKey": "productKey",
      "status": "completed",
      "visibility": "invite"
    },
    "winner": {
      "displayName": "displayName",
      "publicParticipantId": "publicParticipantId",
      "rank": 1
    }
  },
  "schemaVersion": "2026-06-08.tournament-results-export.v1",
  "verification": {
    "digest": {
      "algorithm": "sha256",
      "encoding": "base64url",
      "value": "value"
    },
    "method": "sha256_digest",
    "signature": {},
    "verifierKeyRef": {}
  },
  "webhookCorrelation": {
    "deliveryId": "deliveryId",
    "eventId": "eventId"
  }
}

json

application/json

Verify tournament result export

POST

https://api.pokerworks.io

/api/v1/public/tournament-results/verify

Checks a saved result/proof export envelope without requiring a live management token. The verifier checks the envelope schema, canonicalization metadata, SHA-256 digest consistency, deterministic resultProofId, tournament completion summary, integrity summary, and projection evidence. It does not refetch live game state or authenticate unsigned exports.

Verify tournament result export › Request Body

VerifyResultProofExportRequest

envelope

required

Verify tournament result export › Responses

VerifyResultProofExportResponse

apiVersion

string · enum · required

Enum values:

2026-06-03

object[] · required

envelopeConsistent

boolean · required

object[] · required

object

string · enum · required

Enum values:

developer_tournament_result_proof_verification

status

string · enum · required

Enum values:

consistent

invalid

unsupported

summary

object | null · required

verifiedAt

string · date-time · required

POST/api/v1/public/tournament-results/verify

curl https://api.pokerworks.io/api/v1/public/tournament-results/verify \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "envelope": {}
}'

Example Request Body

{
  "envelope": {}
}

json

Example Responses

{
  "apiVersion": "2026-06-03",
  "checks": [
    {
      "message": "message",
      "name": "schema_version",
      "status": "passed"
    }
  ],
  "envelopeConsistent": true,
  "errors": [
    {
      "code": "DIGEST_MISMATCH",
      "message": "message",
      "path": "path"
    }
  ],
  "object": "developer_tournament_result_proof_verification",
  "status": "consistent",
  "summary": {
    "authenticity": {
      "status": "not_signed"
    },
    "digest": {
      "algorithm": "sha256",
      "encoding": "base64url",
      "value": "value"
    },
    "evidence": {
      "fairness": {
        "description": "description",
        "status": "available"
      },
      "replay": {
        "status": "available"
      },
      "resultProjection": {
        "authority": "TournamentResultsProjectionService",
        "generatedAt": "2024-08-25T15:00:00Z",
        "projectionSequence": 0.1,
        "readSurface": "platform.tournament.results",
        "status": "available"
      }
    },
    "generatedAt": "2024-08-25T15:00:00Z",
    "integrity": {
      "botsAllowed": true,
      "declaredBotSeats": {
        "count": 0,
        "present": true
      },
      "supportEvidence": {
        "trustModePolicyRef": "docs/architecture/developer-integrity-rules-and-trust-modes.md"
      },
      "trustMode": "human_only"
    },
    "privacyTier": "management",
    "resultProofId": "resultProofId",
    "schemaVersion": "2026-06-08.tournament-results-export.v1",
    "tournament": {
      "completedAt": "2024-08-25T15:00:00Z",
      "displayName": "displayName",
      "id": "id",
      "status": "completed",
      "visibility": "invite"
    },
    "verification": {
      "method": "sha256_digest",
      "signaturePresent": true,
      "verifierKeyRef": {}
    }
  },
  "verifiedAt": "2024-08-25T15:00:00Z"
}

json

application/json

Tournaments Webhooks

Get tournament results

GET

https://api.pokerworks.io

/api/v1/management/tournaments/{tournamentId}/results

Read projection-backed tournament results

Get tournament results › path Parameters

tournamentId

string · required

Tournament identifier.

Get tournament results › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Get tournament results › Responses

TournamentResults

apiVersion

string · enum · required

Enum values:

2026-06-03

environment

string · enum · required

Enum values:

test

live

object · required

livemode

boolean · required

object

string · enum · required

Enum values:

developer_tournament_results

object[] · required

object · required

object

Export tournament results proof

GET

https://api.pokerworks.io

/api/v1/management/tournaments/{tournamentId}/results/export

Export a tamper-evident tournament results proof envelope

Export tournament results proof › path Parameters

tournamentId

string · required

Tournament identifier.

Export tournament results proof › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Export tournament results proof › Responses

TournamentResultsExport

apiVersion

string · enum · required

Enum values:

2026-06-03

object · required

generatedAt

string · date-time · required

object

string · enum · required

Enum values:

developer_tournament_results_export

privacyTier

string · enum · required

Enum values:

management

public

resultProofId

string · pattern: ^rpf_[A-Za-z0-9_-]{2… · required

object · required

schemaVersion

string · enum · required

Enum values:

2026-06-08.tournament-results-export.v1

object · required

object

Get public tournament results

GET

https://api.pokerworks.io

/api/v1/public/tournaments/{tournamentId}/results

Read public tournament results

Get public tournament results › path Parameters

tournamentId

string · required

Tournament identifier.

Get public tournament results › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Get public tournament results › Responses

TournamentResults

apiVersion

string · enum · required

Enum values:

2026-06-03

environment

string · enum · required

Enum values:

test

live

object · required

livemode

boolean · required

object

string · enum · required

Enum values:

developer_tournament_results

object[] · required

object · required

object

Export public tournament results proof

GET

https://api.pokerworks.io

/api/v1/public/tournaments/{tournamentId}/results/export

Export a public tournament results proof envelope

Export public tournament results proof › path Parameters

tournamentId

string · required

Tournament identifier.

Export public tournament results proof › Headers

X-Projection-Replay-Sequence

integer · min: 0

Optional event-store replay-sequence freshness barrier. Returns 503 PROJECTION_LAG until every contributing projection has processed this replay sequence.

Export public tournament results proof › Responses

TournamentResultsExport

apiVersion

string · enum · required

Enum values:

2026-06-03

object · required

generatedAt

string · date-time · required

object

string · enum · required

Enum values:

developer_tournament_results_export

privacyTier

string · enum · required

Enum values:

management

public

resultProofId

string · pattern: ^rpf_[A-Za-z0-9_-]{2… · required

object · required

schemaVersion

string · enum · required

Enum values:

2026-06-08.tournament-results-export.v1

object · required

object

Verify tournament result export

POST

https://api.pokerworks.io

/api/v1/public/tournament-results/verify

Verify tournament result export › Request Body

VerifyResultProofExportRequest

envelope

required

Verify tournament result export › Responses

VerifyResultProofExportResponse

apiVersion

string · enum · required

Enum values:

2026-06-03

object[] · required

envelopeConsistent

boolean · required

object[] · required

object

string · enum · required

Enum values:

developer_tournament_result_proof_verification

status

string · enum · required

Enum values:

consistent

invalid

unsupported

summary

object | null · required

verifiedAt

string · date-time · required