Skip to main content
GET
/
broodmares
/
{broodmareId}
繁殖馬詳細
curl --request GET \
  --url https://api.beter-keiba.com/v1/broodmares/{broodmareId} \
  --header 'Authorization: Bearer <token>'
{
  "code": "SUCCESS",
  "data": {
    "id": "hn_1234567890",
    "dataType": "2",
    "dataUpdatedAt": 1716715200,
    "horseId": "um_2021105477",
    "name": "トップデサイル",
    "nameKana": "トップデサイル",
    "nameEng": "Top Decile",
    "birthYear": 2010,
    "sexCode": "1",
    "breedCode": "1",
    "colorCode": "03",
    "importTypeCode": "3",
    "importYear": 0,
    "originName": "アメリカ",
    "sireBroodmareId": "hn_1234567890",
    "damBroodmareId": "hn_1234567890",
    "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

broodmareId
string
required

Broodmare entity ID。JV-Data HN レコード由来の繁殖登録番号 (v4.9 で 8→10 桁拡張)。PedigreeAncestor.id も同 namespace を共有する

Pattern: ^hn_[0-9]{10}$
Example:

"hn_1234567890"

Query Parameters

fields
string

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

Maximum string length: 500

Response

Success

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

code
string
required

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

Example:

"SUCCESS"

data
object
required

繁殖馬データ。血統管理のためのマスタ。horseId は JV-Data HN レコード §6 由来の血統登録番号 (外国の繁殖馬等で初期値の場合は null)。sireBroodmareId / damBroodmareId は HN §18 / §19 由来の父馬 / 母馬繁殖登録番号

extensions
object

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