Result/proof reads

Result/proof reads turn a tournament.completed webhook into a complete outcome loop. The webhook tells your server that a tournament finished; the result/proof read gives your server the privacy-safe winner, standings, payout summary, replay status, and support evidence to announce or export the result.

Which key do I use?

pw_test_…Calculation API — Test calculation calls.

pw_live_…Calculation API — Live calculation calls.

pw_mgmt_…Automation & management — Service-account automation and management HTTP contracts. Never calculation calls.

When to use it

Use result/proof reads when your integration needs to say more than "a tournament ended":

post a Discord or Slack result announcement;
append standings to Google Sheets;
link a public result page after a hosted event;
keep support-safe evidence for a webhook delivery.

Do not use this surface for live gameplay decisions, raw player identity, private cards, hand transcripts, or bot/action automation.

Try it in test mode

Use the developer playground to trigger the full loop without waiting for a real tournament. The playground emits a frozen, synthetic tournament.completed fixture in your test environment, queues deliveries to active test webhook endpoints, and returns the same result/proof DTO your receiver will fetch from links.resultProof.href.

Create a service-account management token scoped to your test project with playground:write and tournament_result_proofs:read:

Code
curl https://api.pokerworks.io/api/v1/developer-api/management/playground/tournament-completion \
  -H "Authorization: Bearer pw_mgmt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "devproj_...",
    "fixture": "completed-six-max-nlhe-v1"
  }'

The response includes the playground tournament id, the queued webhook delivery summaries, the event envelope, and a result/proof object for the same synthetic tournament. The fixture uses obviously fake player display names and public participant ids; it never reads or exposes real player data.

Endpoints

The management read is the server-side recipe path:

Code
GET /api/v1/developer-api/management/tournaments/{tournamentId}/result-proof
Authorization: Bearer pw_mgmt_...

The token needs the tournament_result_proofs:read scope and must be allowed to read the owning project and environment.

The public read is the browser-safe permalink path for explicitly public results:

Code
GET /api/v1/developer-api/public/tournaments/{tournamentId}/result-proof

Unknown, private, cross-project, deleted, or unsupported tournaments return the same not-found shape to unauthenticated callers.

Webhook flow

For tournament.completed, prefer the discovery link in the webhook envelope:


Code
{
  "id": "evt_01JEXAMPLE",
  "type": "tournament.completed",
  "environment": "test",
  "data": {
    "tournamentId": "trn_01JEXAMPLE",
    "completedAt": "2026-06-03T20:42:00.000Z"
  },
  "links": {
    "resultProof": {
      "href": "/api/v1/developer-api/management/tournaments/trn_01JEXAMPLE/result-proof",
      "method": "GET"
    }
  }
}

Verify the webhook signature over the raw body first, reserve the event/delivery id for idempotency, then fetch links.resultProof.href with your server-side management token. Forward the verified PokerWorks-Event-Id and PokerWorks-Delivery-Id header values on the result/proof request so the response can echo them in support.webhookEventId and support.webhookDeliveryId.

Code
GET /api/v1/developer-api/management/tournaments/trn_01JEXAMPLE/result-proof
Authorization: Bearer pw_mgmt_...
PokerWorks-Event-Id: evt_01JEXAMPLE
PokerWorks-Delivery-Id: whdel_01JEXAMPLE

links.resultProof is optional for older deliveries and staged rollouts. If the link is absent, derive the management read from data.tournamentId:

Code
/api/v1/developer-api/management/tournaments/{tournamentId}/result-proof

Example response


Code
{
  "object": "developer_tournament_result_proof",
  "apiVersion": "2026-06-03",
  "environment": "test",
  "livemode": false,
  "tournament": {
    "id": "trn_01JEXAMPLE",
    "displayName": "Wednesday Home Game",
    "status": "completed",
    "completedAt": "2026-06-03T20:42:00.000Z",
    "visibility": "public",
    "productKey": "pokerdeck-club-demo"
  },
  "winner": {
    "rank": 1,
    "displayName": "Alice",
    "publicParticipantId": "pp_AliceResultDemo01"
  },
  "standings": [
    {
      "rank": 1,
      "displayName": "Alice",
      "publicParticipantId": "pp_AliceResultDemo01",
      "finalChips": 120000,
      "payout": {
        "kind": "play_chips",
        "amount": 5000
      },
      "knockouts": 2,
      "bountyWon": 750
    },
    {
      "rank": 2,
      "displayName": "Player 2",
      "publicParticipantId": "pp_PlayerTwoDemo001",
      "finalChips": 0
    }
  ],
  "payoutSummary": {
    "kind": "play_chips",
    "totalAmount": 5000,
    "paidPlaces": 1
  },
  "evidence": {
    "resultProjection": {
      "authority": "TournamentResultsProjectionService",
      "readSurface": "platform.tournament.results",
      "status": "available",
      "projectionSequence": 12345,
      "generatedAt": "2026-06-03T20:42:03.000Z"
    },
    "replay": {
      "status": "available",
      "url": "https://pokerdeck.io/j/ABC123/results"
    },
    "fairness": {
      "status": "summary_only",
      "description": "Hand-level proof status is available only through approved retained hand lookups."
    }
  },
  "support": {
    "requestId": "req_01JEXAMPLE",
    "webhookEventId": "evt_01JEXAMPLE",
    "webhookDeliveryId": "whdel_01JEXAMPLE",
    "projectId": "devproj_01JEXAMPLE",
    "sourceTournamentId": "trn_01JEXAMPLE"
  }
}

Privacy boundary

The response never includes raw PlayerId, account ids, email addresses, payment ids, private cards, deck order, proof secrets, management settings, or webhook endpoint secrets.

