IRIS Subtitle Orders & Media Feed Namespace

Feed Endpoints

Pagination & Updates

.../rss/subtitles/iyuno/orders?limit=50&offset=0   
.../rss/subtitles/iyuno/orders?limit=50&offset=50  

Both media URLs expire

Element Reference

Channel

Shared by both feed shapes, except lastBuildDate as noted.

Item — Orders feed

Elements are listed in the order they appear in the feed. Treat every optional element as optional in practice — older items predate later additions and simply omit them. The editorial titles are the main source of variation: a single work carries iris:title, while an episode of a series carries the iris:series* and iris:episode* family instead.

Item — Media feed

Media items carry no editorial metadata; look the order up by its identifier for that. All three iris: elements below also carry a human-readable description attribute, which is a fixed label and safe to ignore.

Full XML Examples

Orders feed

<?xml version="1.0" encoding="UTF-8"?>

<rss version="2.0"
  xmlns:iris="https://rss.iris.a2d.tv/ns/media/1.0/"
  xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Subtitle Orders Feed (IYUNO)</title>
    <description>Latest subtitle orders</description>
    <link>https://example.com/</link>
    <lastBuildDate>Wed, 17 Sep 2025 14:21:44 GMT</lastBuildDate>
    <atom:link rel="self" href="https://api.iris.a2d.tv/rss/subtitles/iyuno/orders?limit=50&amp;offset=0"></atom:link>
    <atom:link rel="next" href="https://api.iris.a2d.tv/rss/subtitles/iyuno/orders?limit=50&amp;offset=50"></atom:link>

    <item>
      <guid isPermaLink="false">7b7c56f8-cfdd-4f20-b0b4-fe4586207a9c</guid>
      <title>Subtitle Order for Halv åtta hos mig (S28E13) (sv)</title>
      <pubDate>Wed, 17 Sep 2025 14:21:44 GMT</pubDate>
      <iris:updatedAt>2025-09-17T14:21:44Z</iris:updatedAt>
      <iris:materialId>M0637100</iris:materialId>
      <iris:deadline>2099-12-29T13:00:00Z</iris:deadline>
      <iris:costLocation>TV4 Commissioned</iris:costLocation>
      <iris:targetLanguageTag>sv</iris:targetLanguageTag>
      <iris:targetSubtitleFormats>TTML</iris:targetSubtitleFormats>
      <iris:status>RECEIVED</iris:status>
      <iris:season>28</iris:season>
      <iris:episode>13</iris:episode>
      <iris:duration>00:22:00</iris:duration>
      <iris:seriesTitle>Halv åtta hos mig XXVIII 2</iris:seriesTitle>
      <iris:seriesDomesticTitle>Halv åtta hos mig</iris:seriesDomesticTitle>
      <iris:seriesProductionTitle>Halv åtta hos mig</iris:seriesProductionTitle>
      <iris:episodeTitle>Göteborg – Finalen</iris:episodeTitle>
      <iris:episodeDomesticTitle>Göteborg – Finalen</iris:episodeDomesticTitle>
      <iris:sourceLanguage>en</iris:sourceLanguage>
    </item>
  </channel>
</rss>

Media feed

Note that iris:guid is empty and carries the order identifier in its value attribute.

<?xml version="1.0" encoding="UTF-8"?>

