Skip to main content
GET
/
schedules
年間・開催スケジュール
curl --request GET \
  --url https://api.beter-keiba.com/v1/schedules \
  --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
    }
  ],
  "extensions": {
    "totalCount": 1,
    "limit": 50,
    "page": 1,
    "totalPages": 1,
    "dataUpdatedAt": 1716715200
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
from
string<date>

期間指定（開始）

​
to
string<date>

期間指定（終了）

​
sort
string

ソート順（- を付けると降順）

Maximum string length: 100
​
page
integer
default:1

ページ番号 (1 以上 10000 以下)

Required range: 1 <= x <= 10000
​
limit
integer
default:100

1リクエストあたりの最大取得件数 (1 以上 1000 以下)

Required range: 1 <= x <= 1000

Response

Success

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

​
code
string
required

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

Example:

"SUCCESS"

​
data
object[]
required

取得されたデータ本体

​
extensions
object

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