--- title: "Fields" method: GET path: "/v2/form/fields" tags: ["Forms"] --- # Fields `GET /v2/form/fields` Returns the Fields for a race of meeting. Available to Starter subscriptions and up. ## Query parameters - `meetingId` integer, required - `raceNumber` integer - `apiKey` string, required ## Response `200` OK - MeetingApiResponse - `statusCode` integer - `status` 0 | 1 | 2 | 3 | 4 | 99 - `error` string, nullable - `errors` object, nullable - `payLoad` Meeting — A single race meeting. - `track` Track — Details of a race Track. Track names and abbreviations are supplied as per the official Racing Australia data. Track names can occasionally change over time, however, the TrackId will always remain the same. - `name` string, nullable — The offical name of the Track at the current time. - `trackId` string, nullable — Punting Form identifier for the Track. - `location` string, nullable — Location catagorization for the track: C - Country, P - Provincial, M - Metro. - `state` string, nullable — For Australian Tracks, the state that the track is in. - `country` string, nullable — Country of the Track. - `abbrev` string, nullable — Offical abbreviation of the Track. - `surface` string, nullable — The current surface of the Track. - `races` Race[], nullable — A list of Races for the meeting. - `runners` Runner[], nullable — A list of runners competing in the Race. - `trainer` Trainer — The Trainer of a runner. - `fullName` string, nullable — Name of the Trainer. - `trainerId` string, nullable — Punting Form identifier for the Trainer. - `location` string, nullable — The main location that the Trainer trains out of. - `jockey` Jockey — Describes a Jockey. - `fullName` string, nullable — Name of the Jockey. - `jockeyId` string, nullable — Punting Form identifier of the Jockey. - `ridingWeight` number, double — The minimum weight at which the Jockey can currently ride. - `claim` number, double — Any weight claim that the Jockey can make as an apprentice. - `isApprentice` boolean — Indicates whether or not the Jockey is an apprentice. - `name` string, nullable — The current name of the Runner. - `country` string, nullable — Country of origin of the Runner. - `age` integer — The age of the Runner as per offical Runner birthdays. i.e. not the actual age of the Runner. - `sex` string, nullable — Sex of the Runner. - `runnerId` string, nullable — Punting Form identifier for the Runner. - `foalDate` string, date-time — The actual birthdate of the Runner. - `sire` string, nullable — The sire of the Runner. - `sireCountry` string, nullable — Country of origin for the sire of the Runner. - `dam` string, nullable — The dam of the Runner. - `damCountry` string, nullable — Country of origin for the dam of the Runner. - `sireofDam` string, nullable — The sire of the Runner's dam. - `sireofDamCountry` string, nullable — Country of origin for the sire of the Runner's dam. - `prizeMoney` integer — Total career prize money of the Runner in the currency local to where that Runner runs. - `careerStarts` integer — Total career starts for the Runner. - `careerWins` integer — Total career wins. - `careerSeconds` integer — Total career seconds. - `careerThirds` integer — Total career thirds. - `colour` string, nullable — Official colour of the Runner. - `silkColours` string, nullable — Current silk colours worn by the Runner's Jockey. - `owners` string, nullable — Current registered owners of the Runner. - `barrier` integer — Barrier the Runner has drawn in current Race. - `tabNo` integer — TAB number of the Runner in the current Race - `ballotNumber` integer — Ballot number is used at nominations and weight stages of Form delivery. Represents the order of the Runner with lower ballot numbers meaning the Runner is more likely to gain a run in the Race. - `weight` number, double — Weight carried in the current Race. - `position` integer — Finish position in the current Race. - `margin` number, double — Margin in the current Race. - `priceSP` number, double — Official starting price. - `handicapRating` number, double — Offical handicap rating for the Runner in the current Race. - `last10` string, nullable — Last 10 run results. i.e. 5x1149x21409 - `winPct` number, double — Career win percentage of the Runner. - `placePct` number, double — Career place percentage of the Runner. - `trackRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `distanceRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `trackDistRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `group1Record` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `group2Record` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `group3Record` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `firmRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `goodRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `softRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `heavyRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `syntheticRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `jumpsRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `firstUpRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `secondUpRecord` Record — Record of Runner in a given situation. i.e. First up, Goood tracks, etc. - `recordType` string, nullable — Label for the type or Record. - `starts` integer — Number of starts. - `firsts` integer — Number of wins. - `seconds` integer — Number of seconds. - `thirds` integer — Number of thirds. - `trainerA2E_Career` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `jockeyA2E_Career` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `trainerJockeyA2E_Career` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `trainerA2E_Last100` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `jockeyA2E_Last100` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `trainerJockeyA2E_Last100` A2ERecord — An A2E record of a Trainer, Jockey or combination of Trainer and Jockey. - `jockey` string, nullable — Name of the Jockey. - `trainer` string, nullable — Name of the Trainer. - `a2E` number, double — The actual to expected value. - `poT` number, double — The profit on turnover. - `strikeRate` number, double — Strike rate for the record. - `wins` integer — Number of wins in the category. - `runners` integer — Number of runners in the category. - `forms` Form[], nullable — A list of historical form information for the runner. Will return up to 10 pervious runs. - `meetingDate` string, date-time — 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` Track — Details of a race Track. Track names and abbreviations are supplied as per the official Racing Australia data. Track names can occasionally change over time, however, the TrackId will always remain the same. - `name` string, nullable — The offical name of the Track at the current time. - `trackId` string, nullable — Punting Form identifier for the Track. - `location` string, nullable — Location catagorization for the track: C - Country, P - Provincial, M - Metro. - `state` string, nullable — For Australian Tracks, the state that the track is in. - `country` string, nullable — Country of the Track. - `abbrev` string, nullable — Offical abbreviation of the Track. - `surface` string, nullable — The current surface of the Track. - `raceName` string, nullable — Offical name of the Race. - `position` integer — Finishing position of the runner. - `starters` integer — Number of starters in the Race. - `margin` number, double — Offical margin of the runner. - `kri` number, double — Punting Form current Key Race Indicator value for the Race. - `raceClass` string, nullable — Class of the Race. - `ageRestrictions` string, nullable — Any age restrictions in the Race. - `sexRestrictions` string, nullable — Any sex restrictions in the Race. - `prizeMoney` integer — The total prize money value of the Race. - `distance` integer — The distance of the Race. - `trackCondition` string, nullable — The track condition of the Race. - `trackConditionNumber` integer — The track condition number of the race. - `jockey` Jockey — Describes a Jockey. - `fullName` string, nullable — Name of the Jockey. - `jockeyId` string, nullable — Punting Form identifier of the Jockey. - `ridingWeight` number, double — The minimum weight at which the Jockey can currently ride. - `claim` number, double — Any weight claim that the Jockey can make as an apprentice. - `isApprentice` boolean — Indicates whether or not the Jockey is an apprentice. - `weight` number, double — The weight that the runner carried in the Race. - `barrier` integer — The barrier that the runner started from, adjusted for scratchings. - `rail` number, double — The rail position for the Meeting. - `flucs` string, nullable — Betting fluctuations as per official on course prices. i.e. $7-$9. - `priceSP` number, double — The offical starting price of the runner. - `priceBF` number, double — The Betfair starting price of the runner. - `priceTAB` number, double — NSW TAB tote starting price of the runner. - `inRun` string, nullable — Offical in-run position of the runner. i.e. 2-2-1. - `officialRaceTime` string, date-span — Offical overall time of the Race. - `pfRaceTime` string, date-span — Punting Form's timing of the Race. - `stewardsReport` string, nullable — Any stewards reports made about the runner run. - `gearChanges` string, nullable — Any gear changes that were applied to the runner. - `hasSectionalData` boolean — Indicates whether or not Punting Form have records sectional data against the run. - `isBarrierTrial` boolean — Indicates whether or not the Race was a barrier trial. - `top4Finishers` OtherRunners[], nullable — Lists the top four finishers in the Race. - `runnerName` string, nullable — Name of the runner. - `position` integer — Finishing position of the runner. - `weight` number, double — Weight carried by the runner. - `formId` integer — Punting Form identifier for the Form. - `jockeyClaim` number, double — Jockey Claim indicates the amount of weight in KG that an apprentice jockey is claiming in this race - `originalBarrier` integer — The barrier as listed when fields were first published before any scratchings. - `emergencyIndicator` boolean — Is true is the runner is initially listed as an emergency for the race. - `prepRuns` integer — The number of runs a runner has had since it's last spell. - `weightType` string, nullable — The weight type category of the Race. - `limitWeight` number, double — The minimum weight limit allowable in the Race. - `formId` integer — Punting Form identifier for the Form of the Runner. - `jockeyClaim` number, double — Jockey Claim indicates the amount of weight in KG that an apprentice jockey is claiming in this race - `raceId` integer — Punting Form identifier for the Race. - `originalBarrier` integer — The barrier as listed when fields were first published before any scratchings. - `emergencyIndicator` boolean — Is true is the runner is initially listed as an emergency for the race. - `prepRuns` integer — The number of runs a runner has had since it's last spell. - `handicap` number, float, nullable — The official handicap benchmark of the horse - `gearChanges` string, nullable — Any gear changes that were applied to the runner. - `raceId` string, nullable — Punting Form identifier for the Race. - `number` integer — The Race number. - `name` string, nullable — The offical name of the race. - `providerRaceId` string, nullable — Identifier provided by the original supplier of the data. For example, Racing Australia. - `distance` integer — The distnace of the Race. - `ageRestrictions` string, nullable — Any age restrictions on runners within the Race. - `jockeyRestrictions` string, nullable — Any restrictions on jockeys for this Race. - `weightType` string, nullable — The weight type category of the Race. - `limitWeight` number, double — The minimum weight limit allowable in the Race. - `raceClass` string, nullable — The class of the Race as per offical grading. - `prizeMoney` string, nullable — Prizemoney for the Race. - `startTime` string, nullable — The local start time of the Race. - `startTimeUTC` string, nullable — The UTC start time of the Race. - `group` string, nullable — The group status of the race, if any. - `bonusScheme` string, nullable — Any owner bonus scheme associated with the race. - `description` string, nullable — Description of the race as per the Punting Form website. - `prizeMoneyBreakDown` string, nullable — Prize money breakdown of the race - `sexRestrictions` string, nullable — Prize money breakdown of the race - `meetingId` string, nullable — Punting Form identifier for the meeting. - `tabMeeting` boolean — Whether or not the Meeting is covered by the TAB. - `railPosition` string, nullable — The psoition of the rail for the Meeting. - `meetingDate` string, date-time — The date of the Meeting as per the local time zone. - `stage` string, nullable — The stage of form release for the Meeting: Nominations = 1, Weights = 2, Acceptances = 3. - `expectedCondition` string, nullable — The expected track condition for race day. - `isBarrierTrial` boolean — Indicates whether or not the Meeting was a barrier trial. - `isJumps` boolean — Indicates whether the meeting has any jump race or not. - `hasSectionals` boolean — Indicates whether the meeting has sectional or not. - `formUpdated` string, date-time, nullable — This field contains the date/time of the last update to the form for this meeting. - `resultsUpdated` string, date-time, nullable — This field contains the date/time of the last update to the results for this meeting. Field is blank if the meeting has not been resulted. - `sectionalsUpdated` string, date-time, nullable — This field contains the date/time of the last update to the ratings for this meeting. Ratings are recalculated after form updates, scratchings and changes to the track condition. Field is blank if there are no ratings for the meeting. - `ratingsUpdated` string, date-time, nullable — This field contains the date/time of the last update to the sectionals for this meeting. Field is blank if there are no sectionals data for the meeting. - `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/versions/b7d122ef3977/schema)