<rss version="2.0"
  xmlns:iris="https://rss.iris.a2d.tv/ns/media/1.0/"
  xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Subtitle Media Feed (IYUNO)</title>
    <description>Latest subtitle media files and links</description>
    <link>https://example.com/</link>
    <atom:link rel="self" href="https://api.iris.a2d.tv/rss/subtitles/iyuno/media?limit=50&amp;offset=0"></atom:link>

    <item>
      <guid isPermaLink="false">2a9e4d15-7c30-4f88-9b21-0e5a6c7d8f90</guid>
      <title>Subtitle Order for Halv åtta hos mig (S28E13) (sv)</title>
      <description>Burnt-in time code proxy (BITC) video file and upload portal link for the delivery of subtitle file.</description>
      <iris:bitc description="Burnt-in time code proxy video file">
        <![CDATA[https://irismezztranscode-general-irisprod1-bitc-storage.s3.eu-north-1.amazonaws.com/3c1a7e50-9d84-4b62-8f10-2a6b5c4d3e91/1/3c1a7e50-9d84-4b62-8f10-2a6b5c4d3e91_2000_1080p_bitc.mp4?X-Amz-Expires=604800&X-Amz-Signature=ZBzQ...HA__]]>
      </iris:bitc>
      <iris:guid value="7b7c56f8-cfdd-4f20-b0b4-fe4586207a9c" description="Internal identifier referencing the subtitle order associated with this media"></iris:guid>
      <iris:upload description="Upload portal for the delivery of subtitle file">
        <![CDATA[https://portal.iris.a2d.tv/new/M0637100/halv-atta-hos-mig-xxviii-2-s28e13/EXAMPLEt0k3n]]>
      </iris:upload>
      <pubDate>Wed, 17 Sep 2025 14:21:44 GMT</pubDate>
    </item>
  </channel>
</rss>

Schema

The authoritative schema is published at schema.xsd, alongside this page. It is reproduced below for convenience.

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="https://rss.iris.a2d.tv/ns/media/1.0/"
            xmlns="https://rss.iris.a2d.tv/ns/media/1.0/"
            elementFormDefault="qualified">

  <!-- ===== Common simple types ===== -->
  <xsd:simpleType name="HHMMSS">
    <xsd:restriction base="xsd:string">
      <xsd:pattern value="\d{2}:\d{2}:\d{2}"/>
    </xsd:restriction>
  </xsd:simpleType>

  <xsd:simpleType name="OrderStatus">
    <xsd:restriction base="xsd:string">
      <xsd:enumeration value="RECEIVED"/>
      <xsd:enumeration value="CANCELLED"/>
      <xsd:enumeration value="FULFILLED"/>
    </xsd:restriction>
  </xsd:simpleType>

  <!-- ===== Orders feed elements (iris:*) ===== -->

  <!-- Last modification of the order (ISO-8601 UTC, seconds precision) -->
  <xsd:element name="updatedAt" type="xsd:dateTime"/>

  <!-- Identifier of the target material the finished subtitle belongs to -->
  <xsd:element name="materialId" type="xsd:string"/>

  <!-- Delivery deadline in UTC (ISO-8601) -->
  <xsd:element name="deadline" type="xsd:dateTime"/>

  <!-- Accounting or commissioning cost center / label -->
  <xsd:element name="costLocation" type="xsd:string"/>

  <!-- Target subtitle language (BCP-47) -->
  <xsd:element name="targetLanguageTag" type="xsd:string"/>

  <!-- Desired subtitle format - always a single value, never a list -->
  <xsd:element name="targetSubtitleFormats" type="xsd:string"/>

  <!-- Order lifecycle status -->
  <xsd:element name="status" type="OrderStatus"/>

  <!-- Season run order -->
  <xsd:element name="season" type="xsd:integer"/>

  <!-- Episode run order -->
  <xsd:element name="episode" type="xsd:integer"/>

  <!-- Program duration (HH:MM:SS) -->
  <xsd:element name="duration" type="HHMMSS"/>

  <!-- Title of a single (non-episodic) work -->
  <xsd:element name="title" type="xsd:string"/>

  <!-- Localized/domestic title of a single work -->
  <xsd:element name="domesticTitle" type="xsd:string"/>

  <!-- Production title of a single work -->
  <xsd:element name="productionTitle" type="xsd:string"/>

  <!-- Canonical series title -->
  <xsd:element name="seriesTitle" type="xsd:string"/>

  <!-- Localized/domestic series title -->
  <xsd:element name="seriesDomesticTitle" type="xsd:string"/>

  <!-- Production title of the series -->
  <xsd:element name="seriesProductionTitle" type="xsd:string"/>

  <!-- Episode title -->
  <xsd:element name="episodeTitle" type="xsd:string"/>

  <!-- Localized/domestic episode title -->
  <xsd:element name="episodeDomesticTitle" type="xsd:string"/>

  <!-- Original/source language (BCP-47) -->
  <xsd:element name="sourceLanguage" type="xsd:string"/>

  <!-- ===== Media feed elements (iris:*) ===== -->

  <!-- Burnt-in time code (BITC) proxy video URL. Presigned when the media
       record is created and stored as-is, so it expires ~7 days after pubDate -->
  <xsd:element name="bitc">
    <xsd:complexType>
      <xsd:simpleContent>
        <xsd:extension base="xsd:anyURI">
          <xsd:attribute name="description" type="xsd:string"/>
        </xsd:extension>
      </xsd:simpleContent>
    </xsd:complexType>
  </xsd:element>

  <!-- Upload portal URL for delivering the finished subtitle file. Minted when
       the media record is created and stored as-is, so it expires on its own clock -->
  <xsd:element name="upload">
    <xsd:complexType>
      <xsd:simpleContent>
        <xsd:extension base="xsd:anyURI">
          <xsd:attribute name="description" type="xsd:string"/>
        </xsd:extension>
      </xsd:simpleContent>
    </xsd:complexType>
  </xsd:element>

  <!-- Back-reference to the subtitle order; the identifier is carried in the
       "value" attribute and the element itself is empty -->
  <xsd:element name="guid">
    <xsd:complexType>
      <xsd:attribute name="value" type="xsd:string" use="required"/>
      <xsd:attribute name="description" type="xsd:string"/>
    </xsd:complexType>
  </xsd:element>

</xsd:schema>