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",
    "dataUpdatedAt": 1716715200,
    "raceYear": 2024,
    "raceDate": "0526",
    "courseCode": "05",
    "meetingNumber": 2,
    "meetingDay": 12,
    "raceNumber": 11,
    "dayOfWeekCode": "1",
    "specialRaceNumber": "0000",
    "title": "東京優駿",
    "subTitle": "（日本ダービー）",
    "titleAppendix": "（ＧＩ）",
    "titleEnglish": "TOKYO YUSHUN",
    "titleEnglishSub": "JAPANESE DERBY",
    "titleEnglishParen": "G1",
    "titleClassification": "1",
    "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",
    "distance": 2400,
    "distanceChangedFrom": 0,
    "trackCode": "17",
    "trackChangedFrom": "17",
    "courseSubset": "A",
    "courseSubsetChangedFrom": "",
    "prizes": [
      300000000,
      120000000,
      75000000,
      45000000,
      30000000
    ],
    "prizesChangedFrom": [
      300000000,
      90000000,
      90000000,
      45000000,
      30000000
    ],
    "addedPrizes": [
      45122000,
      12892000,
      6446000
    ],
    "addedPrizesChangedFrom": [
      40000000,
      12000000,
      6000000
    ],
    "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
    ],
    "first3FTime": 34.3,
    "first4FTime": 46.4,
    "last3FTime": 33.8,
    "last4FTime": 45,
    "cornerPassingOrder": [
      {
        "corner": 1,
        "lap": 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",
      "dataUpdatedAt": 1716715200,
      "entryCount": 18,
      "starterCount": 18,
      "flags": {
        "failed": {
          "win": false,
          "place": false,
          "bracketQuinella": false,
          "quinella": false,
          "wide": false,
          "exacta": false,
          "trio": false,
          "trifecta": false
        },
        "special": {
          "win": false,
          "place": false,
          "bracketQuinella": false,
          "quinella": false,
          "wide": false,
          "exacta": false,
          "trio": false,
          "trifecta": false
        },
        "refund": {
          "win": false,
          "place": false,
          "bracketQuinella": false,
          "quinella": false,
          "wide": false,
          "exacta": false,
          "trio": false,
          "trifecta": false
        }
      },
      "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
  }
}

Authorizations

​
Authorization
string
header
required

APIダッシュボードで発行された sk_live_... または sk_test_... キーを入力してください。prefix は mode を示し、両 mode とも同じ API URL で利用できます (sk_live_* = live mode / 本番、sk_test_* = test mode / 開発・自動テスト)。

Path Parameters

​
raceId
string
required

Race entity ID。JV-Data RA レコード由来の合成 PK (開催年月日 8 桁 + 場コード 2 桁 + 開催回 2 桁 + 開催日目 2 桁 + レース番号 2 桁)

Pattern: ^ra_[0-9]{16}$
Example:

"ra_2024052605021211"

Query Parameters

​
include
string

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

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

  • Race: payout
  • RaceEntry: jockey, trainer, owner, foal, training
  • Horse: trainer, owner, breeder, foal, form, training
Maximum string length: 200
​
fields
string

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

Maximum string length: 500

Response

Success

成功レスポンスの共通ラッパー。code は常に "SUCCESS"、data にエンドポイント固有のレスポンスボディ、extensions に補助情報 (pagination や統計など) を含みます。

​
code
string
required

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

Example:

"SUCCESS"

​
data
object
required

レースの基本情報および結果詳細。

condition2Yo / condition3Yo / condition4Yo / condition5YoUp / conditionYoungest の 5 列は、それぞれ 2歳・3歳・4歳・5歳以上・最若年の競走条件 (JV-Data RA レコード #28-#32 由来) を表し、いずれも RaceConditionCode で定義された同一の値空間を取ります。

​
extensions
object

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