Skip to main content
GET
/
owners
/
{ownerId}
馬主詳細
curl --request GET \
  --url https://api.beter-keiba.com/v1/owners/{ownerId} \
  --header 'Authorization: Bearer <token>'
{
  "code": "SUCCESS",
  "data": {
    "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
  }
}

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

ownerId
string
required

Owner entity ID。JV-Data BN レコード由来の馬主コード (6 桁)

Pattern: ^bn_[0-9]{6}$
Example:

"bn_537800"

Query Parameters

fields
string

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

Maximum string length: 500

Response

Success

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

code
string
required

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

Example:

"SUCCESS"

data
object
required

馬主データ。JV-Data BN レコード由来で、馬主名 (法人格有形式) や服色標示、本年・累計成績を含みます。

extensions
object

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