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

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

Field name

Type

Required

Description

Field name

Type

Required

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

 

Type aliases

Alias

Type

Alias

Type

 UpdateSequence

long

 EventId

String

 EventTypeId

String

 EventTime

String

 UpdateType

String

 LastUpdated

Date

 MeetingId

String

 RaceId

String

Enums

racestatusRaceStatus

Value

Description

Value

Description

DORMANT

There is no data available for this race.

DELAYED

The start of the race has been delayed

PARADING

The horses/greyhounds are in the parade ring

GOINGDOWN

The horses are going down to the starting post

GOINGBEHIND

The horses are going behind the stalls

APPROACHING

The greyhounds are approaching the traps

GOINGINTRAPS 

The greyhounds are being put in the traps

HARERUNNING

The hare has been started

ATTHEPOST

The horses are at the post

OFF

The greyhound/horse race has started

FINISHED

The race has finished

FINALRESULT

The result has been declared (Greyhounds only)

FALSESTART

There has been a false start

PHOTOGRAPH

The result of the race is subject to a photo finish

RESULT

The result of the race has been announced

WEIGHEDIN

The jockeys have weighed in

RACEVOID

The race has been declared void

NORACE

The race has been declared a no race

MEETINGABANDONED

The meeting has been abandoned

RERUN

The race will be rerun

ABANDONED

The race has been abandoned

 

 

 

 

 

 

 

 

ResponseCode

Value

Description

Value

Description

OK

Data returned successfully

NO_NEW_UPDATES

No updates since the passes UpdateSequence

NO_LIVE_DATA_AVAILABLE

Event scores are no longer available or are not on the schedule

SERVICE_UNAVAILABLE

Data feed for the event type (tennis/football etc) is currently unavailable

UNEXPECTED_ERROR

An unexpected error occurred retrieving score data

LIVE_DATA_TEMPORARILY_UNAVAILABLE

Live Data feed for this event/match is temporarily unavailable, data could potentially be 
stale

Exceptions

APINGException

Error code

Description

Error code

Description

UNEXPECTED_ERROR

The operation failed with an unexpected error

INVALID_INPUT_DATA

Invalid input data

INVALID_SESSION_INFORMATION

The session token passed is invalid or expired

INVALID_APP_KEY

The application key passed is invalid

SERVICE_BUSY

The service is currently too busy to service this request

TIMEOUT_ERROR

Internal call to downstream service timed out

NO_SESSION

A session token is required for this operation

NO_APP_KEY

An application key is required for this operation

TOO_MANY_REQUESTS

Too many requests

SERVICE_UNAVAILABLE

Service is currently unavailable

Other parameters

Type

Required

Description

Other parameters

Type

Required

Description

errorDetails

String

 

The stack trace of the error

requestUUID

String

 

Â