Data Dictionary

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
PersonOtherNameOther Names not captured on Native, Passport or Preferred
PersonPerviousNamePrevious 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'
MatchUpDrawIdA 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.
CourtPacePlease 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'
TournamentUnifiedTournamentID

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


TournamentMatchUps

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 
EventAgeCategoryCutoffDate

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

StageStageId
StageSortOrder
StageName
StageStageType
StageEntries
StageDraws



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 
DrawRounds

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.
GoesToDrawIdThe 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'
TennisProviderOrganisationIDThe 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

WorldTennisNumberTennisId
WorldTennisNumberTennisNumber
WorldTennisNumberWorldTennisNumberType
WorldTennisNumberConfidence
WorldTennisNumberRatingDate
WorldTennisNumberMatchUps

Related Information


Go back to Tennis Open Data Standards home page.