> ## 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. # 出走馬一覧 ## OpenAPI ````yaml /reference/openapi.json get /races/{raceId}/entries openapi: 3.1.0 info: title: BeTerKEIBA Core API description: >- JV-Data をベースとした競馬データ配信プラットフォーム。Cloudflare Workers (Hono), D1, R2を組み合わせたモダンなアーキテクチャで構築されています。 ### 特徴 - **高速レスポンス**: Cloudflareのエッジネットワークによる低レイテンシ。 - **完全なデータ構造**: 産駒から現役、オッズ、マイニングまで網羅。 - **開発者フレンドリー**: MintlifyドキュメントとTypeScript SDKによる高い開発効率 version: 1.0.0 servers: - url: https://api.beter-keiba.com/v1 description: 本番環境 security: - bearerAuth: [] tags: - name: Races description: レースデータ。開催情報・出走表・結果など、レース単位で取得する正規データ - name: Odds description: オッズデータ。単勝・複勝・枠連・馬連・ワイド・馬単・3連複・3連単の確定オッズおよび最終オッズ - name: Masters description: マスタデータ。競走馬・騎手・調教師・生産者・馬主・繁殖牝馬といった静的な実体情報 - name: Updates description: 更新データ。スケジュール・調教・WIN5・予想指数など、随時更新が発生する派生データ paths: /races/{raceId}/entries: get: tags: - Races summary: 出走馬一覧 operationId: listRaceEntries parameters: - $ref: '#/components/parameters/raceId' - $ref: '#/components/parameters/include' - $ref: '#/components/parameters/fields' responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/SuccessResponse' - type: object properties: data: type: array items: $ref: '#/components/schemas/RaceEntry' example: code: SUCCESS data: - id: se_2024052605021211052021105477 dataType: '2' dataUpdatedAt: 1716715200 raceId: ra_2024052605021211 bracketNumber: 3 horseNumber: 5 horseId: um_2021105477 horseName: ダノンデサイル horseSymbolCode: '06' sexCode: '1' breedCode: '1' colorCode: '03' age: 3 locationCode: '1' trainerId: ch_01124 trainerName: 安田翔伍 ownerId: bn_537800 ownerName: ダノックス colorsDescription: 白，赤桃縦縞，赤袖 weight: 57 weightBefore: 57 hasBlinkers: false jockeyId: ks_05339 jockeyIdBefore: ks_05339 jockeyName: 横山典弘 jockeyNameBefore: 横山典弘 jockeyApprenticeCode: '3' apprenticeCodeChangedFrom: '3' horseWeight: 504 weightDiffSign: + weightDiff: 4 abnormalityCode: '0' orderOfArrivalRaw: 1 orderOfFinish: 1 isDeadHeat: false deadHeatCount: 0 finishTime: 144.3 marginCode: '112' marginExtraCodes: [] cornerRanks: - 14 - 14 - 13 - 7 oddsWin: 46.6 popularity: 9 prizeMoney: 300000000 prizeAddedMoney: 45122000 last4FTime: 45.1 last3FTime: 33.5 firstHorseInfo: - horseId: um_2021105477 name: ダノンデサイル timeDiff: 0 miningCategory: '3' miningData: expectedTime: 144.5 errorPlus: 0.45 errorMinus: 0.58 expectedRank: 5 competitionScore: 88 runningStyleCode: '2' isRecordBreak: 0 trainer: id: ch_01124 dataType: '2' dataUpdatedAt: 1716715200 name: 安田翔伍 nameKana: ﾔｽﾀﾞ ｼｮｳｺﾞ nameAbbr: 安田翔 nameEng: YASUDA Shogo birthday: '19811013' isRetired: false licenseIssuedAt: '20140301' genderCode: '1' locationCode: '1' invitationRegionName: '' milestones: recentGradedWins: - raceId: ra_2024052605021211 raceTitle: 東京優駿 raceTitleShort10: 日本ダービー raceTitleShort6: ダービー raceTitleShort3: ダービー gradeCode: A fieldSize: 18 horseId: um_2021105477 horseName: ドウデュース stats: thisYear: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 lastYear: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 total: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 createdAt: 1716716000 updatedAt: 1716716000 owner: id: bn_537800 dataType: '2' dataUpdatedAt: 1716715200 name: （株）ダノックス nameNoEntity: ダノックス nameKana: ﾀﾞﾉｯｸｽ nameEng: Danox Co.,Ltd. colorsDescription: 白，赤桃縦縞，赤袖 stats: thisYear: year: 2024 earnings: base: 12345600 added: 1234560 placings: - 10 - 8 - 5 - 4 - 3 - 100 total: year: 2024 earnings: base: 12345600 added: 1234560 placings: - 10 - 8 - 5 - 4 - 3 - 100 createdAt: 1716716000 updatedAt: 1716716000 jockey: id: ks_05339 dataType: '2' dataUpdatedAt: 1716715200 name: 横山典弘 nameKana: ﾖｺﾔﾏ ﾉﾘﾋﾛ nameAbbr: 横山典 nameEng: YOKOYAMA Norihiro birthday: '19680223' isRetired: false licenseIssuedAt: '19850301' genderCode: '1' qualificationCode: '3' apprenticeCode: '3' locationCode: '1' invitationRegionName: '' stableTrainerId: ch_01124 stableTrainerNameAbbr: 中川 公 milestones: firstRide: flat: raceId: ra_2024052605021211 fieldSize: 16 horseId: um_2021105477 horseName: ドウデュース finishPosition: 5 irregularStatus: '0' obstacle: raceId: ra_2024052605021211 fieldSize: 16 horseId: um_2021105477 horseName: ドウデュース finishPosition: 5 irregularStatus: '0' firstWin: flat: raceId: ra_2024052605021211 fieldSize: 16 horseId: um_2021105477 horseName: ドウデュース obstacle: raceId: ra_2024052605021211 fieldSize: 16 horseId: um_2021105477 horseName: ドウデュース recentGradedWins: - raceId: ra_2024052605021211 raceTitle: 東京優駿 raceTitleShort10: 日本ダービー raceTitleShort6: ダービー raceTitleShort3: ダービー gradeCode: A fieldSize: 18 horseId: um_2021105477 horseName: ドウデュース stats: thisYear: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 lastYear: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 total: year: 2024 earnings: baseFlat: 0 baseObstacle: 0 addedFlat: 0 addedObstacle: 0 placings: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byVenue: sapporo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hakodate: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 fukushima: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 niigata: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 tokyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 nakayama: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 chukyo: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kyoto: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 hanshin: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 kokura: flat: - 0 - 0 - 0 - 0 - 0 - 0 obstacle: - 0 - 0 - 0 - 0 - 0 - 0 byDistance: turfUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 turf1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 turf2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 dirtUpTo1600: - 0 - 0 - 0 - 0 - 0 - 0 dirt1601To2200: - 0 - 0 - 0 - 0 - 0 - 0 dirt2201Plus: - 0 - 0 - 0 - 0 - 0 - 0 createdAt: 1716716000 updatedAt: 1716716000 foal: id: sk_2021105477 dataType: '2' dataUpdatedAt: 1716715200 horseId: um_2021105477 birthday: '20210321' sexCode: '1' breedCode: '1' colorCode: '03' importTypeCode: '0' importYear: 0 breederId: br_00010521 originName: 千歳市 pedigreeBroodmareIds: - hn_0000123456 - hn_0000234567 - hn_0000345678 - hn_0000456789 - hn_0000567890 - hn_0000678901 - hn_0000789012 - hn_0000890123 - hn_0000901234 - hn_0001012345 - hn_0001123456 - hn_0001234567 - hn_0001345678 - hn_0001456789 createdAt: 1716716000 updatedAt: 1716716000 training: id: hc_12024052207152021105477 dataType: '1' dataUpdatedAt: 1716715200 horseId: um_2021105477 trainingCenterCode: '1' trainingDate: '20240522' trainingTime: '0715' times: f4: 52.4 f3: 38.1 f2: 24.5 lapTimes: - 12.2 - 12.3 - 13.6 - 14.3 createdAt: 1716716000 updatedAt: 1716716000 createdAt: 1716716000 updatedAt: 1716716000 extensions: totalCount: 1 limit: 50 page: 1 totalPages: 1 dataUpdatedAt: 1716715200 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: raceId: name: raceId in: path required: true schema: $ref: '#/components/schemas/RaceId' include: name: include in: query schema: type: string maxLength: 200 description: |- 関連データをネストして取得します（カンマ区切り）。 **利用可能なリレーション:** - **Race**: `payout` - **RaceEntry**: `jockey`, `trainer`, `owner`, `foal`, `training` - **Horse**: `trainer`, `owner`, `breeder`, `foal`, `form`, `training` example: jockey,trainer fields: name: fields in: query schema: type: string maxLength: 500 description: 取得するフィールドの絞り込み（カンマ区切り） schemas: SuccessResponse: type: object description: >- 成功レスポンスの共通ラッパー。code は常に "SUCCESS"、data にエンドポイント固有のレスポンスボディ、extensions に補助情報 (pagination や統計など) を含みます。 required: - code - data properties: code: type: string description: 処理結果コード。成功時は常に 'SUCCESS' example: SUCCESS data: description: 取得されたデータ本体 extensions: $ref: '#/components/schemas/ResponseExtensions' RaceEntry: type: object description: >- 馬ごとのレース成績・出走情報。馬体重、着順、タイム、オッズ等の詳細データが含まれます。`?include=trainer / owner / jockey / foal / training` を指定すると各 relation を含めて返却します。 required: - id - raceId - horseNumber - horseId - horseName properties: id: $ref: '#/components/schemas/RaceEntryId' dataType: type: string description: >- データ区分 (JV-Data SE レコード §2 由来)。Race.dataType と同 semantics: 1:出走馬名表(木曜), 2:出馬表(金・土曜), 3:速報成績(3着まで確定), 4:速報成績(5着まで確定), 5:速報成績(全馬着順確定), 6:速報成績(全馬着順+コーナ通過順), 7:成績(月曜), A:地方競馬, B:海外国際レース, 9:レース中止, 0:該当レコード削除(提供ミスなどの理由による) example: '2' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data SE レコード §3 由来、Unix Timestamp) example: 1716715200 raceId: $ref: '#/components/schemas/RaceId' bracketNumber: type: integer description: 枠番 example: 3 horseNumber: type: integer description: 馬番 example: 5 horseId: $ref: '#/components/schemas/HorseId' horseName: type: string description: 馬名 example: ダノンデサイル maxLength: 36 horseSymbolCode: $ref: '#/components/schemas/HorseSymbolCode' sexCode: $ref: '#/components/schemas/SexCode' breedCode: $ref: '#/components/schemas/BreedCode' colorCode: $ref: '#/components/schemas/ColorCode' age: type: integer description: 馬齢 example: 3 locationCode: $ref: '#/components/schemas/LocationCode' trainerId: $ref: '#/components/schemas/TrainerId' trainerName: type: string description: 調教師名略称 example: 安田翔伍 maxLength: 8 ownerId: $ref: '#/components/schemas/OwnerId' ownerName: type: string description: >- 馬主名 (法人格無名称、JV-Data SE レコード #23 由来)。法人格有名称は `GET /owners/{ownerId}` の `name` を参照 example: ダノックス maxLength: 64 colorsDescription: type: string description: 服色標示 example: 白，赤桃縦縞，赤袖 maxLength: 60 weight: type: number description: '負担重量 (単位: kg)' example: 57 weightBefore: type: number description: '変更前負担重量 (単位: kg)' example: 57 hasBlinkers: type: boolean description: ブリンカー使用区分 example: false jockeyId: $ref: '#/components/schemas/JockeyId' jockeyIdBefore: $ref: '#/components/schemas/JockeyId' jockeyName: type: string description: 騎手名略称 example: 横山典弘 maxLength: 8 jockeyNameBefore: type: string description: 変更前騎手名略称 example: 横山典弘 maxLength: 8 jockeyApprenticeCode: $ref: '#/components/schemas/JockeyApprenticeCode' apprenticeCodeChangedFrom: $ref: '#/components/schemas/JockeyApprenticeCode' horseWeight: type: integer description: '馬体重 (単位: kg)' example: 504 weightDiffSign: type: string description: 増減符号 (+ / -) example: + maxLength: 1 weightDiff: type: integer description: 増減差 example: 4 abnormalityCode: $ref: '#/components/schemas/AbnormalityCode' orderOfArrivalRaw: type: integer description: 入線順位 example: 1 orderOfFinish: type: integer description: 確定着順 example: 1 isDeadHeat: type: boolean description: 同着区分 example: false deadHeatCount: type: integer description: 同着頭数 example: 0 finishTime: type: number description: '走破タイム (単位: 秒)' example: 144.3 marginCode: $ref: '#/components/schemas/MarginCode' marginExtraCodes: type: array description: ＋着差, ＋＋着差データ items: type: string example: [] cornerRanks: type: array description: >- コーナー毎の通過順位 [1コーナー, 2コーナー, 3コーナー, 4コーナー] (JV-Data SE レコード §48-51 由来)。位置 = コーナー番号の semantics を持つため、データ未投入の slot は要素単位で null を保持し位置を維持する (例: 1コーナーのみ取得済の段階では `[14, null, null, null]`)。全コーナー未取得 (出馬表段階等) では本 field 自体を omit する items: type: - integer - 'null' example: - 14 - 14 - 13 - 7 oddsWin: type: number description: 単勝オッズ example: 46.6 popularity: type: integer description: 単勝人気順 example: 9 prizeMoney: type: integer description: '獲得本賞金 (単位: 円)' example: 300000000 prizeAddedMoney: type: integer description: '獲得付加賞金 (単位: 円)' example: 45122000 last4FTime: type: number description: '後4ハロンタイム (単位: 秒)' example: 45.1 last3FTime: type: number description: '後3ハロンタイム (単位: 秒)' example: 33.5 firstHorseInfo: type: array description: >- 1着馬 (相手馬) 情報 (JV-Data SE レコード §60 由来)。同着考慮で最大 3 entries。自身が1着の場合は2着馬を設定 items: $ref: '#/components/schemas/FirstHorseInfo' maxItems: 3 timeDiff: type: number description: '1着(またはタイム差計測相手)とのタイム差 (単位: 秒)' example: 0 miningCategory: type: string description: >- マイニング区分 (JV-Data SE レコード §63 由来)。マイニング予想データの算出タイミングを示す。1:前日, 2:当日, 3:直前。確定成績登録時は 3:直前 のみ設定 example: '3' maxLength: 1 miningData: type: object description: マイニング・分析データ（予想タイム、誤差、予想順位、対戦型スコア等） properties: expectedTime: type: number description: 'マイニング予想走破タイム (単位: 秒、JV-Data SE レコード §64 由来)' example: 144.5 errorPlus: type: number description: >- マイニング予想誤差 ＋ (信頼度、単位: 秒、JV-Data SE レコード §65 由来)。予想走破タイムから減算する向きの誤差 (速くなる方向)。下限予測 = expectedTime - errorPlus example: 0.45 errorMinus: type: number description: >- マイニング予想誤差 － (信頼度、単位: 秒、JV-Data SE レコード §66 由来)。予想走破タイムに加算する向きの誤差 (遅くなる方向)。上限予測 = expectedTime + errorMinus example: 0.58 expectedRank: type: integer description: マイニング予想順位 (1〜18、JV-Data SE レコード §67 由来) example: 5 competitionScore: type: integer description: 対戦型データマイニング予想スコア (0〜100 の整数、値が大きいほど好成績予想)。JV-Data TM レコード §11 由来 example: 88 runningStyleCode: type: string description: 今回レース脚質判定 (JV-Data SE レコード §68 由来)。0:初期値, 1:逃げ, 2:先行, 3:差し, 4:追込 example: '2' maxLength: 1 isRecordBreak: type: integer description: レコード更新区分 (0:なし, 1:大会レコード, 2:コースレコード) example: 0 trainer: $ref: '#/components/schemas/Trainer' owner: $ref: '#/components/schemas/Owner' jockey: $ref: '#/components/schemas/Jockey' foal: $ref: '#/components/schemas/Foal' training: $ref: '#/components/schemas/Training' createdAt: type: integer description: レコード作成日時 (Unix Timestamp) example: 1716716000 updatedAt: type: integer description: レコード最終更新日時 (Unix Timestamp) example: 1716716000 RaceId: type: string pattern: ^ra_[0-9]{16}$ example: ra_2024052605021211 description: >- Race entity ID。JV-Data RA レコード由来の合成 PK (開催年月日 8 桁 + 場コード 2 桁 + 開催回 2 桁 + 開催日目 2 桁 + レース番号 2 桁) ResponseExtensions: type: object description: レスポンスに関する補助情報（メタデータ）。一覧取得時にはページネーション情報が含まれます。 properties: totalCount: type: integer description: 検索条件に一致する全データの総件数 example: 150 limit: type: integer description: 1リクエストあたりの最大取得件数 example: 50 page: type: integer description: 現在のページ番号 example: 1 totalPages: type: integer description: 全件数をlimitで割った合計ページ数 example: 3 dataUpdatedAt: type: integer description: 返却されたデータの最終更新日時 (Unix Timestamp)。キャッシュ制御などに利用します。 example: 1716715200 RaceEntryId: type: string pattern: ^se_[0-9]{28}$ example: se_2024052605021211052021105477 description: >- RaceEntry record ID。JV-Data SE レコード由来 (馬毎レース情報、レース ID 16 桁 + 馬番 2 桁 + 血統登録番号 10 桁) HorseId: type: string pattern: ^um_[0-9]{10}$ example: um_2021105477 description: Horse entity ID。JV-Data UM レコード由来の血統登録番号 (10 桁) HorseSymbolCode: type: string description: |- 馬の産地や購買条件を表す記号コード。2桁の数値で構成されます。 ### 記号の意味 - **(抽)**: 抽選馬（JRAが市場で購買し馬主に配布した馬） - **(父)**: 内国産種牡馬（父が内国産のサラブレッド） - **(市)**: せり市場で購入された馬 - **(地)**: 地方競馬に出走歴のある馬 - **(外)**: 外国産馬 - **[地]**: 地方競馬所属の招待馬 - **[外]**: 海外の競馬に出走歴のある外国産馬 ### 主要なコード一覧 | コード | 名称 | 略号(欧) | | :--- | :--- | :--- | | 01 | (抽) | (S) | | 03 | (父) | (D) | | 04 | (市) | (A) | | 05 | (地) | (R) | | 06 | (外) | (F) | | 21 | [地] | [R] | | 26 | [外] | [F] | | 00 | なし | - | enum: - '00' - '01' - '02' - '03' - '04' - '05' - '06' - '07' - '08' - '09' - '10' - '11' - '12' - '15' - '16' - '17' - '18' - '19' - '20' - '21' - '22' - '23' - '24' - '25' - '26' - '27' - '31' - '40' - '41' example: '06' maxLength: 2 SexCode: type: string description: |- 馬の性別を表すコード。年齢によって英語の呼称が異なります。人物の性別区分は `GenderCode` を使用します。 | コード | 名称 | 英語(0-4歳) | 英語(5歳-) | 説明 | | :--- | :--- | :--- | :--- | :--- | | 1 | 牡 | Colt (C) | Horse (H) | オス馬 | | 2 | 牝 | Filly (F) | Mare (M) | メス馬 | | 3 | せん | Gelding (G) | Gelding (G) | 去勢されたオス馬 | | 0 | 未設定 | - | - | 地方・海外等の初期値 | enum: - '0' - '1' - '2' - '3' example: '1' maxLength: 1 BreedCode: type: string description: |- 馬の品種を表すコード。 | コード | 名称 | 略称 | 内容 | | :--- | :--- | :--- | :--- | | 1 | サラブレッド | サラ | サラブレッドとして登録された馬。 | | 2 | サラブレッド系種 | サラ系 | アラブ血量が25%未満、または準サラ等。 | | 3 | 準サラブレッド | 準サラ | (旧規定) 現在はサラ系に統合。 | | 4 | 軽半血種 | 軽半 | 軽種と中半血種の交配など。 | | 5 | アングロアラブ | アア | アラブ血量25%以上。 | | 6 | アラブ系種 | アラ系 | アラブ血量25%以上（アアとは登録規定が異なる）。 | | 7 | アラブ | アラブ | 純血のアラブ。 | | 8 | 中半血種 | 中半 | 中間種相互の交配など。 | | 0 | 未設定 | - | 地方・海外等の初期値。 | enum: - '0' - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '8' example: '1' maxLength: 1 ColorCode: type: string description: |- 馬の毛色を表すコード。 | コード | 名称 | 英語名 | 略称 | | :--- | :--- | :--- | :--- | | 01 | 栗毛 | Chestnut | ch. | | 02 | 栃栗毛 | Dark Chestnut | d.ch. | | 03 | 鹿毛 | Bay | b. | | 04 | 黒鹿毛 | Dark Bay | d.b. | | 05 | 青鹿毛 | Brown | br. | | 06 | 青毛 | Black | bl. | | 07 | 芦毛 | Grey | g. | | 08 | 栗粕毛 | - | - | | 09 | 鹿粕毛 | - | - | | 10 | 青粕毛 | - | - | | 11 | 白毛 | White | w. | | 00 | 未設定 | - | - | enum: - '00' - '01' - '02' - '03' - '04' - '05' - '06' - '07' - '08' - '09' - '10' - '11' example: '03' maxLength: 2 LocationCode: type: string description: |- 所属するトレーニングセンターや地域を表すコード。 | コード | 名称1 | 名称2 | 説明 | | :--- | :--- | :--- | :--- | | 1 | 関東 | 美浦 | 美浦トレーニングセンター所属 | | 2 | 関西 | 栗東 | 栗東トレーニングセンター所属 | | 3 | 地方招待 | 招待 | 地方競馬からの招待 | | 4 | 外国招待 | 招待 | 外国からの招待 | | 0 | 未設定 | - | 地方・海外等の初期値 | enum: - '0' - '1' - '2' - '3' - '4' example: '1' maxLength: 1 TrainerId: type: string pattern: ^ch_[0-9]{5}$ example: ch_01124 description: >- Trainer entity ID。JV-Data CH レコード由来の調教師コード (5 桁)。フリー所属 (`Jockey.stableTrainerId`) を表す `ch_00000` (JV-Data 上の "ALL0" 相当) も pattern に合致する OwnerId: type: string pattern: ^bn_[0-9]{6}$ example: bn_537800 description: Owner entity ID。JV-Data BN レコード由来の馬主コード (6 桁) JockeyId: type: string pattern: ^ks_[0-9]{5}$ example: ks_05339 description: Jockey entity ID。JV-Data KS レコード由来の騎手コード (5 桁) JockeyApprenticeCode: type: string description: >- 騎手の減量特典（見習・女性騎手）を表すコード。 ### 記号と減量キロ数 | コード | 記号 | 減量 | 適用条件 (2023年以降の例) | | :--- | :--- | :--- | :--- | | 1 | ☆ | 1kg減 | 男性: 勝利数51-100回 かつ 免許5年未満 | | 2 | △ | 2kg減 | 男性: 勝利数31-50回 かつ 免許5年未満 | | 3 | ▲ | 3kg減 | 男性: 勝利数30回以下 かつ 免許5年未満 | | 4 | ★ | 4kg減 | 女性: 勝利数50回以下 かつ 免許5年未満 | | 9 | ◇ | 2kg減 | 女性: 勝利数101回以上 または 免許5年以上 | | 0 | なし | 0kg | 一般（減量特典なし） | ※女性騎手の場合、2023年1月以降は免許5年未満かつ51〜100勝で「★(4kg減)」が適用されるなど、男性騎手より優遇措置が大きくなっています。 ※障害競走や地方競馬からの招待など、条件により記号の意味が異なる場合があります。 enum: - '0' - '1' - '2' - '3' - '4' - '9' example: '3' maxLength: 1 AbnormalityCode: type: string description: |- 競走時の異常事態を表すコード。 | コード | 名称 | 略称 | 英語 | 内容 | | :--- | :--- | :--- | :--- | :--- | | 1 | 出走取消 | 取消 | SCRATCHED | 出走表確定後、馬の体調不良等で取りやめ。 | | 2 | 発走除外 | 発除 | EXCLUDED | 発走直前の放馬等による除外。 | | 3 | 競走除外 | 競除 | EXCLUDED | 審判員の判断による除外。 | | 4 | 競走中止 | 中止 | FALL TO FINISH | 落馬・故障等で完走できず。 | | 5 | 失格 | 失格 | DISQUALIFIED | 走行妨害や重量不足等による失格。 | | 6 | 落馬再騎乗 | 再騎 | REMOUNT | 落馬後に再度騎乗して完走（稀）。 | | 7 | 降着 | 降着 | DQ&P | 他馬の走行を妨害し、着順が下げられた場合。 | | 0 | 正常 | - | - | 正常に完走。 | enum: - '0' - '1' - '2' - '3' - '4' - '5' - '6' - '7' example: '0' maxLength: 1 MarginCode: type: string description: >- 前位の馬との着差を表す3バイトのコード。JV-Data 仕様書「2102.着差コード」に準拠。 ### コードの構成 - **1バイト目**: 整数部 (馬身) — `_` (0)、`1`〜`9`、`A` (アタマ)、`D` (同着)、`H` (ハナ)、`K` (クビ)、`T` (大差)、`Z` (10 馬身) - **2バイト目**: 分数の分子 — `_` (0) または `1`、`3` - **3バイト目**: 分数の分母 — `_` (0) または `2`、`4` ※ `_` は半角スペース(0x20)をアンダースコアに置換した表記です (JV-Data 仕様書 §2102 末尾の凡例に準拠、GradeCode と同じ方式)。 ### 中央競馬の基本パターン | コード | 名称 | 略称 | 欧字略名 | | :--- | :--- | :--- | :--- | | `___` | なし | - | - | | `_12` | 1/2 馬身 | 1/2 | 1/2 | | `_34` | 3/4 馬身 | 3/4 | 3/4 | | `1__` | 1 馬身 | 1 | 1 | | `112` | 1 1/2 馬身 | 1 1/2 | 1 1/2 | | `114` | 1 1/4 馬身 | 1 1/4 | 1 1/4 | | `134` | 1 3/4 馬身 | 1 3/4 | 1 3/4 | | `2__` | 2 馬身 | 2 | 2 | | `212` | 2 1/2 馬身 | 2 1/2 | 2 1/2 | | `3__` | 3 馬身 | 3 | 3 | | `312` | 3 1/2 馬身 | 3 1/2 | 3 1/2 | | `4__`〜`9__` | 4〜9 馬身 | 4〜9 | 4〜9 | | `A__` | アタマ | アタマ | HD | | `D__` | 同着 | 同着 | DH | | `H__` | ハナ | ハナ | NS | | `K__` | クビ | クビ | NK | | `T__` | 大差 | 大差 | DS | | `Z__` | 10 馬身 | 10 | 10 | ### 中央競馬以外で出現するパターン | コード | 名称 | | :--- | :--- | | `_14` | 1/4 馬身 | | `214` | 2 1/4 馬身 | | `734` | 7 3/4 馬身 | ※「短クビ」「短アタマ」のような着差は `K__`、`A__`、`H__` のいずれかが設定される (JV-Data 仕様) enum: - ___ - _12 - _14 - _34 - 1__ - '112' - '114' - '134' - 2__ - '212' - '214' - 3__ - '312' - 4__ - 5__ - 6__ - 7__ - '734' - 8__ - 9__ - A__ - D__ - H__ - K__ - T__ - Z__ x-fern-enum: ___: name: None description: 1着馬または未設定 (JV-Data 生値はスペース 0x20 × 3) _12: name: Half _14: name: Quarter _34: name: ThreeQuarter 1__: name: OneLength 2__: name: TwoLengths 3__: name: ThreeLengths 4__: name: FourLengths 5__: name: FiveLengths 6__: name: SixLengths 7__: name: SevenLengths 8__: name: EightLengths 9__: name: NineLengths A__: name: Head description: アタマ D__: name: DeadHeat description: 同着 H__: name: Nose description: ハナ K__: name: Neck description: クビ T__: name: DistanceLengths description: 大差 (10 馬身超) Z__: name: TenLengths description: 10 馬身 example: '112' maxLength: 3 FirstHorseInfo: type: object description: RaceEntry の 1着馬 (相手馬) 情報 (JV-Data SE レコード §60 由来)。自身が1着の場合は2着馬を設定 required: - horseId - name properties: horseId: $ref: '#/components/schemas/HorseId' name: type: string description: 1着馬 (相手馬) の馬名 (JV-Data SE レコード §60b 由来)。海外レースの外国馬は全角と半角が混在 example: ダノンデサイル maxLength: 36 Trainer: type: object description: 調教師データ。所属拠点 (locationCode) や本年・前年・通算成績を含みます。 required: - id - name properties: id: $ref: '#/components/schemas/TrainerId' dataType: type: string description: データ区分 (JV-Data CH レコード §2 由来)。1:新規登録, 2:更新, 0:該当レコード削除(提供ミスなどの理由による) example: '2' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data CH レコード §3 由来、Unix Timestamp) example: 1716715200 name: type: string description: 調教師名 (JV-Data CH レコード §9 由来、全角17文字。日本人調教師は姓+全角空白1文字+名、外国人調教師は連続17文字) example: 安田翔伍 maxLength: 34 nameKana: type: string description: 調教師名半角ｶﾅ (JV-Data CH レコード §10 由来、姓15文字+名15文字) example: ﾔｽﾀﾞ ｼｮｳｺﾞ maxLength: 30 nameAbbr: type: string description: 調教師名略称 (JV-Data CH レコード §11 由来、全角4文字) example: 安田翔 maxLength: 8 nameEng: type: string description: 調教師名欧字 (JV-Data CH レコード §12 由来、姓+半角空白+名のフルネーム) example: YASUDA Shogo maxLength: 80 birthday: type: string description: 生年月日 (JV-Data CH レコード §8 由来、yyyymmdd) example: '19811013' maxLength: 8 isRetired: type: boolean description: 調教師抹消区分 (JV-Data CH レコード §5 由来、true:抹消, false:現役) example: false licenseIssuedAt: type: string description: 調教師免許交付年月日 (JV-Data CH レコード §6 由来、yyyymmdd) example: '20140301' maxLength: 8 licenseRevokedAt: type: string description: 調教師免許抹消年月日 (JV-Data CH レコード §7 由来、yyyymmdd)。現役調教師は null example: null nullable: true maxLength: 8 genderCode: $ref: '#/components/schemas/GenderCode' locationCode: $ref: '#/components/schemas/LocationCode' invitationRegionName: type: string description: 招待地域名 (JV-Data CH レコード §15 由来、全角10文字) example: '' maxLength: 20 milestones: $ref: '#/components/schemas/TrainerMilestones' stats: $ref: '#/components/schemas/TrainerStats' createdAt: type: integer description: >- API 側の行作成タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (CH §3、データ作成年月日) とは独立した別軸 updatedAt: type: integer description: >- API 側の行更新タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (CH §3、データ作成年月日) とは独立した別軸 Owner: type: object description: 馬主データ。JV-Data BN レコード由来で、馬主名 (法人格有形式) や服色標示、本年・累計成績を含みます。 required: - id - name properties: id: $ref: '#/components/schemas/OwnerId' dataType: type: string description: データ区分 (JV-Data BN レコード §2 由来)。1:新規登録, 2:更新, 0:該当レコード削除(提供ミスなどの理由による) example: '2' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data BN レコード §3 由来、Unix Timestamp) example: 1716715200 name: type: string description: >- 馬主名 (法人格有のフルネーム形式)。JV-Data BN レコード §5 由来。短縮形 (法人格無) は `Owner.nameNoEntity` または `Horse.ownerName` を参照 example: （株）ダノックス maxLength: 64 nameNoEntity: type: string description: 馬主名 (法人格無、JV-Data BN レコード §6 由来)。株式会社等の法人格を示す文字列が頭または末尾にある場合に除去した短縮形 example: ダノックス maxLength: 64 nameKana: type: string description: 馬主名半角ｶﾅ (JV-Data BN レコード §7 由来、半角50文字)。外国馬主については設定されない example: ﾀﾞﾉｯｸｽ maxLength: 50 nameEng: type: string description: 馬主名欧字 (JV-Data BN レコード §8 由来、全角と半角が混在) example: Danox Co.,Ltd. maxLength: 100 colorsDescription: type: string description: 服色標示 (JV-Data BN レコード §9 由来、全角30文字、馬主毎に指定される騎手の勝負服の色・模様) example: 白，赤桃縦縞，赤袖 maxLength: 60 stats: $ref: '#/components/schemas/OwnerStats' createdAt: type: integer description: >- API 側の行作成タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (BN §3、データ作成年月日) とは独立した別軸 updatedAt: type: integer description: >- API 側の行更新タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (BN §3、データ作成年月日) とは独立した別軸 Jockey: type: object description: 騎手データ。免許情報や通算成績を含みます。 required: - id - name properties: id: $ref: '#/components/schemas/JockeyId' dataType: type: string description: データ区分 (JV-Data KS レコード §2 由来)。1:新規登録, 2:更新, 0:該当レコード削除(提供ミスなどの理由による) example: '2' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data KS レコード §3 由来、Unix Timestamp) example: 1716715200 name: type: string description: 騎手名 (JV-Data KS レコード §9 由来、全角17文字。日本人騎手は姓+全角空白1文字+名、外国人騎手は連続17文字) example: 横山典弘 maxLength: 34 nameKana: type: string description: 騎手名半角ｶﾅ (JV-Data KS レコード §11 由来、姓15文字+名15文字) example: ﾖｺﾔﾏ ﾉﾘﾋﾛ maxLength: 30 nameAbbr: type: string description: 騎手名略称 (JV-Data KS レコード §12 由来、全角4文字) example: 横山典 maxLength: 8 nameEng: type: string description: 騎手名欧字 (JV-Data KS レコード §13 由来、姓+半角空白+名のフルネーム) example: YOKOYAMA Norihiro maxLength: 80 birthday: type: string description: 生年月日 (JV-Data KS レコード §8 由来、yyyymmdd) example: '19680223' maxLength: 8 isRetired: type: boolean description: 騎手抹消区分 (JV-Data KS レコード §5 由来、true:抹消, false:現役) example: false licenseIssuedAt: type: string description: 騎手免許交付年月日 (JV-Data KS レコード §6 由来、yyyymmdd) example: '19850301' maxLength: 8 licenseRevokedAt: type: string description: 騎手免許抹消年月日 (JV-Data KS レコード §7 由来、yyyymmdd)。現役騎手は null example: null nullable: true maxLength: 8 genderCode: $ref: '#/components/schemas/GenderCode' qualificationCode: $ref: '#/components/schemas/JockeyQualificationCode' apprenticeCode: $ref: '#/components/schemas/JockeyApprenticeCode' locationCode: $ref: '#/components/schemas/LocationCode' invitationRegionName: type: string description: 招待地域名 (JV-Data KS レコード §18 由来、全角10文字) example: '' maxLength: 20 stableTrainerId: $ref: '#/components/schemas/TrainerId' stableTrainerNameAbbr: type: string description: 所属調教師名略称 (JV-Data KS レコード §20 由来、全角4文字)。フリー騎手の場合は空文字 example: 中川 公 maxLength: 8 milestones: $ref: '#/components/schemas/JockeyMilestones' stats: $ref: '#/components/schemas/JockeyStats' createdAt: type: integer description: >- API 側の行作成タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (KS §3、データ作成年月日) とは独立した別軸 updatedAt: type: integer description: >- API 側の行更新タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (KS §3、データ作成年月日) とは独立した別軸 Foal: type: object description: >- 産駒データ。競走馬登録前の個体情報と繁殖馬ベースの血統情報。`horseId` は競走馬マスタとの連携キーで、`Foal.id` (JV-Data SK §4 血統登録番号) と同値。産駒が競走馬として登録された時点で `Horse.id` と一致する (登録前は null) required: - id - birthday properties: id: $ref: '#/components/schemas/FoalId' dataType: type: string description: データ区分 (JV-Data SK レコード §2 由来)。1:新規登録, 2:更新, 0:該当レコード削除(提供ミスなどの理由による) example: '2' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data SK レコード §3 由来、Unix Timestamp) example: 1716715200 horseId: $ref: '#/components/schemas/HorseId' birthday: type: string description: 生年月日 (JV-Data SK レコード §5 由来、yyyymmdd 形式) example: '20210321' maxLength: 8 sexCode: $ref: '#/components/schemas/SexCode' breedCode: $ref: '#/components/schemas/BreedCode' colorCode: $ref: '#/components/schemas/ColorCode' importTypeCode: type: string description: >- 産駒持込区分 (JV-Data SK レコード §9 由来)。0:内国産, 1:持込, 2:輸入内国産扱い, 3:輸入。`Broodmare.importTypeCode` (HN §15 由来の繁殖馬持込区分) とは別フィールド example: '0' maxLength: 1 importYear: type: integer description: 輸入年 (JV-Data SK レコード §10 由来、西暦4桁)。内国産は 0 example: 0 breederId: $ref: '#/components/schemas/BreederId' originName: type: string description: 産地名 (JV-Data SK レコード §12 由来、全角10文字) example: 千歳市 maxLength: 20 pedigreeBroodmareIds: type: array description: >- 3代血統情報の繁殖登録番号リスト (JV-Data SK レコード §13 由来)。固定 14 要素で、順序は 父, 母, 父父, 父母, 母父, 母母, 父父父, 父父母, 父母父, 父母母, 母父父, 母父母, 母母父, 母母母 items: $ref: '#/components/schemas/BroodmareId' minItems: 14 maxItems: 14 example: - hn_0000123456 - hn_0000234567 - hn_0000345678 - hn_0000456789 - hn_0000567890 - hn_0000678901 - hn_0000789012 - hn_0000890123 - hn_0000901234 - hn_0001012345 - hn_0001123456 - hn_0001234567 - hn_0001345678 - hn_0001456789 createdAt: type: integer description: >- API 側の行作成タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (SK §3、データ作成年月日) とは独立した別軸 updatedAt: type: integer description: >- API 側の行更新タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (SK §3、データ作成年月日) とは独立した別軸 Training: type: object description: >- 坂路調教タイムデータ (JV-Data HC レコード由来)。JRA トレセン (美浦/栗東) の坂路コースでの追い切り情報。ウッドチップ調教は `WoodChipTraining` schema を参照 required: - id - horseId - trainingDate properties: id: $ref: '#/components/schemas/TrainingId' dataType: type: string description: データ区分 (JV-Data HC レコード §2 由来)。1:初期値, 0:該当レコード削除(提供ミスなどの理由による) example: '1' maxLength: 1 dataUpdatedAt: type: integer description: データ作成日時 (JV-Data HC レコード §3 由来、Unix Timestamp) example: 1716715200 horseId: $ref: '#/components/schemas/HorseId' trainingCenterCode: type: string description: トレセン区分 (JV-Data HC レコード §4 由来)。0:美浦, 1:栗東 example: '1' maxLength: 1 trainingDate: type: string description: 調教年月日 (yyyymmdd 形式、JV-Data HC レコード §5 由来) example: '20240522' minLength: 8 maxLength: 8 pattern: ^[0-9]{8}$ trainingTime: type: string description: 調教時刻 (hhmm 形式、JV-Data HC レコード §6 由来) example: '0715' minLength: 4 maxLength: 4 pattern: ^([01][0-9]|2[0-3])[0-5][0-9]$ times: type: object description: >- ハロン合計タイム (単位: 秒)。`fN` は N ハロン地点 (200m × N) から終点までの累積タイム。JV-Data 原値が `0000` (測定不良) の場合は該当 key が省略される properties: f4: type: number description: 4 ハロン合計 (800m 地点から終点まで、JV-Data HC レコード §8 由来) example: 52.4 f3: type: number description: 3 ハロン合計 (600m 地点から終点まで、JV-Data HC レコード §10 由来) example: 38.1 f2: type: number description: 2 ハロン合計 (400m 地点から終点まで、JV-Data HC レコード §12 由来) example: 24.5 lapTimes: type: array description: >- 200m ごとのラップタイム (単位: 秒、JV-Data HC レコード §14/§13/§11/§9 由来)。区間順 [200M-0M, 400M-200M, 600M-400M, 800M-600M] (終点側から起点側、最終 200m が先頭)、最大 4 要素。JV-Data 原値が `000` (測定不良) の場合は該当区間が省略される items: type: number maxItems: 4 example: - 12.2 - 12.3 - 13.6 - 14.3 createdAt: type: integer description: >- API 側の行作成タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (HC §3、データ作成年月日) とは独立した別軸 updatedAt: type: integer description: >- API 側の行更新タイムスタンプ (Unix 秒、内部管理メタデータ)。JV-Data 由来の `dataUpdatedAt` (HC §3、データ作成年月日) とは独立した別軸 ErrorResponse: type: object description: >- エラーレスポンスの共通ラッパー。すべての 4xx / 5xx で同一構造を返します。トップレベルの `error` フィールドに、プログラム判定用の `code`、人間向け `message`、問い合わせ追跡用の `requestId` を入れます。 required: - error properties: error: type: object required: - code - message properties: code: type: string description: エラーコード。プログラムで判定可能な SCREAMING_SNAKE_CASE 文字列 example: UNAUTHORIZED message: type: string description: エラーの内容（人間向けメッセージ） example: 有効なAPIアクセスキーが必要です。 requestId: type: string description: 問い合わせ用ID example: req_abcd1234 GenderCode: type: string description: |- 騎手・調教師など人物の性別区分。馬の性別を表す `SexCode` とは別の code table に基づきます。 | コード | 名称 | | :--- | :--- | | 1 | 男性 | | 2 | 女性 | | 0 | 未設定 | enum: - '0' - '1' - '2' example: '1' maxLength: 1 TrainerMilestones: type: object description: >- 調教師のマイルストーン記録 (JV-Data CH レコード項番16 由来)。event 1 件分の primitive (`GradedWin`) は Jockey 側と $ref 共有する一方、top-level の `TrainerMilestones` は entity 別に分離 (`JockeyMilestones` とは別 schema) properties: recentGradedWins: type: array description: 最近の重賞勝利情報 (JV-Data CH レコード項番16 由来)。新しい順に保持 items: $ref: '#/components/schemas/GradedWin' TrainerStats: type: object description: 調教師の年度別成績情報 (JV-Data CH レコード項番17 由来)。本年・前年・累計の 3 周期分を保持する。 properties: thisYear: $ref: '#/components/schemas/TrainerPeriod' lastYear: $ref: '#/components/schemas/TrainerPeriod' total: $ref: '#/components/schemas/TrainerPeriod' OwnerStats: type: object description: >- 馬主の本年・累計成績情報 (JV-Data BN レコード項番10 由来、60 byte × 2 周期)。`thisYear` は本年成績、`total` は累計成績。 properties: thisYear: $ref: '#/components/schemas/OwnerPeriod' total: $ref: '#/components/schemas/OwnerPeriod' JockeyQualificationCode: type: string description: |- 騎手の騎乗資格（免許種別）を表すコード。 | コード | 内容 | 説明 | | :--- | :--- | :--- | | 1 | 平地 | 平地競走のみ騎乗可能 | | 2 | 障害 | 障害競走のみ騎乗可能 | | 3 | 平・障 | 平地・障害の両方に騎乗可能 | | 0 | なし | 未設定・未整備時の初期値 | enum: - '0' - '1' - '2' - '3' example: '3' maxLength: 1 JockeyMilestones: type: object description: >- 騎手のマイルストーン記録 (JV-Data KS レコード項番21-23 由来)。event 1 件分の primitive (`FirstRide` / `FirstWin` / `GradedWin`) は Trainer 側と $ref 共有する一方、top-level の `JockeyMilestones` は entity 別に分離 (`TrainerMilestones` とは別 schema) properties: firstRide: type: object description: >- 初騎乗情報 (JV-Data KS レコード項番21 由来)。平地・障害でそれぞれ最大 1 件保持。該当競走が未経験の場合は対応 key を省略 properties: flat: $ref: '#/components/schemas/FirstRide' obstacle: $ref: '#/components/schemas/FirstRide' firstWin: type: object description: >- 初勝利情報 (JV-Data KS レコード項番22 由来)。平地・障害でそれぞれ最大 1 件保持。該当競走が未勝利の場合は対応 key を省略 properties: flat: $ref: '#/components/schemas/FirstWin' obstacle: $ref: '#/components/schemas/FirstWin' recentGradedWins: type: array description: 最近の重賞勝利情報 (JV-Data KS レコード項番23 由来)。新しい順に保持 items: $ref: '#/components/schemas/GradedWin' JockeyStats: type: object description: 騎手の年度別成績情報 (JV-Data KS レコード項番24 由来)。本年・前年・累計の 3 周期分を保持する。 properties: thisYear: $ref: '#/components/schemas/JockeyPeriod' lastYear: $ref: '#/components/schemas/JockeyPeriod' total: $ref: '#/components/schemas/JockeyPeriod' FoalId: type: string pattern: ^sk_[0-9]{10}$ example: sk_2021105477 description: Foal entity ID。JV-Data SK レコード由来 (産駒マスタ、血統登録番号 10 桁) BreederId: type: string pattern: ^br_[0-9]{8}$ example: br_00010521 description: Breeder entity ID。JV-Data BR レコード由来の生産者コード (v4.9 で 6→8 byte 拡張) BroodmareId: type: string pattern: ^hn_[0-9]{10}$ example: hn_1234567890 description: >- Broodmare entity ID。JV-Data HN レコード由来の繁殖登録番号 (v4.9 で 8→10 桁拡張)。`PedigreeAncestor.id` も同 namespace を共有する TrainingId: type: string pattern: ^hc_[0-9]{23}$ example: hc_12024052207152021105477 description: >- Training record ID。JV-Data HC レコード由来 (坂路調教、トレセン区分 1 桁 + 調教年月日 8 桁 + 調教時刻 4 桁 + 血統登録番号 10 桁、合計 23 桁)。トレセン区分は 0:美浦 / 1:栗東 GradedWin: type: object description: >- 重賞勝利 1 件分の event record (JV-Data KS レコード項番23 / CH レコード項番16 由来)。Jockey/Trainer 間で $ref 共有する entity 横断 primitive。競走名 4 variants は Race entity の `title` 慣習に揃え `raceTitle` 系列で flat sibling として保持する (group 化しない) properties: raceId: $ref: '#/components/schemas/RaceId' raceTitle: type: string description: 競走名本題 example: 東京優駿 maxLength: 60 raceTitleShort10: type: string description: 競走名略称10文字 example: 日本ダービー maxLength: 20 raceTitleShort6: type: string description: 競走名略称6文字 example: ダービー maxLength: 12 raceTitleShort3: type: string description: 競走名略称3文字 example: ダービー maxLength: 6 gradeCode: $ref: '#/components/schemas/GradeCode' fieldSize: type: integer description: 出走頭数 example: 18 horseId: $ref: '#/components/schemas/HorseId' horseName: type: string description: 馬名 example: ドウデュース maxLength: 36 TrainerPeriod: type: object description: >- 調教師の 1 周期分 (本年 / 前年 / 累計) の成績。中央のみのカウント (`earnings: { baseFlat, baseObstacle, addedFlat, addedObstacle }`、`placings: { flat[6], obstacle[6], byVenue, byDistance }`)。 properties: year: type: integer description: 成績情報に設定されている年度 (西暦) example: 2024 earnings: type: object description: 賞金合計 (円単位)。CH は平地/障害 × 本/付加 の 4 通り properties: baseFlat: type: integer description: 平地本賞金合計 (円) baseObstacle: type: integer description: 障害本賞金合計 (円) addedFlat: type: integer description: 平地付加賞金合計 (円) addedObstacle: type: integer description: 障害付加賞金合計 (円) placings: type: object description: 着回数群 (各 array は [1着, 2着, 3着, 4着, 5着, 着外] の固定 6 要素) properties: flat: type: array description: 平地着回数 items: type: integer minItems: 6 maxItems: 6 obstacle: type: array description: 障害着回数 items: type: integer minItems: 6 maxItems: 6 byVenue: type: object description: 競馬場別着回数 (中央 10 場 × 平地/障害) properties: sapporo: $ref: '#/components/schemas/VenuePlacings' hakodate: $ref: '#/components/schemas/VenuePlacings' fukushima: $ref: '#/components/schemas/VenuePlacings' niigata: $ref: '#/components/schemas/VenuePlacings' tokyo: $ref: '#/components/schemas/VenuePlacings' nakayama: $ref: '#/components/schemas/VenuePlacings' chukyo: $ref: '#/components/schemas/VenuePlacings' kyoto: $ref: '#/components/schemas/VenuePlacings' hanshin: $ref: '#/components/schemas/VenuePlacings' kokura: $ref: '#/components/schemas/VenuePlacings' byDistance: type: object description: >- 距離別着回数 ({surface}UpTo1600 / {surface}1601To2200 / {surface}2201Plus の 3 段 bucket) properties: turfUpTo1600: type: array description: 芝・1600m以下 items: type: integer minItems: 6 maxItems: 6 turf1601To2200: type: array description: 芝・1601-2200m items: type: integer minItems: 6 maxItems: 6 turf2201Plus: type: array description: 芝・2201m以上 items: type: integer minItems: 6 maxItems: 6 dirtUpTo1600: type: array description: ダート・1600m以下 items: type: integer minItems: 6 maxItems: 6 dirt1601To2200: type: array description: ダート・1601-2200m items: type: integer minItems: 6 maxItems: 6 dirt2201Plus: type: array description: ダート・2201m以上 items: type: integer minItems: 6 maxItems: 6 OwnerPeriod: type: object description: >- 馬主の 1 周期分 (本年 or 累計) の成績 (`earnings: { base, added }`、`placings: int[6]`)。 properties: year: type: integer description: 設定年 (西暦) example: 2024 earnings: type: object description: 賞金合計 (円単位)。BN/BR は平地/障害の breakdown を持たないため `{ base, added }` のみ properties: base: type: integer description: 本賞金合計 (円単位) example: 12345600 added: type: integer description: 付加賞金合計 (円単位) example: 1234560 placings: type: array description: 中央のみの着回数 [1着, 2着, 3着, 4着, 5着, 着外] の固定 6 要素 items: type: integer minItems: 6 maxItems: 6 example: - 10 - 8 - 5 - 4 - 3 - 100 FirstRide: type: object description: >- 初騎乗 1 件分の event record (JV-Data KS レコード項番21 由来)。`Jockey.milestones.firstRide` の inner shape として平地/障害それぞれ最大 1 件保持される entity 横断 primitive。完走しなかった場合 (取消・除外・中止・失格) は `irregularStatus` に該当コードが入り、`finishPosition` は 0 となる。正常完走 (`irregularStatus = 0`) または未設定の場合、`irregularStatus` プロパティは response から省略される properties: raceId: $ref: '#/components/schemas/RaceId' fieldSize: type: integer description: 出走頭数 example: 16 horseId: $ref: '#/components/schemas/HorseId' horseName: type: string description: 馬名 example: ドウデュース maxLength: 36 finishPosition: type: integer description: 確定着順 (1-18)。`irregularStatus` が設定された場合は 0 example: 5 irregularStatus: $ref: '#/components/schemas/AbnormalityCode' FirstWin: type: object description: >- 初勝利 1 件分の event record (JV-Data KS レコード項番22 由来)。`Jockey.milestones.firstWin` の inner shape として平地/障害それぞれ最大 1 件保持される entity 横断 primitive。1 着確定のため `finishPosition` / `irregularStatus` は持たない properties: raceId: $ref: '#/components/schemas/RaceId' fieldSize: type: integer description: 出走頭数 example: 16 horseId: $ref: '#/components/schemas/HorseId' horseName: type: string description: 馬名 example: ドウデュース maxLength: 36 JockeyPeriod: type: object description: >- 騎手の 1 周期分 (本年 / 前年 / 累計) の成績。中央のみのカウント (`earnings: { baseFlat, baseObstacle, addedFlat, addedObstacle }`、`placings: { flat[6], obstacle[6], byVenue, byDistance }`)。 properties: year: type: integer description: 成績情報に設定されている年度 (西暦) example: 2024 earnings: type: object description: 賞金合計 (円単位)。KS は平地/障害 × 本/付加 の 4 通り properties: baseFlat: type: integer description: 平地本賞金合計 (円) baseObstacle: type: integer description: 障害本賞金合計 (円) addedFlat: type: integer description: 平地付加賞金合計 (円) addedObstacle: type: integer description: 障害付加賞金合計 (円) placings: type: object description: 着回数群 (各 array は [1着, 2着, 3着, 4着, 5着, 着外] の固定 6 要素) properties: flat: type: array description: 平地着回数 items: type: integer minItems: 6 maxItems: 6 obstacle: type: array description: 障害着回数 items: type: integer minItems: 6 maxItems: 6 byVenue: type: object description: 競馬場別着回数 (中央 10 場 × 平地/障害) properties: sapporo: $ref: '#/components/schemas/VenuePlacings' hakodate: $ref: '#/components/schemas/VenuePlacings' fukushima: $ref: '#/components/schemas/VenuePlacings' niigata: $ref: '#/components/schemas/VenuePlacings' tokyo: $ref: '#/components/schemas/VenuePlacings' nakayama: $ref: '#/components/schemas/VenuePlacings' chukyo: $ref: '#/components/schemas/VenuePlacings' kyoto: $ref: '#/components/schemas/VenuePlacings' hanshin: $ref: '#/components/schemas/VenuePlacings' kokura: $ref: '#/components/schemas/VenuePlacings' byDistance: type: object description: >- 距離別着回数 ({surface}UpTo1600 / {surface}1601To2200 / {surface}2201Plus の 3 段 bucket) properties: turfUpTo1600: type: array description: 芝・1600m以下 items: type: integer minItems: 6 maxItems: 6 turf1601To2200: type: array description: 芝・1601-2200m items: type: integer minItems: 6 maxItems: 6 turf2201Plus: type: array description: 芝・2201m以上 items: type: integer minItems: 6 maxItems: 6 dirtUpTo1600: type: array description: ダート・1600m以下 items: type: integer minItems: 6 maxItems: 6 dirt1601To2200: type: array description: ダート・1601-2200m items: type: integer minItems: 6 maxItems: 6 dirt2201Plus: type: array description: ダート・2201m以上 items: type: integer minItems: 6 maxItems: 6 GradeCode: type: string description: |- 競走のグレードを表すコード。 | コード | 内容 | 欧字表記 | | :--- | :--- | :--- | | A | G1（平地） | G1 | | B | G2（平地） | G2 | | C | G3（平地） | G3 | | D | グレードのない重賞 | - | | E | 重賞以外の特別競走 | - | | F | J・G1（障害） | J・G1 | | G | J・G2（障害） | J・G2 | | H | J・G3（障害） | J・G3 | | L | L（リステッド） | L | | _ | 一般競走 または 未設定 | - | ※ `_` は半角スペース(0x20)をアンダースコアに置換しています。 enum: - A - B - C - D - E - F - G - H - L - _ x-fern-enum: _: name: Open description: 一般競走 または 未設定 (元の JV-Data コードは半角スペース 0x20) example: A maxLength: 1 VenuePlacings: type: object description: >- 競馬場 1 場分の平地・障害着回数 (各 array は [1着, 2着, 3着, 4着, 5着, 着外] の固定 6 要素)。KS/CH 間で $ref 共有する entity 横断 primitive。 properties: flat: type: array description: 平地 items: type: integer minItems: 6 maxItems: 6 obstacle: type: array description: 障害 items: type: integer minItems: 6 maxItems: 6 responses: BadRequest: description: リクエストの構文エラーや型不整合 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: BAD_REQUEST message: リクエストの形式が正しくありません。 Unauthorized: description: >- 認証エラー（APIキー未設定、または無効）。`Authorization: Bearer ` を必ず付与してください。失敗理由（キー欠落 / 不明 / 失効）は同一 body で返します。 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHORIZED message: 有効なAPIキーが必要です。 NotFound: description: リソースが見つからない場合 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: NOT_FOUND message: 指定されたIDのリソースが見つかりませんでした。 InternalServerError: description: サーバー内部エラー content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: INTERNAL_SERVER_ERROR message: サーバー内部で予期せぬエラーが発生しました。 securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- APIダッシュボードで発行された `sk_live_...` または `sk_test_...` キーを入力してください。prefix は mode を示し、両 mode とも同じ API URL で利用できます (`sk_live_*` = live mode / 本番、`sk_test_*` = test mode / 開発・自動テスト)。 ````