RecipesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Country Flags Manifest

Provides the manifest for all country flag images.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…

Data Points

Asset List:
AttributeParent ElementTypeDescription
entityassetlistStringType of image entity
Unused for Country Flags
leagueassetlistStringName of league for a manifest
country-flags
manifest_dateassetlistStringTimestamp of the most recent published update to a manifest
providerassetlistStringNews image provider for a manifest
sr (Sportradar)
typeassetlistStringType of images in a manifest
flag
Assets:
AttributeParent ElementTypeDescription
idassetGUIDUnique ID of an image
ex. f7dc3e69-fe3a-4ce7-8f84-ea4a3a22c947
copyrightassetStringCopyright ownership of an image
ex. USA Today Sports Images
createdassetStringTimestamp of a creation of an image
ex. 2022-08-05T03:12:08+00:00
descriptionassetStringText description of an image
ex. <![CDATA[National Flag for AFGHANISTAN]]>
titleassetStringTitle (or headline) of an image
ex. <![CDATA[AFGHANISTAN]]>
updatedassetStringTimestamp of an update to an image
ex. 2023-07-04T14:56:25+00:00
Links:
AttributeParent ElementTypeDescription
heightlinkIntegerHeight in pixels of an image
ex. 1200
hreflinkStringHypertext reference used to create a downloadable URL to an image
ex. /country-flags/flags/df65e7df-40ab-46b7-8ea1-92e0217c15a0/original.svg
widthlinkIntegerWidth in pixels of an image
ex. 800
Reference:
AttributeParent ElementTypeDescription
namerefStringName of a country flag image
ex. AFGHANISTAN
iso_country_coderefStringISO country code for a Country Flag image
ex. AFG (Afghanistan)
typerefStringImage type
country
primaryrefBooleanSignifies the image is the primary image for a country
sportrefStringSport or league of an image
flags
Reference Entities:
AttributeParent ElementTypeDescription
idref - entity_idGUIDUnique Sportradar ID used to link an image to a type (eg. event, player, team)
ex. GLP (Guadeloupe)
originref - entity_idStringSource of the unique Sportradar ID used to link an image to a type (eg. event, player, team)
SR = Sportradar General Sport IDs such as sr:match:33623381; SD = Sportradar League Specific IDs such as 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31
sportref - entity_idStringSport or league of a source ID
ex. flags
Provider:
AttributeParent ElementTypeDescription
nameproviderStringProvider for an image
sr (Sportradar)
versionproviderStringProvider version
'0'

Image Retrieval Example

To find the national flag for Sweden:

1: Reference the Coverage document for the proper provider. In this case, Sportradar is the provider.

2: Ensure you have the correct API key to retrieve this image. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Country Flags Manifest using your Sportradar Country Flags API key, and with sr in the provider parameter.

https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/manifest.xml?api_key=**your_api_key**

4: Locate the asset id and/or link for Sweden.

<asset id="7be83df7-5970-4814-b1b0-a4dd558ab29e" created="2018-07-10T19:35:56+00:00" updated="2019-02-27T23:13:11+00:00"> <title> <![CDATA[SWEDEN]]> </title> <description> <![CDATA[National Flag for SWEDEN]]> </description> <copyright>Sportradar AG</copyright> <links> <link width="1200" height="800" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/original.svg"/> <link width="250" height="167" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h250-max-resize.png"/> <link width="1000" height="667" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h1000-max-resize.png"/> <link width="500" height="333" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h500-max-resize.png"/> <link width="3480" height="2320" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h3480-max-resize.png"/> <link width="3840" height="2160" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/3840x2160-crop.png"/> </links> <refs> <ref name="SWEDEN" type="country" sport="flags" sportradar_id="" iso_country_code="SWE" primary="true"> </ref> </refs> <provider name="sr"> <version>0</version> </provider> </asset>

5: Select the size of image desired within the link attribute and use this href file_name in your next call to the Country Flag Image endpoint.

https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/original.svg?api_key=**your_api_key**

The flag for Sweden is downloaded.

Flags are available in svg or png formats.

For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

Path Params
string
required
Defaults to t

The access level of your API key

t (Trial), p (Production)

string
required
Defaults to json

Format returned

json, xml

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json