Country Flags Manifest

Data Points

Asset List:

Attribute	Parent Element	Type	Description
`entity`	`assetlist`	String	Type of image entity Unused for Country Flags
`league`	`assetlist`	String	Name of league for a manifest `country-flags`
`manifest_date`	`assetlist`	String	Timestamp of the most recent published update to a manifest
`provider`	`assetlist`	String	News image provider for a manifest `sr` (Sportradar)
`type`	`assetlist`	String	Type of images in a manifest `flag`

Assets:

Attribute	Parent Element	Type	Description
`id`	`asset`	GUID	Unique ID of an image ex. `f7dc3e69-fe3a-4ce7-8f84-ea4a3a22c947`
`copyright`	`asset`	String	Copyright ownership of an image ex. `USA Today Sports Images`
`created`	`asset`	String	Timestamp of a creation of an image ex. `2022-08-05T03:12:08+00:00`
`description`	`asset`	String	Text description of an image ex. `<![CDATA[National Flag for AFGHANISTAN]]>`
`title`	`asset`	String	Title (or headline) of an image ex. `<![CDATA[AFGHANISTAN]]>`
`updated`	`asset`	String	Timestamp of an update to an image ex. `2023-07-04T14:56:25+00:00`

Links:

Attribute	Parent Element	Type	Description
`height`	`link`	Integer	Height in pixels of an image ex. `1200`
`href`	`link`	String	Hypertext reference used to create a downloadable URL to an image ex. `/country-flags/flags/df65e7df-40ab-46b7-8ea1-92e0217c15a0/original.svg`
`width`	`link`	Integer	Width in pixels of an image ex. `800`

Reference:

Attribute	Parent Element	Type	Description
`name`	`ref`	String	Name of a country flag image ex. `AFGHANISTAN`
`iso_country_code`	`ref`	String	ISO country code for a Country Flag image ex. `AFG` (Afghanistan)
`type`	`ref`	String	Image type `country`
`primary`	`ref`	Boolean	Signifies the image is the primary image for a country
`sport`	`ref`	String	Sport or league of an image `flags`

Reference Entities:

Attribute	Parent Element	Type	Description
`id`	`ref` - `entity_id`	GUID	Unique Sportradar ID used to link an image to a type (eg. event, player, team) ex. `GLP` (Guadeloupe)
`origin`	`ref` - `entity_id`	String	Source 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`
`sport`	`ref` - `entity_id`	String	Sport or league of a source ID ex. `flags`

Provider:

Attribute	Parent Element	Type	Description
`name`	`provider`	String	Provider for an image `sr` (Sportradar)
`version`	`provider`	String	Provider 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: