Event Details

Requires Authentication: This endpoint requires an API key and costs 1 credit per request.

This endpoint returns everything you need to display a complete event page:

Team information
All betting markets and odds
Live scores and statistics (if event is live)
Event news and context
Real-time odds (if event is live)

Perfect for building detailed event pages in your application.

View Tracking: Each request increments the event’s view count, helping us identify trending events.

Authorization

string

default:"Bearer "

required

Your API key for authentication

Path Parameters

eventId

string

required

The unique event IDExample: 123456

Query Parameters

locale

string

default:"en"

Language for team, competition, and region names. Supported: en, es, pt

Response

Returns a complete event object with all related data.

Core Fields

string

Unique event ID

competitionId

integer

Parent competition ID

regionId

integer

Parent region ID

sportId

integer

Sport ID

startDateTime

string

Event start time (ISO 8601)

status

string

Event status: upcoming, live, or completed

views

integer

Number of views

Relationships

homeTeam

object

Home team object with id, localized name, and regionId

awayTeam

object

Away team object with localized name

competition

object

Competition object with id, localized caption, regionId, and nested region

region

object

Region object with localized caption

Markets and Odds

markets

array

Array of betting markets for this event

Show Market Object

string

Market ID

betTypeSysname

string

Market type identifierExamples:

SOCCER_MATCH_RESULT - 1X2
SOCCER_UNDER_OVER - Total goals
BASKETBALL_MATCH_RESULT_HANDICAP - Spread

betItems

array

Array of betting options

Show BetItem Object

string

Bet item ID

code

string

Outcome code (e.g., “1”, “X”, “2” for 1X2)

caption

string

Human-readable caption (e.g., “Home Win”, “Draw”)

price

number

Decimal odds (e.g., 2.10)

oddsText

string

Odds as text (e.g., “2.10”)

isAvailable

boolean

Whether this bet is currently available

Statistics

stats

object

Match statistics and live data (null for upcoming events, object for live/completed events)

Show Stats Object

homeGoals

integer

Home team score

awayGoals

integer

Away team score

phaseSysname

string

Current match phaseExamples:

SOCCER_MATCH_FIRST_HALF
SOCCER_MATCH_SECOND_HALF
BASKETBALL_QUARTER_1
FULL_TIME (completed)

phaseCaption

string

Localized phase description (e.g., “First Half”, “Partida finalizada”)

isLive

boolean

Whether event is currently live

timeline

array

Array of match events (goals, cards, corners, etc.)

Sport-specific fields: Soccer includes corners, cards, fouls; Basketball includes quarters; Tennis includes sets, etc.

Live Markets

liveMarkets

array

Real-time markets for live events. Each market includes a list of live bet items with current odds.

Show Live Market Object

marketId

string

Market identifier (matches the source market ID)

marketSysname

string

Market system name (e.g., SOCCER_MATCH_RESULT)

marketCaption

string

Human-readable market caption when available

betItems

array

Array of live bet items with odds

Show Live Bet Item

code

string

Outcome code (1, X, O, etc.)

caption

string

Human-readable outcome caption

price

number

Decimal odds

priceChange

number

Price delta since the previous snapshot (if available)

isAvailable

boolean

Whether this outcome is currently available

Example Request

curl "https://api.mrdoge.co/v2/matches/123456?locale=en"

Example Response

Upcoming Event
Completed Event

{
  "data": {
    "id": "42099047",
    "startDateTime": "2025-09-13T11:30:00.000Z",
    "status": "upcoming",
    "views": 1250,
    "homeTeam": {
      "id": 95450,
      "name": "Arsenal"
    },
    "awayTeam": {
      "id": 11045,
      "name": "Nottingham Forest"
    },
    "sport": {
      "id": 1,
      "name": "soccer",
      "sysname": "SOCCER_MATCH"
    },
    "competition": {
      "id": 847,
      "caption": "Premier League"
    },
    "region": {
      "id": 6,
      "caption": "England"
    },
    "stats": null,
    "markets": [
      {
        "id": "<string>",
        "betTypeSysname": "SOCCER_MATCH_RESULT",
        "betItems": [
          {
            "id": "<string>",
            "code": "1",
            "caption": "1",
            "price": 1.4,
            "isAvailable": true
          },
          {
            "id": "<string>",
            "code": "X",
            "caption": "X",
            "price": 4.7,
            "isAvailable": true
          },
          {
            "id": "<string>",
            "code": "2",
            "caption": "2",
            "price": 8.1,
            "isAvailable": true
          }
        ]
      }
    ],
    "analysisInsight": { ... },
    "eventNews": [ ... ]
  }
}

