> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-classic/api-reference/document-history.md).

# Document History

| Release | Date (dd/mm/yyyy) | Modifications                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1.0.0   | 20/09/2018        | First release of the TES API                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.1   | 01/10/2018        | <ul><li><p>add new error codes</p><ul><li>declined provisionCard</li><li>account mismatch</li><li>invalid perso data</li><li>operation not allowed with current card state</li></ul></li><li>add timestamp optional parameter for request/response headers</li><li>add 'unknown' value for card capture method</li><li>add keyIndex parameter for cardPersoData</li><li>updateCardState (TES to TSH) has new action PARK\_AND\_DELETE</li><li>updateCardState (TSH to TES) has new action BLACKLIST</li><li>updateCardState (TSH to TES) has new action BLACKLIST</li><li>states returned in getCards have been updated to CREATED, ACTIVE, SUSPENDED\_ISSUER, SUSPENDED\_WALLET, BLACKLISTED and DELETED</li></ul>                                                                                                                                                                                                                                                               |
| 1.0.2   | 22/10/2018        | <ul><li>add new deviceType "UNKNOWN"</li><li>add new error code "provisioning count exceeded"</li><li>fix typo on phoneNumerLastDigits, replaced by phoneNumberLastDigits</li><li>add optional parameter "displayCardNumber" in provisionCard response</li><li>remove PARK\_AND\_DELETE action from updateCardState (TES to TSH)</li><li>add new API sendMessage allowing TES to request message delivery to user</li><li>remove BLACKLISTED state from getCards and BLACKLIST action from updateCardState (TSH to TES)</li><li>add new API refundCardAccount allowing TES to notify TSH that a card account has been refunded</li><li>Fix issue in TES to TSH swagger for cardPersoData type</li><li>Replace PARK\_CARD operation by BLOCK\_AND\_READ\_CARD in initiateCardSession</li><li>update parameter operation to newState for updateCardState (TSH to TES) and values associated to reflect that this call is made to notify the change and not to request it.</li></ul> |
| 1.0.3   | 05/11/2018        | <ul><li>increase length of orderId and purchaseId to 64 instead of 48</li><li><p>add new parameters in paymentInstrument parameter (applicable for createCardAccound and topupCardAccount)</p><ul><li>version</li><li>header</li><li>signature</li></ul></li><li>add new output parameter "signature" to createCardAccount and topupCardAccount</li><li>statusCode in responseHeader is now mandatory</li><li>add new API getRequestStatus + new error code "unknow request"</li><li>add new LCM action "ERASE" for GDPR / RoI compliancy</li><li>add new API getRequestStatus + new error code "unknow request"</li><li>add customerData parameter in provisionCard</li></ul>                                                                                                                                                                                                                                                                                                    |
| 1.0.4   | 10/12/2018        | <ul><li>remove obsolete APIs "getPurchaseStatus" and "updatePurchaseStatus"</li><li>New Device GW API getParkCardCommands for park card</li><li><p>add new error codes for createCardAccount and topupCardAccount</p><ul><li>419 PIN required</li><li>420 PIN incorrect</li><li>421 PIN locked</li></ul></li><li>Error in updateCardState (TSH to TES), purchaseId removed from response</li><li>Add productId in createCardAccount request</li><li>Add cardLastDigits in provisionCard</li><li>Fix prefix URL for transit notifications API (from xxx/v1.0 to xxx/1/0)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.0.5   | 07/01/2019        | <ul><li>remove RECEIVED status from getRequestStatus API response</li><li>add new error code 166 for invalid card information</li><li>signature and paymentData in paymentInstrument are restricted to 8192 characters max</li><li>add new parameter wrappedKey in paymentInstrument (used for RSA algorithm) for createCardAccount and topupCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.6   | 01/02/2019        | <ul><li>add new method updateCardMetadata for commute plans management</li><li>add cardContents object parameter in getReaderModeCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.0.7   | 08/02/2019        | <ul><li>add support for localized title on commute plans</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.8   | 21/02/2019        | <ul><li>align operation possible values between initiateCardSession and getCardCommands</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.0.9   | 18/03/2019        | <ul><li>New state "UNLINKED" can be sent in updateCardState (TSH to TES)</li><li>Update getCards API for managing UNLINKED card state and it will now return the card account state</li><li>New optional parameter in provisionCard response "cardholderName"</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.10  | 02/04/2019        | <ul><li><p>Add new error codes in device gateway API</p><ul><li>172 Invalid card, unsupported system code</li><li>173 Invalid card, unsupported service</li><li>177 Invalid card, invalid area data</li><li>178 Invalid card, card status is in-station</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.0.11  | 16/04/2019        | <ul><li><p>update getCards response</p><ul><li>cardAccountId removed</li><li>walletAccountId, cardAccountState and walletCardAccountId are at top level</li></ul></li><li>update provisionCard response for cardholder name localization management</li><li><p>update getParkCardCommands and getReaderModeCommands</p><ul><li>add new parameter "cardData" in response</li><li>cardData contains "balanceAmount"</li></ul></li><li>error code 221 added for TES to TSH api</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.12  | 24/04/2019        | <ul><li>add error codes in device gateway for taking into account new client TSM spec 2.2</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| 1.0.13  | 17/05/2019        | <ul><li>rename operation value "RENEW\_CARD" to "UPDATE\_PLAN"</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.14  | 27/05/2019        | <ul><li><p>update of notifyOperationResult</p><ul><li>cardId is now optional</li><li>add optional parameter purchaseId</li><li>add optional parameter cardAccountId</li><li>add parameter isProvisioning</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.15  | 06/06/2019        | <ul><li>walletAccountId is removed from createCardAccount (only sent in provisionCard)</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.16  | 23/07/2019        | <ul><li>removal of retryCount from device gateway methods</li><li>removal of error 922</li><li>add error 432 for TSH to TES methods</li><li>increase card perso data length to 8192 instead of 500</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.17  | 11/12/2019        | <ul><li>remove enum constraint on walletProviderId provided in checkCardAccount</li><li>add new HTTP header x-actor-id on device-gateway and transit-tsh-to-tes. This header indicates the wallet provider initiating the request. Its value corresponds to the walletProviderId as defined in checkCardAccount</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 1.0.18  | 26/10/2020        | <ul><li>add new optional parameter "resultData" in notifyOperationResult to provide extra information to TES</li><li>add new parameter "purchaseId" that is given by TSH to TES in getCardCommands when it's related to topup initiated from wallet.</li><li>add new parameter "cardData" in provisionCard response.</li><li>add new optional parameter "opaqueServiceProviderData" in createCardAccount and topupCardAccount requests.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 1.0.19  | 30/11/2021        | <ul><li>add new function getCardAccountsMetadata</li><li>add new function getCardActions</li><li>add new optional parameter 'cardArtManifest' in checkCardAccount response and in updateCardMetadata request</li><li>add new function getAsset</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 1.0.20  | 28/02/2024        | <ul><li>add new parameter (array of objects) "title" within cardActions object from getCardActions response in order to allow replacing predefined values statically provisioned</li><li>add <a href="https://thales-dis-dbp.stoplight.io/docs/digital-transit/33e2dd0faee3a-calypso-toc">Calypso truth on card data preparation</a> section</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.21  | 14/1/2024         | <ul><li>add new parameter 'mobileApplicationInfo' in 'checkCardAccount' response</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.22  | 11/12/2025        | <ul><li>add new optional parameter 'cardArtManifest' in provisionCard response</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/transit-classic/api-reference/document-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.