Sorry, you need to enable JavaScript to visit this website.

gpi API release policy and versioning

Updated in August 2022


For SR2022 (November 2022), the gpi API offering will include:

  • No new version release (i.e. no v6) for the core gpi services (gCCT/gCOV/gFIT) and Universal Confirmation
  • Introduction of a v6 for the Case Resolution and Stop & Recall services
  • Introduction of a v5 PMI API


Please note that:

  • For core gpi services, a light tracking functionality for return payment is being developed for SR2022 using the GET v5 APIs (launched with SR2021). More information will follow during Q3 2022.
  • For Case Resolution and Stop & Recall, the v6 specifications will support new features including, but not limited to:      
  • Enablement for CASE assigner to assign case to specific assignee (rather than relying on the default automatic assignment process of the Tracker)
  • A new GET API informing users about the parties involved a payment transaction, as well as their Case Resolution and Stop & Recall reachability status
  • A new GET API to enable users to identify the most current Stop & Recall details
  • The new PMI API is supporting the use case whereby PMIs actively update the transaction status for PMI flows on behalf of their PMI customers.

Standardisation and versioning strategy remain the two biggest challenges in the API industry. While API versions reflect a living product, versioning should be controlled to allow customers sufficient time to transition from one version to another, while ensuring the product stays up-to-date. This is the reason why the gpi API release policy and versioning strategy respect a consistent and comprehensive policy.

The gpi Tracker follows a monthly minor release cycle (including changes on services for early adopters or in pilot and bug fixes) and a major release cycle every year in November, fully aligned with the Standards Release. gpi APIs follow the same release cycle and the November gpi API release is supporting the latest Tracker functional enhancements. The second last version is supported and provides backward compatibility to the latest Tracker updates, however does not expose the latest enhancements.

New versions are increased by one major version number and the API version number is reflected in the URL of the API. SWIFT always supports two consecutive gpi API versions and keeps the older API version in maintenance mode for 6 months, allowing customer upgrade to one of the two supported versions.

The table below shows which versions will be available on a 12 months release cycle, starting in November each year (November is aligned with the Standards Release date that year).

API release cycle per year Current year N Year N+1 Year N+2
New release (supported) Version X Version X+1 Version X+2
Second last release (supported until November) Version X-1 Version X Version X+1
Third last (6 months maintenance from November until April). End of Support and decommissioning the last week-end of April Version X-2 Version X-1 Version X


Maintenance: SWIFT does not deliver any bug fix between November of year N+1 and 30 April of year N+2.

Example: gpi API version X is launched in November year N, is supported for 2 full years (year N and N+1) and goes into maintenance before decommissioning until end April of the year N+2.


Every year SWIFT will publish the next API version specifications and rulebook along the following schedule.

First draft for review Swaggerhub Final API + Sandbox SWIFT Developer Portal Pilot Live
April - May May - June July November


Moving forward, to provide customers more time to review and analyse the specifications, SWIFT will publish the API specifications earlier during Q1 while keeping to the consistent release cycles.

gpi Overview

For more information on gpi, see the gpi overview page.

Version Enhancements

SWIFT gpi v4 introduced changes to make API easier to use. Download the PDF to see the list of differences between v4 and v3 and other useful information.

SWIFT gpi v5 API Enhancement

SWIFT gpi v4 API Enhancement