List of Data Dictionary Items

Person

Element	Entity	Description
Person		Please see the 'Introduction to the person' document
Person	PersonId	A unique person Identifier. Please see the 'How to Include multiple Identifiers'
Person	TennisId	Uniquely identify any individual in Tennis; including players, coaches, parents, referees, captains etc
Person	StandardFamilyName	Standard Family Name (ISO/IEC 8859-1 Latin-1 script). Please see the 'Transliteration of Names to Latin Script' document
Person	StandardGivenName	Standard Given Name (ISO/IEC 8859-1 Latin-1 script). Please see the 'Transliteration of Names to Latin Script' document
Person	PassportFamilyName	Passport Family Name (ASCII only, based on ICAO and ISO/IEC 7501-1 standards). Please see the 'Transliteration of Names to Latin Script' document
Person	PassportGivenName	Passport Given Name (ASCII only, based on ICAO and ISO/IEC 7501-1 standards). Please see the 'Transliteration of Names to Latin Script' document
Person	NativeFamilyName	Native Family Name (Unicode). Please see the 'Transliteration of Names to Latin Script' document
Person	NativeGivenName	Native Given Name (Unicode). Please see the 'Transliteration of Names to Latin Script' document
Person	OtherName	Other Names not captured on Native, Passport or Preferred
Person	PerviousName	Previous Names usually through marriage
Person	BirthDate	A person's date of birth in YYYY-MM-DD standard
Person	Sex	Either of the two main categories (male and female) into which humans and most other living things are divided on the basis of their reproductive functions.
Person	NationalityCode	The Nationality (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
Person	EmailAddress	Primary email address
Person	Addresses	Please see Data Dictionary#Address below.
Person	OnlineProfiles	Please see Data Dictionary#OnlineProfile below.
BiographicalInformation		Further information about the person, usually a player
BiographicalInformation	BirthCountryCode	The Country a Person was born (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
BiographicalInformation	ResidenceCountryCode	The Country the Person currently resides (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
BiographicalInformation	PlaceOfResidence	To be presented as city / province / state / region
BiographicalInformation	Height	Height in Centimeters
BiographicalInformation	Weight	Weight in Kilograms
BiographicalInformation	PlayingHandCode	Please see Standard Codes#PlayingHandCode
BiographicalInformation	DoublePlayingHandCode	Please see Standard Codes#PlayingDoubleHandCode
BiographicalInformation	AgeBeganTennis	The age a person started playing tennis
BiographicalInformation	AgeTurnedPro	The age a person became a professional tennis player.
BiographicalInformation	Coach	The player's coach / head coach (if they have more than one). This links to their person record.

Team		A collection of persons forming one side of a MatchUp, competition or tournament
Team	TeamId	A unique team Identifier. Please see the 'How to Include multiple Identifiers'
Team	Name	In English with no special characters. Please see the 'Transliteration of Names to Latin Script' document
Team	NativeTeamName	Native Team Name (Unicode). Please see the 'Transliteration of Names to Latin Script' document
Team	Gender	Please see 'Standard Codes#Gender'
Team	Organisation	The organisation that the team represents i.e. club, school, company, national association
Team	OtherNames	Names not captured by the above e.g. nicknames
Team	PreviousNames	Previous name the team has been known by.
Team	OnlineProfiles	Please see Data Dictionary#OnlineProfile below.

MatchUp

Element	Entity	Description
MatchUp		A contest in which at least two or more players compete. Please see the 'Introduction to the MatchUp' document
MatchUp	MatchUpId	A unique MatchUp identifier. Please see the 'How to Include multiple Identifiers'
MatchUp	DrawId	A unique draw identifier. Please see the 'How to Include multiple Identifiers'
MatchUp	RoundNumber	The round of the draw in the tournament or tie. i.e. first round or semi-final
MatchUp	RoundPosition	The MatchUp position with the aforementioned round number. e.g. a semi-final with have 2 round MatchUp s. The round position of the MatchUp being played will be 1 or 2 as a result.
MatchUp	MatchType	Please see 'Standard Codes#MatchUpType'
MatchUp	MatchFormat	MatchUp Format Code
MatchUp	IndoorOutdoor	Please see Standard Codes#IndoorOutdoor'
MatchUp	SurfaceCategory	Please see 'Standard Codes#SurfaceCategory'
MatchUp	CourtName	Name of the court. Can be name or number
MatchUp	Court	Please see Data Dictionary#Court below.
MatchUp	WinningSide	1 or 2
MatchUp	WinnerGoesTo	Please see 'Data Dictionary#GoesTo' below.
MatchUp	LoserGoesTo	Please see 'Data Dictionary#GoesTo' below.
MatchUp	Score	The result from the winner's perspective. e.g. 6-4, 4-6, 7-6(7-5)
MatchUp	StartDate	When the MatchUp started
MatchUp	EndDate	When the MatchUp ended
MatchUp	MatchDuration	MatchUp Duration in total minutes of play
MatchUp	OrderOfPlayItem
MatchUp	MatchStatus	Please see Standard Codes#MatchUpStatus.
MatchUp	Temperature	Temperature in degrees
MatchUp	Humidity	Humidity as a percentage
MatchUp	Sides	A hierarchy containing multiple side details
Side		Please see the 'Introduction to the MatchUp' document for more information.
Side	SideNumber	1 or 2
Side	Score	The score according to the side's perspective.
Side	Participant	A team or pair as defined in participant. Not required for individuals.
Side	Players	The members of the team or pair who are actually playing the MatchUp
Player		The individual player in the MatchUp
Player	PlayerNumber	Always player 1 in singles. Player 1 or 2 in doubles
Player	Participant	An individual
MatchUp	Sets	A hierarchy containing multiple set details
Set
Set	SetNumber	A number representing the set. Usually 1-5
Set	Timestamp
Set	SetFormat	Please see the 'MatchUp Format Code' document for more information.
Set	Side1Score	The Set score for Side1
Set	Side2Score	The Set score for Side2
Set	Side1TieBreakScore	The Tie break score within the Set for Side1
Set	Side2TieBreakScore	The Tie break score within the Set for Side2
Set	SetDuration	Set Duration in total minutes
Set	WinningSide	Side 1 or 2
Set	Games	A hierarchy containing multiple game details
Game
Game	GameNumber
Game	Timestamp
Game	GameFormat
Game	GameDuration
Game	WinningSide
Game	Points	A hierarchy containing multiple point details
Point
Point	PointNumber
Point	Timestamp
Point	Side1Score	Deuce scoring - 15, 30, 40, Adv
Point	Side2Score	Deuce scoring - 15, 30, 40, Adv
Point	PointDuration	Point duration in total minutes
Point	WinningSide	Side 1 or 2
Point	WinReason	Standard Codes#WinReason
Point	Shots	A hierarchy containing multiple shot details
Shot
Shot	Number	Number of the shot in the rally.
Shot	ShotType	Standard Codes#ShotType
Shot	ShotDetail	Standard Codes#ShotDetail
Shot	Side	Side 1 or 2
Shot	Participant	The Participant that hit made the shot (usually only for doubles)
Shot	ShotOutcome	Standard Codes#ShotOutcome
Shot	Returned	Yes or No
Shot	Speed	Mph, m/s, Kmph
Shot	Spin	RPM or VX,VY,VZ
Shot	ShotMadeFrom	Standard Codes#ShotMadeFrom OR X,Y
Shot	BounceAt	X,Y

Court
Court	CourtId	A unique court Identifier. Please see the 'How to Include multiple Identifiers'
Court	SurfaceCategory	Please see Standard Codes#SurfaceCategory
Court	SurfaceType	Please see the ITF Technical website ITF Surface Types for more information.
Court	Pace	Please see the ITF Technical website ITF Court Pace Classification for more information.
Court	CourtDimensions	Majority of cases will be STANDARD. The field will accept any metric e.g.red, standard, or measured in feet / inches, meters or cm.
Court	Latitude	As per Google Maps eg 51°27'32.2"N 0°15'19.0"W OR 51.458947, -0.255283
Court	Longitude	As per Google Maps eg 51°27'32.2"N 0°15'19.0"W OR 51.458947, -0.255283
Court	Altitude	Height in feet above sea level
Court	SurfacedDate	The date the surface was installed or resurfaced

Tournament

Element	Entity	Description
Tournament		Please see the 'Introduction to the Tournament' document for more information.
Tournament	ProviderTournamentID	A unique tournament Identifier. Please see the 'How to Include multiple Identifiers'
Tournament	UnifiedTournamentID
Tournament	TournamentGroups	Which other tournaments is this related to. For example it’s part of ATP Challenger Tour, WTA International, Grand Slam
TournamentGroup
TournamentGroup	Group
Tournament	TournamentLevel	Please see the 'Tournament Level' document for more information.
Tournament	TournamentName	The name of the tournament.
Tournament	FormalName	This is for the official name for the tournament agreed with the sanctioning body - for example ‘The Championships, Wimbledon 2019’
Tournament	PromotionalName	This is for a media-friendly name that is used to promote the tournament, for example ‘Wimbledon 2019’
Tournament	Venue	Please see Data Dictionary#Venue below
Tournament	TournamentAddresses	The Address of the tournament.
Tournament	TournamentContacts	Contacts required for the tournament.
Tournament	TennisOfficials	List of person ID's for officials
Tournament	HostCountryCode	The Country Hosting the Tournament (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
Tournament	StartDate	The start date of the tournament
Tournament	EndDate	The end date of the tournament
Tournament	Season	The Season in which the Tournament is run eg Summer 2019
Tournament	LocalTimeZone	The local time zone. This is useful as the start date doesn't carry time zone information.
Tournament	SurfaceCategory	Please see Standard Codes#SurfaceCategory
Tournament	IndoorOutdoor	An indoor or outdoor tournament
Tournament	EntriesOpen	The date when entries open
Tournament	EntriesClose	The date when entries close
Tournament	WithdrawalDeadline	The data players can withdraw (usually before penalty)
Tournament	TotalPrizeMoney
TotalPrizeMoney		The total amount of prize money given.
TotalPrizeMoney	PrizeMoney	Allows the prize money to be split into different currencies
PrizeMoney
PrizeMoney	CurrencyCode	The currency the prize money is awarded in.
PrizeMoney	Amount	The amount of prize money awarded.
Tournament	Events
Tournament	MatchUps
Tournament	Participants	Any Coach, Official, Umpire or Player etc associated with the Tournament

Event
Event	EventId	A unique event Identifier. Please see the 'How to Include multiple Identifiers'
Event	Name	The name of the event eg Regional U16 Level 1 Boys
Event	TennisOfficials	List of person ID's for officials
Event	Discipline	The Discipline eg Tennis, Beach Tennis, Wheelchair Tennis etc
Event	EventLevel	Please see the 'Tournament Level' document for more information.
Event	EventType	Please see Standard Codes#EventType
Event	WheelchairClass	Please see Standard Codes#WheelchairClass
Event	BallType	Please see Standard Codes#BallType
Event	SurfaceCategory	Please see Standard Codes#SurfaceCategory
Event	AgeCategory	Please see Standard Codes#AgeCategory
Event	AgeCategoryCutoffDate
Event	Gender	Please see Standard Codes#Gender
Event	StartDate	The start date of the event.
Event	EndDate	The end date of the event.
Event	Entries
Event	Stages

Entry
Entry	EntryId	A unique entry Identifier. Please see the 'How to Include multiple Identifiers'
Entry	Name	The name of the entry.
Entry	Participant
Entry	ParticipantType	Please see Standard Codes#ParticipantType
Entry	EntryStatus	Please see Standard Codes#EntryStatus
Entry	Points
Entry	FinalPosition	The highest position reached.
Entry	Wins	The number of wins.
Entry	Losses	The number of losses.
Entry	Seed

Stage
Stage	StageId
Stage	SortOrder
Stage	Name
Stage	StageType
Stage	Entries
Stage	Draws

Draw
Draw	DrawId	A unique draw Identifier. Please see the 'How to Include multiple Identifiers'
Draw	Name	The name of the draw.
Draw	DrawStructure	Please see Standard Codes#DrawStructure
Draw	Rounds
Rounds
Rounds	Round
Round
Round	RoundNumber
Round	RoundItem
RoundItem
RoundItem	Position
RoundItem	WinnerGoesTo	Please see 'Data Dictionary#GoesTo' below.
RoundItem	LoserGoesTo	Please see 'Data Dictionary#GoesTo' below.
Draw	DrawType	Please see Standard Codes#DrawType
Draw	SortOrder	A number representing the order of the draw within the event.
Draw	StartDate	The start date of the draw.
Draw	EndDate	The end date of the draw.
Draw	DrawSize	The total number of places available in the first round. Usually 128, 64, 32, 16 or 8.
Draw	NoOfRounds	How many rounds does the draw span. eg for a 32 draw size, this would be 5 rounds (Round 1, Round 2, Quarterfinals, Semifinals, Finals)
Draw	DrawStatus	Please see Standard Codes#DrawStatus
Draw	Entries
Draw	MatchUps
Draw	Ties

GoesTo		Where the winning or losing participant 'goes' in a draw.
GoesTo	EventId	The event the winning or losing participant goes to.
GoesTo	DrawId	The draw the winning or losing participant goes to.
GoesTo	RoundNumber	The round within the draw the winning or losing participant goes to.
GoesTo	Position	The position within the round the winning or losing participant goes to.

OrderOfPlay
OrderOfPlay	OrderOfPlayId	A unique order of play Identifier. Please see the 'How to Include multiple Identifiers'
OrderOfPlay	ScheduleItem
OrderOfPlay	Name	The name of the order of play.
OrderOfPlay	StartDate
OrderOfPlay	LocalTimeZone
OrderOfPlay	Venue	Please see 'Data Dictionary#Venue' below.
OrderOfPlay	OrderOfPlayItems

OrderOfPlayItem
OrderOfPlayItem	OrderOfPlayItemId	A unique order of play item Identifier. Please see the 'How to Include multiple Identifiers'
OrderOfPlayItem	Name	The name of the order of play item.
OrderOfPlayItem	StartDate
OrderOfPlayItem	EndDate
OrderOfPlayItem	StartType	Please see Standard Codes#StartType
OrderOfPlayItem	EndType	Please see Standard Codes#EndType
OrderOfPlayItem	ScheduleItem
OrderOfPlayItem	StartDelay
OrderOfPlayItem	PreviousOrderOfPlayItem
OrderOfPlayItem	Description

ScheduleItem
ScheduleItem	ScheduleItemId	A unique schedule item Identifier. Please see the 'How to Include multiple Identifiers'
ScheduleItem	ParentScheduleItem
ScheduleItem	Name	The name of the schedule item.
ScheduleItem	StartDate
ScheduleItem	EndDate
ScheduleItem	LocalTimeZone
ScheduleItem	Description

Participant
Participant	ParticipantId	A unique participant Identifier. Please see the 'How to Include multiple Identifiers'
Participant	Name	For pair or team this is the full name. For individuals this is preferred family name.
Participant	PreferredGivenName	For individuals this is preferred given name
Participant	ParticipantType	Please see Standard Codes#ParticipantType
Participant	Representing	The country the Participant is representing (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
Participant	Person	Please see 'Data Dictionary#Person' below.
Participant	Team	Please see 'Data Dictionary#Team' below.
Participant	ParticipantStatus	Please see Standard Codes#ParticipantStatus
Participant	ParticipantRole	Please see Standard Codes#ParticipantRole
Participant	Members	For SQUAD, TEAM or PAIR. An array of all participants that form part of this record.

Statistic
Statistic	StatisticId	A unique statistic Identifier. Please see the 'How to Include multiple Identifiers'
Statistic	Name	The name of the statistic.
Statistic	Code
Statistic	Value

Locations

Element	Entity	Description
Organisation
Organisation	OrganisationId	A unique organisation Identifier. Please see the 'How to Include multiple Identifiers'
Organisation	OrganisationType	Please see Standard Codes#OrganisationType
Organisation	Name	The name of the organisation.
Organisation	Addresses	The organisations address.
Organisation	Website	The organisations website.

Venue
Venue	VenueId	A unique venue Identifier. Please see the 'How to Include multiple Identifiers'
Venue	VenueType	Please see Standard Codes#VenueType
Venue	Name	The name of the venue.
Venue	Addresses	The venues address.
Venue	Website	The venues website.
Venue	Courts
Venue	SubVenue

Tennis - Root Element

Element	Entity	Description
Tennis
Tennis	ProviderId	An identifier for the party providing the data. Please see the 'How to Include multiple Identifiers'
Tennis	ProviderOrganisationID	The Org ID of the party providing the data
Tennis	Date	The date the document is provided.
Tennis	DataStandardsVersion	The version of the data standards the file is using.
Tennis	CodesVersion	The version of the Standard Codes the file is using.

Extensions

Element	Entity	Description
Extension		Extensions can be used to capture additional information that does not yet have a place elsewhere in the TODS. Please see Extensions.
Extension	Name	The name of the suggested extension eg AgeMin OR AgeMax
Extension	Value	The value of the suggested extension eg 12 OR 16
Extension	Description	A description of the Extension

Generic Elements

Element	Entity	Description
Address
Address	AddressType	Please see Standard Codes#AddressType
Address	AddressLine1
Address	AddressLine2
Address	AddressLine3
Address	City
Address	State
Address	PostalCode
Address	CountryCode	The Country (ISO3166-3 standards). Please see Wikipedia ISO_3166-1_alpha-3
Address	Latitude	As per Google Maps eg 51°27'32.2"N 0°15'19.0"W OR 51.458947, -0.255283
Address	Longitude	As per Google Maps eg 51°27'32.2"N 0°15'19.0"W OR 51.458947, -0.255283

Contact
Contact	ContactType	Please see Standard Codes#ContactType
Contact	Name	The name of the contact.
Contact	Telephone	The contacts telephone number.
Contact	MobileTelephone	The contacts mobile telephone number.
Contact	Fax	The contacts fax number.
Contact	EmailAddress	The contacts email address.
Contact	Website	The contacts website.
Contact	IsPrivate	If the details are private or can be published online. Usually for tournament directors, referees etc.

OnlineProfile		Online Profiles
OnlineProfile	Type	The type of profile eg Facebook, Twitter etc
OnlineProfile	Identifier	The identifier or URL of the online profile eg Twitter-@ITF_Tennis, Facebook-InternationalTennisFederation OR https://www.facebook.com/InternationalTennisFederation

CommonElements	Updated
CommonElements	Notes
CommonElements	Extensions
CommonElements	Ids	Please see the 'How to Include multiple Identifiers'

Ranking
Ranking	RankingId	A unique ranking Identifier. Please see the 'How to Include multiple Identifiers'
Ranking	Name	The name of the ranking eg Best Under 16 Boys Singles Teams in the World 2019
Ranking	Discipline
Ranking	WheelchairClass
Ranking	RankingType	Please see Standard Codes#RankingType
Ranking	AgeCategory	Please see Standard Codes#AgeCategory
Ranking	Gender	Please see Standard Codes#Gender
Ranking	RankingItems
RankingItem	Type
RankingItem	SortOrder
RankingItem	Result
RankingItem	Rank
RankingItem	RankingItemCode
RankingItem	Person
RankingItem	Team

WorldTennisNumber
WorldTennisNumber	TennisId
WorldTennisNumber	TennisNumber
WorldTennisNumber	WorldTennisNumberType
WorldTennisNumber	Confidence
WorldTennisNumber	RatingDate
WorldTennisNumber	MatchUps

Related Information

Go back to Tennis Open Data Standards home page.