Event Details

Get Event Details

curl --request GET \
  --url https://api.mrdoge.co/v2/matches/{eventId}

{
  "id": "123456",
  "competitionId": 1,
  "homeTeamId": 100,
  "awayTeamId": 101,
  "regionId": 1,
  "sportId": 1,
  "startDateTime": "2025-11-08T15:00:00Z",
  "status": "upcoming",
  "views": 1250,
  "metadata": {
    "sportName": "soccer",
    "homeTeamName": "Arsenal",
    "awayTeamName": "Chelsea"
  },
  "homeTeam": {
    "id": 1,
    "caption": "Arsenal",
    "regionId": 1
  },
  "awayTeam": {
    "id": 1,
    "caption": "Arsenal",
    "regionId": 1
  },
  "competition": {
    "id": 1,
    "caption": "Premier League",
    "regionId": 1,
    "region": {
      "id": 1,
      "caption": "England",
      "_count": {
        "competitions": 5,
        "events": 120
      },
      "availableSports": [
        "soccer",
        "tennis"
      ],
      "competitions": "<array>"
    },
    "_count": {
      "events": 38
    }
  },
  "region": {
    "id": 1,
    "caption": "England",
    "_count": {
      "competitions": 5,
      "events": 120
    },
    "availableSports": [
      "soccer",
      "tennis"
    ],
    "competitions": "<array>"
  },
  "markets": [
    {
      "id": "mkt_123456",
      "eventId": "123456",
      "betTypeSysname": "SOCCER_MATCH_RESULT",
      "betItems": [
        {
          "id": "bet_123456",
          "marketId": "mkt_123456",
          "code": "1",
          "caption": "Home Win",
          "price": 2.1,
          "oddsText": "2.10",
          "isAvailable": true
        }
      ]
    }
  ],
  "liveEventData": [
    {
      "eventId": "<string>",
      "phaseSysname": "SOCCER_MATCH_SECOND_HALF",
      "isLive": true,
      "liveDataJson": {}
    }
  ],
  "bettingRecommendations": [
    {
      "id": "rec_123456",
      "eventId": "123456",
      "marketId": "mkt_123456",
      "betItemId": "bet_123456",
      "outcome": "Home Win",
      "odds": 2.1,
      "confidence": "High",
      "edgePercentage": 6.8,
      "kellyFraction": 0.032,
      "rationale": [
        "Home team's excellent form (8 wins in last 10)",
        "Away team struggling defensively (10 goals conceded in 3 games)"
      ],
      "riskFactors": [
        "Away team has key players returning from injury"
      ],
      "dataSupport": [
        "Simulation gives 52% home win probability vs 47.6% implied by odds"
      ],
      "settled": false
    }
  ],
  "mrDogePick": {
    "id": "pick_123456",
    "pickType": "parlay",
    "recommendations": [
      {
        "id": "rec_123456",
        "eventId": "123456",
        "marketId": "mkt_123456",
        "betItemId": "bet_123456",
        "outcome": "Home Win",
        "odds": 2.1,
        "confidence": "High",
        "edgePercentage": 6.8,
        "kellyFraction": 0.032,
        "rationale": [
          "Home team's excellent form (8 wins in last 10)",
          "Away team struggling defensively (10 goals conceded in 3 games)"
        ],
        "riskFactors": [
          "Away team has key players returning from injury"
        ],
        "dataSupport": [
          "Simulation gives 52% home win probability vs 47.6% implied by odds"
        ],
        "settled": false
      }
    ],
    "totalOdds": 8.5,
    "settled": false
  }
}

GET

matches

{eventId}

Get Event Details

curl --request GET \
  --url https://api.mrdoge.co/v2/matches/{eventId}

