reda.029 — Calendar Query

The ISO 20022 tool to query a payment-system calendar: which business days, which holidays, which settlement dates, over which period.

Purpose and place in the flow

reda.029 belongs to the reda (Reference Data) family that covers ISO 20022 reference data management: identifiers, calendars, holiday schedules, fee structures. The Calendar Query message is used to query a payment system or market calendar provider:

• get the list of business / holiday days for T2 (Eurosystem) in 2026;
• find the SEPA SCT cut-off times for the SEPA zone on a given day;
• retrieve Fedwire and CHIPS settlement days in the US;
• query a market calendar (Euronext Paris, NYSE).

The response comes as reda.030 (Calendar Report) which contains the list of days and their characteristics (business, holiday, cut-off times, active currencies). The query-response cycle lets participants synchronise their pricing and scheduling engines without relying on manual downloads.

XML structure

The message is wrapped in <Document> with the version namespace, then in the root <CalQry> (Calendar Query). Three main blocks:

• MsgId (Message Identification) — unique message identifier + creation datetime.
• QryDef (Query Definition) — query definition, either new criterion (NewCrit) or modification of an existing query (MdfctnCrit).
• QryDef/NewCrit/SchCrit (Search Criteria) — search criteria: targeted system (Sys), period (Prd), country, currency (per profile).

Key fields

• MsgId/Id — unique query identifier. Max 35 chars. Keep for matching with the reda.030 response.
• MsgId/CreDtTm — query creation datetime.
• QryDef/QryNm — query name (may be reused across runs).
• QryDef/NewCrit/NewQryNm — new query definition name on requester side.
• QryDef/NewCrit/SchCrit/Sys/SysCd — queried system code. T2 (Eurosystem TARGET2 / T2), CHIPS, FEDWIRE, RT1, EURO1, etc.
• QryDef/NewCrit/SchCrit/Prd/FrToDt — queried period (FrDt from-date, ToDt to-date) in ISO 8601 format.
• QryDef/NewCrit/SchCrit/Ctry — country (ISO 3166-1 alpha-2) if relevant.
• QryDef/NewCrit/SchCrit/Ccy — currency (ISO 4217) if relevant.

XML example

T2 (Eurosystem) calendar query for Q2 2026 (April to June):

<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:reda.029.001.01">
  <CalQry>
    <MsgId>
      <Id>CALQRY-2026-05-14-001</Id>
      <CreDtTm>2026-05-14T10:00:00+01:00</CreDtTm>
    </MsgId>
    <QryDef>
      <QryNm>T2-Calendar-2026</QryNm>
      <NewCrit>
        <NewQryNm>T2-Q2-2026</NewQryNm>
        <SchCrit>
          <Sys>
            <SysCd>T2</SysCd>
          </Sys>
          <Prd>
            <FrToDt>
              <FrDt>2026-04-01</FrDt>
              <ToDt>2026-06-30</ToDt>
            </FrToDt>
          </Prd>
        </SchCrit>
      </NewCrit>
    </QryDef>
  </CalQry>
</Document>

• MsgId/Id: unique requester reference.
• QryDef/QryNm: logical query name (reusable for updates).
• SchCrit/Sys/SysCd: T2 — Eurosystem TARGET T2 system.
• SchCrit/Prd/FrToDt: 1 April to 30 June 2026.

Versions

Common pitfalls

• Unsupported SysCd — each calendar provider maintains its own list of supported system codes. Querying EURONEXT on a T2-only server returns an empty reda.030.
• Period too long — many providers cap the queried period (typically 1 year max). A 2020-2030 query is rejected or returns a truncated response.
• Incorrect date format — FrDt / ToDt require ISO 8601 YYYY-MM-DD. 2026-13-01 or 14/05/2026 are rejected.
• No Ccy for a multi-currency calendar — some systems (SWIFT gpi) handle several currencies with different cut-offs. Specify Ccy=EUR to avoid receiving an unnecessary super-set.
• Uncorrelated response — always reconcile the reda.030 via the request's MsgId/Id. Otherwise, two parallel queries get mixed up.
• Stale local cache — holiday calendars evolve (mobile holidays, regulatory changes). Re-query at least once per month.

Related messages

• reda.030 — Calendar Report: response to reda.029.
• reda.066 — Request to Pay Creditor Enrolment Request: other reda message.
• reda.017 — Securities Identification Modification Notification.
• admi.005 — Report Query Request: generic report request.
• camt.060 — Account Reporting Request: cash-management equivalent.