Skip to main content
GET
レース一覧

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

date
string<date>

指定した日で絞り込み

from
string<date>

期間指定(開始)

to
string<date>

期間指定(終了)

courseCode
enum<string>

競馬場および国コード。JRA、地方競馬(NAR)、海外を網羅します。

主要なコード一覧

海外主要国例:

  • A2: 日本 (Japan)
  • A4: アメリカ (USA)
  • A6: イギリス (GB)
  • A8: フランス (FR)
  • G0: 香港 (HK)
  • C7: UAE (UAE)

※全コードの詳細はJV-Data仕様に準拠します。未設定時は 00 が返ります。

Available options:
00,
01,
02,
03,
04,
05,
06,
07,
08,
09,
10,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44,
45,
46,
47,
48,
49,
50,
51,
52,
53,
54,
55,
56,
57,
58,
59,
60,
61,
A0,
A2,
A4,
A6,
A8,
B0,
B2,
B4,
B6,
B8,
C0,
C2,
C5,
C6,
C7,
C8,
D0,
D2,
D4,
D6,
D8,
E0,
E2,
E4,
E6,
E8,
F0,
F1,
F2,
F8,
G0,
G2,
H0,
H2,
H4,
H6,
H8,
I0,
I2,
I4,
I6,
I8,
J0,
J2,
J4,
J6,
J8,
K0,
K2,
K4,
K6,
K8,
L0,
L2,
L4,
L6,
L8,
M0,
M2,
M4,
M6,
M8,
N0,
N2,
N4,
N6
Maximum string length: 2
Example:

"05"

gradeCode
enum<string>

競走のグレードを表すコード。

_ は半角スペース(0x20)をアンダースコアに置換しています。

Available options:
A,
B,
C,
D,
E,
F,
G,
H,
L,
_
Maximum string length: 1
Example:

"A"

typeCode
enum<string>

競走の年齢・品種種別を表すコード。

※2000年以前のデータは「数え年」表記のため、上記名称より年齢が1つ上がります(例: 11はサラ系3歳)

Available options:
11,
12,
13,
14,
18,
19,
21,
22,
23,
24,
00
Maximum string length: 2
Example:

"14"

signCode
enum<string>

競走の条件(産地・性別・交流制限など)を表す3バイトのコード。JV-Data 仕様書「2006.競走記号コード」に準拠。

コードの構成

このコードは3バイトで構成され、各バイトが独立した属性を表します。

主要な記号の意味

代表的なコード例

※未設定時は 000 が返ります。

Available options:
000,
001,
002,
003,
004,
020,
021,
023,
024,
030,
031,
033,
034,
040,
041,
043,
044,
A00,
A01,
A02,
A03,
A04,
A10,
A11,
A13,
A14,
A20,
A21,
A23,
A24,
A30,
A31,
A33,
A34,
A40,
A41,
B00,
B01,
B03,
B04,
C00,
C01,
C03,
C04,
D00,
D01,
D03,
E00,
E01,
E03,
F00,
F01,
F03,
F04,
G00,
G01,
G03,
H00,
H01,
I00,
I01,
I03,
J00,
J01,
K00,
K01,
K03,
L00,
L01,
L03,
M00,
M01,
M03,
M04,
N00,
N01,
N03,
N04,
N20,
N21,
N23,
N24,
N30,
N31,
N40,
N41,
N44
Maximum string length: 3
Example:

"A41"

trackCode
enum<string>

コースの種類と形状を表すコード。

分類ガイド

  • 10番台: 芝 (Turf)
  • 20番台: ダート (Dirt)
  • 50番台: サンド (Sand)
  • 00/29: 障害・特殊

主要なコード一覧

※詳細はJV-Data仕様書「2009.トラックコード」を参照してください

Available options:
00,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
51,
52,
53,
54,
55,
56,
57,
58,
59
Maximum string length: 2
Example:

"17"

distance
string

距離 (例: 1800、3〜5 桁の数値文字列)

Maximum string length: 5
Pattern: ^[0-9]{3,5}$
sort
string

ソート順(- を付けると降順)

Maximum string length: 100
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
limit
integer
default:100

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

Required range: 1 <= x <= 1000
page
integer
default:1

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

Required range: 1 <= x <= 10000

Response

Success

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

code
string
required

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

Example:

"SUCCESS"

data
object[]
required

取得されたデータ本体

extensions
object

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