> For the complete documentation index, see [llms.txt](https://mojaloop.gitbook.io/mojaloop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mojaloop.gitbook.io/mojaloop/website/versioned_docs/v1.0.1/api/fspiop/definitions.md).

# FSPIOP API

## Versions

| Version                                                                                                    | Date       | Change Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------------------------------------------------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [1.0](https://github.com/mojaloop/documentation/blob/master/docs/api/fspiop/v1.0/api-definition/README.md) | 2018-03-13 | Initial version                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [1.1](https://github.com/mojaloop/documentation/blob/master/docs/api/fspiop/v1.1/api-definition/README.md) | 2020-05-19 | <p>1. This version contains a new option for a Payee FSP to request a commit notification from the Switch. The Switch should then send out the commit notification using the new request <strong>PATCH /transfers/</strong><em>{ID}</em>. The option to use commit notification replaces the previous option of using the ”Optional Additional Clearing Check”. The section describing this has been replaced with the new section ”Commit Notification”. As the <strong>transfers</strong> resource has been updated with the new <strong>PATCH</strong> request, this resource has been updated to version 1.1. As part of adding the possibility to use a commit notification, the following changes has been made:<br>a. PATCH has been added as an allowed HTTP Method in Section 3.2.2. b. The call flow for <strong>PATCH</strong> is described in Section 3.2.3.5.<br>c. Table 6 in Section 6.1.1 has been updated to include <strong>PATCH</strong> as a possible HTTP Method.<br>d. Section 6.7.1 contains the new version of the <strong>transfers</strong> resource.<br>e. Section 6.7.2.6 contains the process for using commit notifications<br>f. Section 6.7.3.3 describes the new <strong>PATCH /transfers</strong>/<em>{ID}</em> request.<br><br>2. In addition to the changes mentioned above regarding the commit notification, the following non-API affecting changes has been made:<br>a. Updated Figure 6 as it contained a copy-paste error.<br>b. Added Section 6.1.2 to describe a comprehensive view of the current version for each resource.<br>c. Added a section for each resource to be able to see the resource version history.<br>d. Minor editorial fixes.<br><br>3. The descriptions for two of the HTTP Header fields in Table 1 have been updated to add more specificity and context<br>a. The description for the <strong>FSPIOP-Destination</strong> header field has been updated to indicate that it should be left empty if the destination is not known to the original sender, but in all other cases should be added by the original sender of a request.<br>b. The description for the <strong>FSPIOP-URI</strong> header field has been updated to be more specific.<br><br>4. The examples used in this document have been updated to use the correct interpretation of the Complex type ExtensionList which is defined in Table 84. This doesn’t imply any change as such.<br>a. Listing 5 has been updated in this regard.<br><br>5. The data model is updated to add an optional ExtensionList element to the <strong>PartyIdInfo</strong> complex type based on the Change Request: <https://github.com/mojaloop/mojaloop-specification/issues/30>. Following this, the data model as specified in Table 103 has been updated. For consistency, the data model for the <strong>POST /participants/</strong><em>{Type}/{ID}</em> and <strong>POST /participants/</strong><em>{Type}/{ID}/{SubId}</em> calls in Table 10 has been updated to include the optional ExtensionList element as well.<br><br>6. A new Section 6.5.2.2 is added to describe the process involved in the rejection of a quote.<br><br>7. A note is added to Section 6.7.4.1 to clarify the usage of ABORTED state in <strong>PUT /transfers/</strong><em>{ID}</em> callbacks.</p> |
| **1.1.1**                                                                                                  | 2021-09-22 | This document version only adds information about optional HTTP headers regarding tracing support in [Table 2](#table-2), see *Distributed Tracing Support for OpenAPI Interoperability* for more information. There are no changes in any resources as part of this version.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
