Skip to main content

REST API

A predictable REST contract for licensed intelligence.

Pull qualified records into a server-side product workflow through the existing versioned API and a revocable partner credential.

Endpoint
GET /api/v1/picks
Transport
Private, non-cacheable JSON

REQUEST MODEL

A narrow server-to-server request.

Authenticate on your server, request licensed records, and retain the response request ID for operational traceability.

Endpoint
GET /api/v1/picks
Authentication
Authorization: Bearer ph_live_…
REQUESTILLUSTRATIVE
GET /api/v1/picks?sport=MLB&status=upcoming&limit=50
  • sport
  • league
  • status
  • result
  • from
  • to
  • limit
  • cursor

RESPONSE ANATOMY

Contract fields and pagination stay explicit.

Illustrative response—not a live connection. Values demonstrate the existing public contract shape; they are not a production response.

200 / APPLICATION·JSONFORMAT EXAMPLE
{
  "data": [
    {
      "id": "ph_pick_djE6ODEyMw",
      "sport": "MLB",
      "league": "MLB",
      "eventDescription": "New York Yankees at Boston Red Sox",
      "eventDate": "2026-07-21T23:10:00.000Z",
      "homeTeam": "Boston Red Sox",
      "awayTeam": "New York Yankees",
      "marketType": "moneyline",
      "selection": "Boston Red Sox",
      "line": null,
      "odds": 1.87,
      "oddsFormat": "decimal",
      "bookmaker": "Bet365",
      "probability": 64,
      "confidenceTier": "A",
      "reasoning": "The model grades Boston's bullpen advantage materially higher.",
      "status": "upcoming",
      "result": null,
      "settledAt": null,
      "publishedAt": "2026-07-20T09:00:00.000Z",
      "attribution": "Powered by PowerHouse"
    }
  ],
  "page": {
    "nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI2LTA3LTIwVDA5OjAwOjAwLjAwMFoiLCJpZCI6IjgxMjMifQ",
    "hasMore": true
  },
  "requestId": "req_example_123"
}

Cursor pagination

Use page.nextCursor as the next request cursor while page.hasMore is true. A null nextCursor marks the end of the current result set.

Entitlement filtering

Every response is filtered by sport, league, date, content mode, and channel. Optional fields are removed when the active entitlement does not include them.

Read the API documentation

TECHNICAL REVIEW

Validate the contract inside your workflow.

Review the request model with your engineering team, then test a licensed contract against one product surface.