---
title: |-
  Explanation of the FIS Data Exchange XML Protocol
  Cup Standings
version: "2.4"
date: 2026-09-10
documentName: Cup Standings XML Description
documentType: XML Protocol Description
author: FIS IT
theme: dark
toc: true
tocDepth: 3
cover: true
chapterNumbering: true
headerTitle: Cup Standings XML Description
footerDateFormat: YYYY-MM-DD
---

## Table of contents

- [1. General](#1-general)
- [2. Email](#2-email)
- [3. Support](#3-support)
- [4. Structure of XML](#4-structure-of-xml)
  - [4.1 `<Fisresults>`](#41-fisresults)
  - [4.2 `<Cup>`](#42-cup)
  - [4.3 `<CUPInfo>`](#43-cupinfo)
  - [4.4 `<Standingdate>`](#44-standingdate)
  - [4.5 `<CUPraces>`](#45-cupraces)
  - [4.6 `<Races>`](#46-races)
  - [4.7 `<Racedate>`](#47-racedate)
  - [4.8 `<CUPclassified>`](#48-cupclassified)
  - [4.9 `<CUPstandings>`](#49-cupstandings)
  - [4.10 `<Competitor>`](#410-competitor)
  - [4.11 `<Competitor>` (Nationcup)](#411-competitor-nationcup)
  - [4.12 `<CUPdetails>`](#412-cupdetails)
  - [4.13 `<Race>`](#413-race)
  - [4.14 Example cup standing](#414-example-cup-standing)
  - [4.15 Example nation cup standing](#415-example-nation-cup-standing)
- [5. Document Control](#5-document-control)

# 1. General

This document provides an explanation of the protocol used for the FIS Data Exchange for start lists, intermediate results, results and standings.

Encoding of the XML result file should be in UTF8.

If optional elements are used (not empty) they should at least contain the required child elements.

Language for the content is English and characters for data content should be only Latin letters.

Please note that the examples do not need to be correct in terms of data but should only show the XML structure.

# 2. Email

Send the results to [results@fis-ski.com](mailto:results@fis-ski.com).

The subject of the email should contain for easy email identification the NSA code and race codex but not any special characters (. / , - : ; ( ) & % $ § “ ! ? etc.) and should also not be empty.

Example email subject: AUT1234

File name of the xml files: &lt;NSA code&gt;&lt;race codex (4 digits)&gt;.xml

Example XML file name: AUT1234.xml

Result XML files can be sent as one file or also more than one file within one email. Files can be also sent packed in ZIP file. The ZIP should only contain the result file(s) but no folders or hidden system files.

# 3. Support

For support requests, questions and feedbacks please contact the FIS IT department: [it@fis-ski.com](mailto:it@fis-ski.com).

A support request for a certain race should at least contain the FIS race codex and a short description of the issue. Preferred support language is English.

# 4. Structure of XML

## 4.1 `<Fisresults>`

The general term for the results of all FIS competitions, root element

| Element        | Data   | Child elements                   | Description                                                                     | Required |
|----------------|--------|----------------------------------|---------------------------------------------------------------------------------|----------|
| `<XMLversion>` | string |                                  | Version number of the Timing Report XML description which the software supports | optional |
| `<Cup>`        |        | `<CUPInfo>`<br>`<CUPclassified>` |                                                                                 | required |

## 4.2 `<Cup>`

| Element           | Child elements                                                                              | Description                                                                                              | Required |
|-------------------|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------|----------|
| `<CUPInfo>`       | `<Season>`<br>`<CUPSex>`<br>`<CUPID>`<br>`<Discipline>`<br>`<Standingdate>`<br>`<CUPraces>` | Information to define each cup. The following information is applicable to all sectors (FIS disciplines) | required |
| `<CUPclassified>` | `<CUPstandings>`                                                                            | Information about the results of a cup                                                                   | required |

Attributes of `<CUPInfo>`:

| Element     | Attribute | Attribute values                                                                                                                                                                                                                                                                    |
|-------------|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `<CUPInfo>` | `Sector`  | AL – Alpine<br>CC – Cross Country<br>FS – Freestyle Skiing<br>GS – Grass Skiing<br>JP – Ski Jumping<br>NK – Nordic Combined<br>SB – Snowboard<br>TM – Telemark<br>SS – Speed Skiing<br>MA – Masters<br>PAL – Para Alpine Skiing<br>PCC – Para Cross Country<br>PSB – Para Snowboard |

## 4.3 `<CUPInfo>`

<table>
  <colgroup>
    <col style="width: 24mm">
    <col style="width: 14mm">
    <col style="width: 26mm">
    <col style="width: 79mm">
    <col style="width: 18mm">
  </colgroup>
  <tr>
    <th>Element</th>
    <th>Data</th>
    <th>Child elements</th>
    <th>Description</th>
    <th>Required</th>
  </tr>
  <tr>
    <td><code>&lt;Season&gt;</code></td>
    <td>integer</td>
    <td></td>
    <td>Season, ie. 2012 for June 2011 - May 2012</td>
    <td>required</td>
  </tr>
  <tr>
    <td><code>&lt;CUPSex&gt;</code></td>
    <td>Integer</td>
    <td></td>
    <td>The unique identification number for each competition with the sector (latest details can be found in the calendar section of the FIS website)<br>M – Men<br>L – Ladies<br>A – Overall</td>
    <td>required</td>
  </tr>
  <tr>
    <td><code>&lt;CUPID&gt;</code></td>
    <td>string</td>
    <td></td>
    <td>The three letter FIS code for the organizing nation (latest details can be found in the calendar section of the FIS website)<br>According category provided in FIS calendar<br>NC – Nation Cup<br>NC-WC – World Cup Nation Cup<br>NC-GP – Grand Prix Nation Cup</td>
    <td>required</td>
  </tr>
  <tr>
    <td><code>&lt;Discipline&gt;</code></td>
    <td>string</td>
    <td></td>
    <td>The respective discipline to the sector
        <table style="width: auto">
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0"></td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">ALL – Overall</td>
          </tr>
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">CC</td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">DI – Distance<br>SP – Sprint</td>
          </tr>
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">AL</td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">DH – Downhill<br>SL – Slalom<br>GS – Giant Slalom<br>SG – Super G<br>SC – Super Combined</td>
          </tr>
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">JP</td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">SF – Ski Flying<br>4H – 4 Hill</td>
          </tr>
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">FS</td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">AE – Aerials<br>MO – Moguls<br>SX – Ski Cross<br>HP – Halfpipe<br>SS – Slopestyle</td>
          </tr>
          <tr>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">SB</td>
            <td style="border: 0; padding: 0 0.8rem 0.2rem 0">PAR – Parallel<br>AFU – Freestyle Overall<br>HP – Halfpipe<br>BA – Big Air<br>SBS – Slopestyle<br>SBX – Snowboard Cross</td>
          </tr>
        </table>
    </td>
    <td>required</td>
  </tr>
</table>
<!-- pagebreak -->
<table>
  <colgroup>
    <col style="width: 24mm">
    <col style="width: 14mm">
    <col style="width: 26mm">
    <col style="width: 79mm">
    <col style="width: 18mm">
  </colgroup>
  <tr>
    <th>Element</th>
    <th>Data</th>
    <th>Child elements</th>
    <th>Description</th>
    <th>Required</th>
  </tr>
  <tr>
    <td><code>&lt;Standingdate&gt;</code></td>
    <td></td>
    <td><code>&lt;Day&gt;</code><br><code>&lt;Month&gt;</code><br><code>&lt;Year&gt;</code></td>
    <td></td>
    <td>optional</td>
  </tr>
  <tr>
    <td><code>&lt;CUPraces&gt;</code></td>
    <td></td>
    <td><code>&lt;Race&gt;</code></td>
    <td>Information about the contained races of the cup</td>
    <td>optional</td>
  </tr>
</table>

## 4.4 `<Standingdate>`

| Element   | Data    | Description                                               | Required |
|-----------|---------|-----------------------------------------------------------|----------|
| `<Day>`   | integer | Day in numerical form: 1, 11, 21, etc.                    | required |
| `<Month>` | integer | Month in numerical form: 1, 2, 10, etc.                   | required |
| `<Year>`  | integer | Year in four digit numerical form: 2000, 2001, 2002, etc. | required |

## 4.5 `<CUPraces>`

| Element  | Child elements                                       | Description      | Required |
|----------|------------------------------------------------------|------------------|----------|
| `<Race>` | `<Codex>`<br>`<Place>`<br>`<Nation>`<br>`<Racedate>` | Race information | optional |

Attributes of `<Race>`:

| Element  | Attribute | Attribute values      |
|----------|-----------|-----------------------|
| `<Race>` | `No`      | Number of race in cup |

## 4.6 `<Races>`

| Element      | Data    | Child elements                   | Description                                                                                                                                    | Required |
|--------------|---------|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| `<Codex>`    | integer |                                  | The unique identification number for each competition with the sector (latest details can be found in the calendar section of the FIS website) | required |
| `<Place>`    |         |                                  | Resort, town, etc. of competition venue                                                                                                        | optional |
| `<Nation>`   |         |                                  | The nation of the Resort, town, etc. using the FIS abbreviation                                                                                | optional |
| `<Racedate>` |         | `<Day>`<br>`<Month>`<br>`<Year>` | Date of race                                                                                                                                   | optional |

## 4.7 `<Racedate>`

| Element   | Data    | Description                                               | Required |
|-----------|---------|-----------------------------------------------------------|----------|
| `<Day>`   | integer | Day in numerical form: 1, 11, 21, etc.                    | required |
| `<Month>` | integer | Month in numerical form: 1, 2, 10, etc.                   | required |
| `<Year>`  | integer | Year in four digit numerical form: 2000, 2001, 2002, etc. | required |

## 4.8 `<CUPclassified>`

| Element          | Child elements                                                    | Description                                                  | Required |
|------------------|-------------------------------------------------------------------|--------------------------------------------------------------|----------|
| `<CUPstandings>` | `<Rank>`<br>`<Competitor>`<br>`<Pointsdescend>`<br>`<CUPdetails>` | Information about the cup standing of a competitor or nation | required |

## 4.9 `<CUPstandings>`

| Element           | Data   | Child elements                                                                                                   | Description                          | Required |
|-------------------|--------|------------------------------------------------------------------------------------------------------------------|--------------------------------------|----------|
| `<Rank>`          | string |                                                                                                                  | The competitor’s position in the cup | required |
| `<Competitor>`    |        | `<Fiscode>`<br>`<Lastname>`<br>`<Firstname>`<br>`<Nation>`<br>`<For Nationcup:>`<br>`<Nationname>`<br>`<Nation>` | Details of a competitor or nation    | required |
| `<Pointsdescend>` | string |                                                                                                                  | Total cup points, times, prize money | required |
| `<CUPdetails>`    |        | `<Race>`                                                                                                         | Details of the cup result            | optional |

## 4.10 `<Competitor>`

| Element       | Data   | Description                                                                                                                                                                                                                                                                                           | Required |
|---------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| `<Fiscode>`   | string | The competitor’s personal and unique FIS code. Every competitor must have a valid FIS code to participate in a FIS race. This code is published on the FIS list, or in exceptional cases between the publication of lists may have been provided to the TD or organizer by the FIS Office in writing. | required |
| `<Lastname>`  | string | The competitor’s last name as it appears on the FIS list                                                                                                                                                                                                                                              | required |
| `<Firstname>` | string | The competitor’s first name as it appears on the FIS list                                                                                                                                                                                                                                             | required |
| `<Gender>`    | string | Gender of competitor<br>M = Male<br>F = Female                                                                                                                                                                                                                                                        | optional |
| `<Nation>`    | string | The competitor’s nation using the FIS abbreviation                                                                                                                                                                                                                                                    | required |

## 4.11 `<Competitor>` (Nationcup)

| Element        | Data   | Description                           | Required |
|----------------|--------|---------------------------------------|----------|
| `<Nationname>` | string | FIS country name                      | required |
| `<Nation>`     | string | The nation using the FIS abbreviation | required |

## 4.12 `<CUPdetails>`

| Element  | Data   | Child elements                                 | Required |
|----------|--------|------------------------------------------------|----------|
| `<Race>` | string | `<Rank>`<br>`<Totalpoints>`<br>`<Bonuspoints>` | required |

Attributes of `<Race>`:

| Element  | Attribute | Attribute values      |
|----------|-----------|-----------------------|
| `<Race>` | `no`      | Number of race in cup |

## 4.13 `<Race>`

| Element         | Data   | Description                            | Required |
|-----------------|--------|----------------------------------------|----------|
| `<Rank>`        | string | Rank in race                           | required |
| `<Totalpoints>` | string | Total cup points for this race         | required |
| `<Bonuspoints>` | string | Contained bonus points in total points | required |

## 4.14 Example cup standing

```xml
<?xml version="1.0" encoding="utf-8"?>
<Fisresults>
  <XMLversion>2.2</XMLversion>
  <Cup>
    <CUPInfo Sector="CC">
      <Season>2011</Season>
      <CUPSex>M</CUPSex>
      <CUPID>WC</CUPID>
      <Discipline>ALL</Discipline>
      <Standingdate>
        <Day>19</Day>
        <Month>11</Month>
        <Year>2010</Year>
      </Standingdate>
      <CUPraces>
        <Race no="1">
          <Codex>1234</Codex>
          <Place>Gällivare</Place>
          <Racedate>
            <Day>19</Day>
            <Month>11</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <Race no="2">
          <Codex>2345</Codex>
          <Place>Kuusamo</Place>
          <Racedate>
            <Day>24</Day>
            <Month>11</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <Race no="3">
          <Codex>3456</Codex>
          <Place>Düsseldorf</Place>
          <Racedate>
            <Day>4</Day>
            <Month>12</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <!-- ... further <Race> elements omitted ... -->
      </CUPraces>
    </CUPInfo>
    <CUPclassified>
      <CUPstandings>
        <Rank>1</Rank>
        <Competitor>
          <Fiscode>3510023</Fiscode>
          <Lastname>COLOGNA</Lastname>
          <Firstname>Dario</Firstname>
          <Nation>SUI</Nation>
        </Competitor>
        <Pointsdescend>300</Pointsdescend>
        <CUPdetails>
          <Race no="1">
            <Totalpoints>100</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="2">
            <Totalpoints>95</Totalpoints>
            <Bonuspoints>15</Bonuspoints>
          </Race>
          <Race no="3">
            <Totalpoints>105</Totalpoints>
            <Bonuspoints>5</Bonuspoints>
          </Race>
          <!-- ... further <Race> elements omitted ... -->
        </CUPdetails>
      </CUPstandings>
      <CUPstandings>
        <Rank>2</Rank>
        <Competitor>
          <Fiscode>3420239</Fiscode>
          <Lastname>NORTHUG</Lastname>
          <Firstname>Petter</Firstname>
          <Nation>NOR</Nation>
        </Competitor>
        <Pointsdescend>260</Pointsdescend>
        <CUPdetails>
          <Race no="1">
            <Totalpoints>80</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="2">
            <Totalpoints>100</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="3">
            <Totalpoints>80</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <!-- ... further <Race> elements omitted ... -->
        </CUPdetails>
      </CUPstandings>
      <!-- ... further <CUPstandings> elements omitted ... -->
    </CUPclassified>
  </Cup>
</Fisresults>
```

## 4.15 Example nation cup standing

```xml
<?xml version="1.0" encoding="utf-8"?>
<Fisresults>
  <XMLversion>2.2</XMLversion>
  <Cup>
    <CUPInfo Sector="CC">
      <Season>2018</Season>
      <CUPSex>M</CUPSex>
      <CUPID>NC-WC</CUPID>
      <Discipline>ALL</Discipline>
      <Standingdate>
        <Day>19</Day>
        <Month>11</Month>
        <Year>2010</Year>
      </Standingdate>
      <CUPraces>
        <Race no="1">
          <Codex>1234</Codex>
          <Place>Gällivare</Place>
          <Racedate>
            <Day>19</Day>
            <Month>11</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <Race no="2">
          <Codex>2345</Codex>
          <Place>Kuusamo</Place>
          <Racedate>
            <Day>24</Day>
            <Month>11</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <Race no="3">
          <Codex>3456</Codex>
          <Place>Düsseldorf</Place>
          <Racedate>
            <Day>4</Day>
            <Month>12</Month>
            <Year>2010</Year>
          </Racedate>
        </Race>
        <!-- ... further <Race> elements omitted ... -->
      </CUPraces>
    </CUPInfo>
    <CUPclassified>
      <CUPstandings>
        <Rank>1</Rank>
        <Competitor>
          <Nationname>Switzerland</Nationname>
          <Nation>SUI</Nation>
        </Competitor>
        <Pointsdescend>300</Pointsdescend>
        <CUPdetails>
          <Race no="1">
            <Totalpoints>100</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="2">
            <Totalpoints>95</Totalpoints>
            <Bonuspoints>15</Bonuspoints>
          </Race>
          <Race no="3">
            <Totalpoints>105</Totalpoints>
            <Bonuspoints>5</Bonuspoints>
          </Race>
          <!-- ... further <Race> elements omitted ... -->
        </CUPdetails>
      </CUPstandings>
      <CUPstandings>
        <Rank>2</Rank>
        <Competitor>
          <Nationname>Norway</Nationname>
          <Nation>NOR</Nation>
        </Competitor>
        <Pointsdescend>260</Pointsdescend>
        <CUPdetails>
          <Race no="1">
            <Totalpoints>80</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="2">
            <Totalpoints>100</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <Race no="3">
            <Totalpoints>80</Totalpoints>
            <Bonuspoints></Bonuspoints>
          </Race>
          <!-- ... further <Race> elements omitted ... -->
        </CUPdetails>
      </CUPstandings>
      <!-- ... further <CUPstandings> elements omitted ... -->
    </CUPclassified>
  </Cup>
</Fisresults>
```

# 5. Document Control

| Version History          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|--------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Version 2.0 (27.11.2012) | Update of version 1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Version 2.1 (10.12.2013) | add file name definition                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Version 2.2 (20.11.2018) | Update Nationcup, corrections, add XML description version                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Version 2.3 (18.10.2019) | Changed Ladies to Women, L to W,L = Ladies to F = Female.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Version 2.4 (10.09.2026) | Converted the document to Markdown as the document base<br>Moved Document Control to the end of the document<br>Added chapter numbering<br>Page layout changed from landscape to A4 portrait<br>Corrected the domain of the FIS email addresses and made them links<br>Removed the alternative alpineresults address<br>Element reference tables regrouped into a child elements table and a separate attributes table, with value lists written at the end of the description and a line above each attributes table naming what it belongs to<br>Corrected a change-log entry that disagreed with the cover<br>Corrected spelling errors<br>Corrected a German month name to English<br>Replaced typographic quotes in the examples with straight quotes<br>Corrected malformed tags in the examples<br>Added a missing word to the note about the examples<br>Aligned the spelling of "organizing" with the other FIS XML descriptions<br>Replaced the bare "..." omission markers in the examples with XML comments naming what is omitted<br>Removed the sentence stating that earlier versions of the description remain valid<br>Added the sector values MA, PAL, PCC and PSB |