Display identity is limited to the approved tournament display name, a product-approved public alias, or a generated tournament-scoped label such as Player 2.

Support bundle

When asking for help with a result/proof read, include:

request id from the result/proof response;
webhook event id and delivery id, if the read came from a webhook;
project id and environment;
tournament id;
whether you used the management read or public read;
replay and fairness statuses from the evidence object.

Result/proof reads

Which key do I use?

pw_test_…Calculation API — Test calculation calls.

pw_live_…Calculation API — Live calculation calls.

pw_mgmt_…Automation & management — Service-account automation and management HTTP contracts. Never calculation calls.

When to use it

Use result/proof reads when your integration needs to say more than "a tournament ended":

post a Discord or Slack result announcement;
append standings to Google Sheets;
link a public result page after a hosted event;
keep support-safe evidence for a webhook delivery.

Do not use this surface for live gameplay decisions, raw player identity, private cards, hand transcripts, or bot/action automation.

Try it in test mode

Create a service-account management token scoped to your test project with playground:write and tournament_result_proofs:read:

Code
curl https://api.pokerworks.io/api/v1/developer-api/management/playground/tournament-completion \
  -H "Authorization: Bearer pw_mgmt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "devproj_...",
    "fixture": "completed-six-max-nlhe-v1"
  }'

Endpoints

The management read is the server-side recipe path:

Code
GET /api/v1/developer-api/management/tournaments/{tournamentId}/result-proof
Authorization: Bearer pw_mgmt_...

The token needs the tournament_result_proofs:read scope and must be allowed to read the owning project and environment.

The public read is the browser-safe permalink path for explicitly public results:

Code
GET /api/v1/developer-api/public/tournaments/{tournamentId}/result-proof

Unknown, private, cross-project, deleted, or unsupported tournaments return the same not-found shape to unauthenticated callers.

Webhook flow

For tournament.completed, prefer the discovery link in the webhook envelope:


Code
{
  "id": "evt_01JEXAMPLE",
  "type": "tournament.completed",
  "environment": "test",
  "data": {
    "tournamentId": "trn_01JEXAMPLE",
    "completedAt": "2026-06-03T20:42:00.000Z"
  },
  "links": {
    "resultProof": {
      "href": "/api/v1/developer-api/management/tournaments/trn_01JEXAMPLE/result-proof",
      "method": "GET"
    }
  }
}

Code
GET /api/v1/developer-api/management/tournaments/trn_01JEXAMPLE/result-proof
Authorization: Bearer pw_mgmt_...
PokerWorks-Event-Id: evt_01JEXAMPLE
PokerWorks-Delivery-Id: whdel_01JEXAMPLE

links.resultProof is optional for older deliveries and staged rollouts. If the link is absent, derive the management read from data.tournamentId:

Code
/api/v1/developer-api/management/tournaments/{tournamentId}/result-proof

Example response


Code
{
  "object": "developer_tournament_result_proof",
  "apiVersion": "2026-06-03",
  "environment": "test",
  "livemode": false,
  "tournament": {
    "id": "trn_01JEXAMPLE",
    "displayName": "Wednesday Home Game",
    "status": "completed",
    "completedAt": "2026-06-03T20:42:00.000Z",
    "visibility": "public",
    "productKey": "pokerdeck-club-demo"
  },
  "winner": {
    "rank": 1,
    "displayName": "Alice",
    "publicParticipantId": "pp_AliceResultDemo01"
  },
  "standings": [
    {
      "rank": 1,
      "displayName": "Alice",
      "publicParticipantId": "pp_AliceResultDemo01",
      "finalChips": 120000,
      "payout": {
        "kind": "play_chips",
        "amount": 5000
      },
      "knockouts": 2,
      "bountyWon": 750
    },
    {
      "rank": 2,
      "displayName": "Player 2",
      "publicParticipantId": "pp_PlayerTwoDemo001",
      "finalChips": 0
    }
  ],
  "payoutSummary": {
    "kind": "play_chips",
    "totalAmount": 5000,
    "paidPlaces": 1
  },
  "evidence": {
    "resultProjection": {
      "authority": "TournamentResultsProjectionService",
      "readSurface": "platform.tournament.results",
      "status": "available",
      "projectionSequence": 12345,
      "generatedAt": "2026-06-03T20:42:03.000Z"
    },
    "replay": {
      "status": "available",
      "url": "https://pokerdeck.io/j/ABC123/results"
    },
    "fairness": {
      "status": "summary_only",
      "description": "Hand-level proof status is available only through approved retained hand lookups."
    }
  },
  "support": {
    "requestId": "req_01JEXAMPLE",
    "webhookEventId": "evt_01JEXAMPLE",
    "webhookDeliveryId": "whdel_01JEXAMPLE",
    "projectId": "devproj_01JEXAMPLE",
    "sourceTournamentId": "trn_01JEXAMPLE"
  }
}

Privacy boundary

The response never includes raw PlayerId, account ids, email addresses, payment ids, private cards, deck order, proof secrets, management settings, or webhook endpoint secrets.

Display identity is limited to the approved tournament display name, a product-approved public alias, or a generated tournament-scoped label such as Player 2.

Support bundle

When asking for help with a result/proof read, include:

request id from the result/proof response;
webhook event id and delivery id, if the read came from a webhook;
project id and environment;
tournament id;
whether you used the management read or public read;
replay and fairness statuses from the evidence object.

When to use it

Try it in test mode

Endpoints

Webhook flow

Example response

Privacy boundary

Support bundle

Related

When to use it

Try it in test mode

Endpoints

Webhook flow

Example response

Privacy boundary

Support bundle

Related