---
title: "Scratchings"
method: GET
path: "/v2/Updates/Scratchings"
tags: ["Updates"]
---

# Scratchings

`GET /v2/Updates/Scratchings`

Returns all upcoming scratchings, with time stamps and deductions.
            
            Available to Starter subscriptions and up.

## Query parameters

- `jurisdiction` 0 | 1 | 2
- `apiKey` string, required

## Response `200`

OK

- ScratchingListApiResponse
  - `statusCode` integer
  - `status` 0 | 1 | 2 | 3 | 4 | 99
  - `error` string, nullable
  - `errors` object, nullable
  - `payLoad` Scratching[], nullable
    - `meetingId` string, nullable — The Punting Form idenfier for the Meeting.
    - `raceId` string, nullable — The Punting Form idenfier for the Race.
    - `runnerId` string, nullable — The Punting Form idenfier for the runner.
    - `meetingDate` string, nullable — The date of the Meeting as per the local time zone.
    - `meetingDateUTC` string, date-time, nullable — The date of the Meeting as a UTC time.
    - `track` string, nullable — The Track where the Meeting takes place.
    - `raceNo` integer — The number of the Race.
    - `tabNo` integer — The TabNo of the Scratched competitor.
    - `timeStamp` string, date-time — The time that the Scratching was created.
    - `deduction` number, double — The amount of deduction that should be applied as a result of this Scratching.
    - `country` string, nullable — The Country where the Meeting is being held.
    - `code` string, nullable — Thouroughbreds, Harness, Greyhounds.
  - `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)