Race Status API

The listRaceDetails operation is provided to allow customers to establish the status of a horse or greyhound race market both prior to and after the start of the race. This information is available for UK, Ireland and South African races only and is provided for information purposes only. We cannot provide any guarantees regarding the timeliness of the data vs live /broadcasted pictures.

listRaceDetails

All API requests should be sent as POST.

Interface	Endpoint	JSON-RPC Prefix	<method> Example
JSON-RPC	https://api.betfair.com/exchange/scores/json-rpc/v1	<method>	ScoresAPING/v1.0/listRaceDetails

Operation Summary

List<RaceDetails >

listRaceDetails ( Set<MeetingId> meetingIds, Set<RaceId> raceIds )

Operations
- listRaceDetails

Events

Type definitions
- RaceDetails

Enum
- RaceStatus
- Responsecode

Exceptions
- APINGException

Operations

listRaceDetails

List<RaceDetails> listRaceDetails ( Set<MeetingId> meetingIds, Set<RaceId> raceIds ) throws APINGException

Search for races to get their details.

Parameter name	Type	Required	Description

Parameter name

Type

Required

Description

meetingIds

Set<MeetingId>

Optionally restricts the results to the specified meeting IDs. The unique Id for the meeting equivalent to the eventId for that specific race as returned by listEvents. Optionally restricts the results to the specified meeting IDs.

raceIds

Set<RaceId>

Optionally restricts the results to the specified race IDs. The unique Id for the race in the format meetingid.raceTime (hhmm). raceTime is in GMT. Optionally restricts the results to the specified race IDs. The raceID field is returned within the Race node of the Navigation Data For Applications service.

Return type	Description

Return type	Description
List<RaceDetails>	List of retrieved race details

Throws	Description

Throws	Description
APINGException

Since 1.0.0

Events

This interface does not define any events.

Type definitions

RaceDetails

Race Details

Field name	Type	Required	Description

Field name	Type	Description
meetingId	MeetingId	The unique Id for the meeting equivalent to the eventId for that specific race as returned by listEvents. Optionally restricts the results to the specified meeting IDs.
raceId	RaceId	The unique Id for the race in the format meetingid.raceTime (hhmm). Optionally restricts the results to the specified race IDs.
raceStatus	RaceStatus	The current status of the race.
lastUpdated	LastUpdated	This is the time the data was last updated
sequence	UpdateSequence	This is the unique identifier associated to each update of the data
responseCode	ResponseCode