---
title: "Blackbook"
method: GET
path: "/v2/User/Blackbook"
tags: ["User"]
---

# Blackbook

`GET /v2/User/Blackbook`

A list of blackbook runners indicating upcoming runners that are in the blackbook.
            
            Available to Starter subscriptions and up.

## Query parameters

- `upcomingOnly` boolean
- `stage` 0 | 1 | 2 | 3 | 4
- `apiKey` string, required

## Response `200`

OK

- BlackbookListApiResponse
  - `statusCode` integer
  - `status` 0 | 1 | 2 | 3 | 4 | 99
  - `error` string, nullable
  - `errors` object, nullable
  - `payLoad` Blackbook[], nullable
    - `runnerName` string, nullable — Name of the runner that is in the blackbook.
    - `runnerId` integer — Id of the runner that is in the blackbook.
    - `dateAdded` string, date-time — Time stamp of when the runner was added to the blackbook.
    - `expiry` string, nullable — The expiry policy on this blackbook entry.
    - `notes` string, nullable — Any notes made against the blackbook entry.
    - `hasUpcoming` boolean — Indicates whether or not the runner in the blackbook has any upcoming runs.
    - `upcomingRuns` UpcomingRun[], nullable — A list of upcoming runs for the runner in the blackbook entry.
      - `startTime` string, date-time — The date and time of the run local to the time zone of the track.
      - `startTimeUTC` string, date-time — The data and time of the run in UTC.
      - `track` string, nullable — The track where the blackbooked runner is running.
      - `raceNo` integer — The race number.
      - `jockey` string, nullable — The jockey of the runner if one is nominated.
      - `trainer` string, nullable — The trainer of the runner.
      - `stage` string, nullable — The stage of form release for the runner: Nominations = 1, Weights = 2, Acceptances = 3.
  - `processTime` integer
  - `timeStamp` string, date-time

---

[API](https://skmtc.net/puntingform/apis/public-api-v2.md) · [All operations](https://skmtc.net/puntingform/apis/public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/puntingform/public-api-v2/revisions/b7d122ef3977/schema)