{
  "id": "123456",
  "competitionId": 1,
  "homeTeamId": 100,
  "awayTeamId": 101,
  "regionId": 1,
  "sportId": 1,
  "startDateTime": "2025-11-08T15:00:00Z",
  "status": "upcoming",
  "views": 1250,
  "metadata": {
    "sportName": "soccer",
    "homeTeamName": "Arsenal",
    "awayTeamName": "Chelsea"
  },
  "homeTeam": {
    "id": 1,
    "caption": "Arsenal",
    "regionId": 1
  },
  "awayTeam": {
    "id": 1,
    "caption": "Arsenal",
    "regionId": 1
  },
  "competition": {
    "id": 1,
    "caption": "Premier League",
    "regionId": 1,
    "region": {
      "id": 1,
      "caption": "England",
      "_count": {
        "competitions": 5,
        "events": 120
      },
      "availableSports": [
        "soccer",
        "tennis"
      ],
      "competitions": "<array>"
    },
    "_count": {
      "events": 38
    }
  },
  "region": {
    "id": 1,
    "caption": "England",
    "_count": {
      "competitions": 5,
      "events": 120
    },
    "availableSports": [
      "soccer",
      "tennis"
    ],
    "competitions": "<array>"
  },
  "markets": [
    {
      "id": "mkt_123456",
      "eventId": "123456",
      "betTypeSysname": "SOCCER_MATCH_RESULT",
      "betItems": [
        {
          "id": "bet_123456",
          "marketId": "mkt_123456",
          "code": "1",
          "caption": "Home Win",
          "price": 2.1,
          "oddsText": "2.10",
          "isAvailable": true
        }
      ]
    }
  ],
  "liveEventData": [
    {
      "eventId": "<string>",
      "phaseSysname": "SOCCER_MATCH_SECOND_HALF",
      "isLive": true,
      "liveDataJson": {}
    }
  ],
  "bettingRecommendations": [
    {
      "id": "rec_123456",
      "eventId": "123456",
      "marketId": "mkt_123456",
      "betItemId": "bet_123456",
      "outcome": "Home Win",
      "odds": 2.1,
      "confidence": "High",
      "edgePercentage": 6.8,
      "kellyFraction": 0.032,
      "rationale": [
        "Home team's excellent form (8 wins in last 10)",
        "Away team struggling defensively (10 goals conceded in 3 games)"
      ],
      "riskFactors": [
        "Away team has key players returning from injury"
      ],
      "dataSupport": [
        "Simulation gives 52% home win probability vs 47.6% implied by odds"
      ],
      "settled": false
    }
  ],
  "mrDogePick": {
    "id": "pick_123456",
    "pickType": "parlay",
    "recommendations": [
      {
        "id": "rec_123456",
        "eventId": "123456",
        "marketId": "mkt_123456",
        "betItemId": "bet_123456",
        "outcome": "Home Win",
        "odds": 2.1,
        "confidence": "High",
        "edgePercentage": 6.8,
        "kellyFraction": 0.032,
        "rationale": [
          "Home team's excellent form (8 wins in last 10)",
          "Away team struggling defensively (10 goals conceded in 3 games)"
        ],
        "riskFactors": [
          "Away team has key players returning from injury"
        ],
        "dataSupport": [
          "Simulation gives 52% home win probability vs 47.6% implied by odds"
        ],
        "settled": false
      }
    ],
    "totalOdds": 8.5,
    "settled": false
  }
}

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, region names, market names, and outcome captions. 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

displayName

string

Localized market name based on the locale parameter (e.g., “Match Result” in English, “Resultado Final” in Portuguese)

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

Raw caption from the data source

translatedCaption

string

Localized outcome caption based on the locale parameter (e.g., “Home Win” in English, “Vitória Mandante” in Portuguese)

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

Raw market caption from the data source

marketDisplayName

string

Localized market name based on the locale parameter (e.g., “Match Result” in English, “Resultado Final” in Portuguese)

betItems

array

Array of live bet items with odds

Show Live Bet Item

code

string

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

translatedCaption

string

Localized outcome caption based on the locale parameter

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

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

homeTeam

object

Show child attributes

awayTeam

object

Show child attributes

competition

object

Show child attributes

region

object

Show child attributes

markets

object[]

Show child attributes

liveEventData

object[]

Show child attributes

bettingRecommendations

object[]

Show child attributes

mrDogePick

object

Show child attributes

Live Events Live Odds

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

Path Parameters

Response

Sports Endpoints

AI Endpoints

Core Utilities

Documentation Index

​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

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