{
  "data": {
    "id": "42243300",
    "startDateTime": "2025-09-04T10:35:00.000Z",
    "status": "completed",
    "views": 823,
    "homeTeam": {
      "id": 123456,
      "name": "FC Masar"
    },
    "awayTeam": {
      "id": 789012,
      "name": "Gazl Kafr Eldwar"
    },
    "sport": {
      "id": 1,
      "name": "soccer"
    },
    "stats": {
      "homeGoals": 0,
      "awayGoals": 0,
      "homeCorners": 5,
      "awayCorners": 1,
      "homeYellowCards": 2,
      "awayYellowCards": 2,
      "homeRedCards": 0,
      "awayRedCards": 0,
      "phaseSysname": "SOCCER_MATCH_SECOND_HALF",
      "phaseCaption": "Match Finished",
      "isLive": false,
      "timeline": [
        {
          "type": "YellowCardWithoutPlayer",
          "context": "A",
          "captions": ["1", "Gazl Kafr Eldwar"],
          "phaseCode": "1H",
          "timeOffset": 1
        },
        {
          "type": "Corner",
          "context": "H",
          "captions": ["18", "FC Masar"],
          "phaseCode": "1H",
          "timeOffset": 18
        }
      ]
    },
    "markets": [ ... ]
  }
}

Use Cases

Event Page

Display complete event information with all markets and odds

Live Scores

Show real-time scores and match statistics

Odds Comparison

Compare odds across different markets

Error Responses

404 Not Found

error

Event with specified ID does not exist

Authorizations

Authorization

string

header

required

Use your API key from the Mr. Doge dashboard. Format: Bearer sk_live_... or Bearer sk_test_...

Path Parameters

eventId

string

required

Event ID

Example:

"123456"

Response

Event details

string

Example:

"123456"

competitionId

integer

Example:

1

homeTeamId

integer

deprecated

Example:

100

awayTeamId

integer

deprecated

Example:

101

regionId

integer

Example:

1

sportId

integer

Example:

1

startDateTime

string<date-time>

Example:

"2025-11-08T15:00:00Z"

status

enum<string>

Available options:

upcoming,

live,

completed

Example:

"upcoming"

views

integer

Example:

1250

metadata

object

Sport-specific event metadata including teams, markets, and odds

Show child attributes

metadata.sportName

string

Example:

"soccer"

metadata.homeTeamName

string

Example:

"Arsenal"

metadata.awayTeamName

string

Example:

"Chelsea"

homeTeam

object

Show child attributes

homeTeam.id

integer

Example:

1

homeTeam.caption

string

Example:

"Arsenal"

homeTeam.regionId

integer

Example:

1

awayTeam

object

Show child attributes

awayTeam.id

integer

Example:

1

awayTeam.caption

string

Example:

"Arsenal"

awayTeam.regionId

integer

Example:

1

competition

object

Show child attributes

competition.id

integer

Example:

1

competition.caption

string

Example:

"Premier League"

competition.regionId

integer

Example:

1

competition.region

object

Show child attributes

competition.region.id

integer

Example:

1

competition.region.caption

string

Example:

"England"

competition.region._count

object

Show child attributes

competition.region._count.competitions

integer

Example:

5

competition.region._count.events

integer

Example:

120

competition.region.availableSports

string[]

Example:

["soccer", "tennis"]

competition.region.competitions

array

competition._count

object

Show child attributes

competition._count.events

integer

Example:

38

region

object

Show child attributes

region.id

integer

Example:

1

region.caption

string

Example:

"England"

region._count

object

Show child attributes

region._count.competitions

integer

Example:

5

region._count.events

integer

Example:

120

region.availableSports

string[]

Example:

["soccer", "tennis"]

region.competitions

array

markets

object[]

Show child attributes

markets.id

string

Example:

"mkt_123456"

markets.eventId

string

Example:

"123456"

markets.betTypeSysname

string

Example:

"SOCCER_MATCH_RESULT"

markets.betItems

object[]

Show child attributes

markets.betItems.id

string

Example:

"bet_123456"

markets.betItems.marketId

string

Example:

"mkt_123456"

markets.betItems.code

string

Example:

"1"

markets.betItems.caption

string

Example:

"Home Win"

markets.betItems.price

number<float>

Decimal odds

Example:

2.1

markets.betItems.oddsText

string

Example:

"2.10"

markets.betItems.isAvailable

boolean

Example:

true

liveEventData

object[]

Show child attributes

liveEventData.eventId

string

liveEventData.phaseSysname

string

Example:

"SOCCER_MATCH_SECOND_HALF"

liveEventData.isLive

boolean

Example:

true

liveEventData.liveDataJson

object

Sport-specific live data (scores, statistics, etc.)

bettingRecommendations

object[]

Show child attributes

bettingRecommendations.id

string

Example:

"rec_123456"

bettingRecommendations.eventId

string

Example:

"123456"

bettingRecommendations.marketId

string

Example:

"mkt_123456"

bettingRecommendations.betItemId

string

Example:

"bet_123456"

bettingRecommendations.outcome

string

Example:

"Home Win"

bettingRecommendations.odds

number<float>

Example:

2.1

bettingRecommendations.confidence

enum<string>

Available options:

High,

Medium,

Low

Example:

"High"

bettingRecommendations.edgePercentage

number<float>

Statistical edge over market odds

Example:

6.8

bettingRecommendations.kellyFraction

number<float>

Optimal stake size using Kelly Criterion (10% fractional Kelly recommended)

Example:

0.032

bettingRecommendations.rationale

string[]

Example:

[
  "Home team's excellent form (8 wins in last 10)",
  "Away team struggling defensively (10 goals conceded in 3 games)"
]

bettingRecommendations.riskFactors

string[]

Example:

[
  "Away team has key players returning from injury"
]

bettingRecommendations.dataSupport

string[]

Example:

[
  "Simulation gives 52% home win probability vs 47.6% implied by odds"
]

bettingRecommendations.settled

boolean

Example:

false

bettingRecommendations.result

enum<string> | null

Available options:

won,

lost,

push

mrDogePick

object

Show child attributes

mrDogePick.id

string

Example:

"pick_123456"

mrDogePick.pickType

enum<string>

Available options:

single,

parlay

Example:

"parlay"

mrDogePick.recommendations

object[]

Show child attributes

mrDogePick.recommendations.id

string

Example:

"rec_123456"

mrDogePick.recommendations.eventId

string

Example:

"123456"

mrDogePick.recommendations.marketId

string

Example:

"mkt_123456"

mrDogePick.recommendations.betItemId

string

Example:

"bet_123456"

mrDogePick.recommendations.outcome

string

Example:

"Home Win"

mrDogePick.recommendations.odds

number<float>

Example:

2.1

mrDogePick.recommendations.confidence

enum<string>

Available options:

High,

Medium,

Low

Example:

"High"

mrDogePick.recommendations.edgePercentage

number<float>

Statistical edge over market odds

Example:

6.8

mrDogePick.recommendations.kellyFraction

number<float>

Optimal stake size using Kelly Criterion (10% fractional Kelly recommended)

Example:

0.032

mrDogePick.recommendations.rationale

string[]

Example:

[
  "Home team's excellent form (8 wins in last 10)",
  "Away team struggling defensively (10 goals conceded in 3 games)"
]

mrDogePick.recommendations.riskFactors

string[]

Example:

[
  "Away team has key players returning from injury"
]

mrDogePick.recommendations.dataSupport

string[]

Example:

[
  "Simulation gives 52% home win probability vs 47.6% implied by odds"
]

mrDogePick.recommendations.settled

boolean

Example:

false

mrDogePick.recommendations.result

enum<string> | null

Available options:

won,

lost,

push

mrDogePick.totalOdds

number<float>

Combined odds for parlay (product of all recommendation odds)

Example:

8.5

mrDogePick.settled

boolean

Example:

false

mrDogePick.result

enum<string> | null

Available options:

won,

lost,

push

Sports Endpoints

AI Endpoints

Core Utilities

Authorization

Path Parameters

Query Parameters

Response

Core Fields

Relationships

Markets and Odds

Statistics

Live Markets

Example Request

Example Response

Use Cases

Event Page

Live Scores

Odds Comparison

Error Responses

Authorizations

Path Parameters

Response

Sports Endpoints

AI Endpoints

Core Utilities

​Authorization

​Path Parameters

​Query Parameters

​Response

​Core Fields

​Relationships

​Markets and Odds

​Statistics

​Live Markets

​Example Request

​Example Response

​Use Cases

Event Page

Live Scores

Odds Comparison

​Error Responses

Authorizations

Path Parameters

Response

Authorization

Path Parameters

Query Parameters

Response

Core Fields

Relationships

Markets and Odds

Statistics

Live Markets

Example Request

Example Response

Use Cases

Error Responses