Skip to main content
GET
/
races
/
{raceId}
レース詳細
curl --request GET \
  --url https://api.beter-keiba.com/v1/races/{raceId} \
  --header 'Authorization: Bearer <token>'
{
  "code": "SUCCESS",
  "data": {
    "id": "ra_2024052605021211",
    "dataType": "2",
    "raceYear": 2024,
    "raceDate": "0526",
    "courseCode": "05",
    "raceNumber": 11,
    "title": "東京優駿",
    "distance": 2400,
    "dataUpdatedAt": 1716715200,
    "nTime": 2,
    "nDay": 12,
    "dayOfWeekCode": "1",
    "specialRaceNumber": "0000",
    "subTitle": "(日本ダービー)",
    "titleAppendix": "(GI)",
    "titleEnglish": "TOKYO YUSHUN",
    "titleShort10": "日本ダービー",
    "titleShort6": "ダービー",
    "titleShort3": "ダービー",
    "gradeCode": "A",
    "gradeChangedFrom": "A",
    "gradeCount": 91,
    "typeCode": "14",
    "signCode": "A41",
    "weightTypeCode": "4",
    "condition2Yo": "000",
    "condition3Yo": "001",
    "condition4Yo": "000",
    "condition5YoUp": "000",
    "conditionYoungest": "001",
    "conditionName": null,
    "distanceChangedFrom": 0,
    "trackCode": "17",
    "trackChangedFrom": "17",
    "courseSubset": "A",
    "prizes": [
      300000000,
      120000000,
      75000000,
      45000000,
      30000000
    ],
    "addedPrizes": [
      45122000,
      12892000,
      6446000
    ],
    "postTime": "1540",
    "postTimeChangedFrom": "1540",
    "entryCount": 18,
    "starterCount": 18,
    "finisherCount": 18,
    "weatherCode": "1",
    "turfConditionCode": "1",
    "dirtConditionCode": "1",
    "lapTimes": [
      12.2,
      10.8,
      11.3,
      12.1,
      12.6,
      12.7,
      12.5,
      11.7,
      11.3,
      11.1,
      11.2,
      11.5
    ],
    "steepleMileTime": null,
    "first3FTime": 34.3,
    "first4FTime": 46.4,
    "last3FTime": 33.8,
    "last4FTime": 45,
    "cornerPassingOrder": [
      {
        "corner": 1,
        "order": "15-2,5(3,7,12)(1,8,11,14)(4,13,17)-6,16,18-9-10"
      }
    ],
    "isRecordBreak": 0,
    "payout": {
      "raceId": "ra_2024052605021211",
      "dataType": "2",
      "entryCount": 18,
      "starterCount": 18,
      "flags": {
        "failed": {},
        "special": {},
        "refund": {}
      },
      "refundHorseNumbers": [],
      "refundBracketNumbers": [],
      "refundSameBracketNumbers": [],
      "win": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "place": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "bracketQuinella": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "quinella": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "wide": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "exacta": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "trio": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "trifecta": [
        {
          "numbers": "5",
          "payout": 4660,
          "popularity": 9
        }
      ],
      "createdAt": 1716716000,
      "updatedAt": 1716716000
    },
    "createdAt": 1716716000,
    "updatedAt": 1716716000
  },
  "extensions": {
    "totalCount": 150,
    "limit": 50,
    "page": 1,
    "totalPages": 3,
    "dataUpdatedAt": 1716715200
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.beter-keiba.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

APIダッシュボードで発行された sk_live_... キーを入力してください。

Path Parameters

raceId
string
required

Query Parameters

accessKey
string
required

APIアクセスキー (bk_live_...)

include
string

関連データをネストして取得します(カンマ区切り)。

利用可能なリレーション:

  • Race: payout
  • RaceEntry: jockey, trainer, owner, foal, stats, training
  • Horse: trainer, owner, breeder, foal, stats, training
fields
string

取得するフィールドの絞り込み(カンマ区切り)

Response

Success

code
string
required

処理結果コード。成功時は常に 'SUCCESS'。

Example:

"SUCCESS"

data
object
required

レースの基本情報および結果詳細。JRA-VANのJV-Dataに基づき、単位の変換(賞金の円単位化やタイムの秒単位化)が行われています。

extensions
object

レスポンスに関する補助情報(メタデータ)。一覧取得時にはページネーション情報が含まれます。