> 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/d1-v1-api/d1-v1-api-references/card-operations/inbound/operations.md).

# Operations

Different operations that can be done on a card.

## Resume

> This request is used by the issuer backend to request the reactivation of a card that has been suspended.\
> \
> This operation is only applicable to the card, and needs to be consistent with the other states. For instance, it's useless/forbidden to resume a card from a deactivated end user.\
> \
> For registered cards that are managed directly by the issuer, the issuer has the responsability to call the processor first then D1 to make sure the states are always synched.\
> \
> \*\*Note:\*\* It cannot be used to activate a physical card for the very first time.\
> For that, please refer to \[activatePhysicalCard]\(<https://thales-dis-dbp.stoplight.io/docs/d1-developer-portal/a2ebfce648687-card-activation>)

```json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"issuer-id-path":{"description":"The id of the issuer","in":"path","name":"issuerId","required":true,"schema":{"$ref":"#/components/schemas/issuerId"}},"card-id-path":{"description":"The id of the card","in":"path","name":"cardId","required":true,"schema":{"$ref":"#/components/schemas/cardId"}}},"schemas":{"issuerId":{"maxLength":10,"minLength":10,"type":"string"},"cardId":{"type":"string","description":"Unique identifier of the card.","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"operationStatusSuccessful":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["SUCCESSFUL"]}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"errorWithOperationId":{"type":"object","description":"Generic error and operationId returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."},"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]}}},"operationStatusFailed":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]}}}},"responses":{"OperationsInternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/operationStatusFailed"},{"$ref":"#/components/schemas/errorGeneric"}]}}}}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations:resume":{"post":{"description":"This request is used by the issuer backend to request the reactivation of a card that has been suspended.\n\nThis operation is only applicable to the card, and needs to be consistent with the other states. For instance, it's useless/forbidden to resume a card from a deactivated end user.\n\nFor registered cards that are managed directly by the issuer, the issuer has the responsability to call the processor first then D1 to make sure the states are always synched.\n\n**Note:** It cannot be used to activate a physical card for the very first time.\nFor that, please refer to [activatePhysicalCard](https://thales-dis-dbp.stoplight.io/docs/d1-developer-portal/a2ebfce648687-card-activation)","parameters":[{"$ref":"#/components/parameters/issuer-id-path"},{"$ref":"#/components/parameters/card-id-path"},{"$ref":"#/components/parameters/x-correlation-id"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","description":"The reason why the action has been performed. If not provided, default reason code is ISSUER_DECISION.","enum":["ISSUER_DECISION","USER_DECISION","DEVICE_FOUND","CARD_FOUND"]}}}}}},"responses":{"200":{"description":"Card resumed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/operationStatusSuccessful"}}}},"400":{"description":"Bad Request, Invalid request URI or header, or unsupported nonstandard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"401":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"403":{"description":"Forbidden operation. Check the state of the end user (consumer) is ACTIVE.\r\n\r\nAfter a migration done from D1 V1 APIs to D1 V2 APIs a 403 may be returned if\r\n\r\n- The reasonCode provided is not allowed. Check the card status, or set the reason code to ISSUER_DECISION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorWithOperationId"}}}},"404":{"description":"Card not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"500":{"$ref":"#/components/responses/OperationsInternalServerError"}},"summary":"Resume","tags":["Operations"],"operationId":"resumeCard"}}}}
```

## Suspend

> This request is used by the issuer backend to request the deactivation of a card that has been lost for instance.\
> \
> For registered cards that are managed directly by the issuer, the issuer has the responsability to call the processor first then D1 to make sure the states are always synched.

```json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"issuer-id-path":{"description":"The id of the issuer","in":"path","name":"issuerId","required":true,"schema":{"$ref":"#/components/schemas/issuerId"}},"card-id-path":{"description":"The id of the card","in":"path","name":"cardId","required":true,"schema":{"$ref":"#/components/schemas/cardId"}}},"schemas":{"issuerId":{"maxLength":10,"minLength":10,"type":"string"},"cardId":{"type":"string","description":"Unique identifier of the card.","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"operationStatusSuccessful":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["SUCCESSFUL"]}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"operationStatusFailed":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]}}}},"responses":{"OperationsInternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/operationStatusFailed"},{"$ref":"#/components/schemas/errorGeneric"}]}}}}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations:suspend":{"post":{"description":"This request is used by the issuer backend to request the deactivation of a card that has been lost for instance.\n\nFor registered cards that are managed directly by the issuer, the issuer has the responsability to call the processor first then D1 to make sure the states are always synched.","parameters":[{"$ref":"#/components/parameters/issuer-id-path"},{"$ref":"#/components/parameters/card-id-path"},{"$ref":"#/components/parameters/x-correlation-id"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","description":"The reason why the action has been performed. If not provided, default reason code is ISSUER_DECISION.","enum":["ISSUER_DECISION","USER_DECISION","DEVICE_LOST","DEVICE_STOLEN","CARD_LOST","CARD_STOLEN","CARD_BROKEN","CARD_EXPIRED"]}}}}}},"responses":{"200":{"description":"Card was suspended successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/operationStatusSuccessful"}}}},"400":{"description":"Bad Request, Invalid request URI or header, or unsupported nonstandard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"401":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"403":{"description":"After a migration done from D1 V1 APIs to D1 V2 APIs a 403 may be returned if\r\n\r\n- The reasonCode provided is not allowed. Check the card status, or set the reason code to ISSUER_DECISION","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"404":{"description":"Card not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"500":{"$ref":"#/components/responses/OperationsInternalServerError"}},"summary":"Suspend","tags":["Operations"],"operationId":"suspendCard"}}}}
```

## Delete

> This request is used by the issuer backend to request the deletion of a card.\
> \
> \<b>Note:\</b> The deletion of the card cannot be reversed. In the case of lost cards, consider using the Suspend operation first.

```json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"issuer-id-path":{"description":"The id of the issuer","in":"path","name":"issuerId","required":true,"schema":{"$ref":"#/components/schemas/issuerId"}},"card-id-path":{"description":"The id of the card","in":"path","name":"cardId","required":true,"schema":{"$ref":"#/components/schemas/cardId"}}},"schemas":{"issuerId":{"maxLength":10,"minLength":10,"type":"string"},"cardId":{"type":"string","description":"Unique identifier of the card.","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"operationStatusSuccessful":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["SUCCESSFUL"]}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"operationStatusFailed":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]}}}},"responses":{"OperationsNotFound":{"description":"Resource not found, Unknown issuerId or consumerId or accountId","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/operationStatusFailed"},{"$ref":"#/components/schemas/errorGeneric"}]}}}},"OperationsInternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/operationStatusFailed"},{"$ref":"#/components/schemas/errorGeneric"}]}}}}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations:delete":{"post":{"description":"This request is used by the issuer backend to request the deletion of a card.\n\n<b>Note:</b> The deletion of the card cannot be reversed. In the case of lost cards, consider using the Suspend operation first.","parameters":[{"$ref":"#/components/parameters/issuer-id-path"},{"$ref":"#/components/parameters/card-id-path"},{"$ref":"#/components/parameters/x-correlation-id"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","description":"The reason why the action has been performed. If not provided, default reason code is ISSUER_DECISION.","enum":["ISSUER_DECISION","USER_DECISION","DEVICE_LOST","DEVICE_STOLEN","CARD_LOST","CARD_STOLEN","CARD_BROKEN","CARD_EXPIRED"]}}}}}},"responses":{"200":{"description":"Card was deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/operationStatusSuccessful"}}}},"400":{"description":"Bad Request, Invalid request URI or header, or unsupported nonstandard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"401":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"403":{"description":"After a migration done from D1 V1 APIs to D1 V2 APIs a 403 may be returned if\r\n\r\n- The reasonCode provided is not allowed. Check the card status, or set the reason code to ISSUER_DECISION"},"404":{"$ref":"#/components/responses/OperationsNotFound"},"500":{"$ref":"#/components/responses/OperationsInternalServerError"}},"summary":"Delete","tags":["Operations"],"operationId":"deleteCard-v2"}}}}
```

## Renew

> This request is used by the issuer backend to renew/replace an existing card after card expiration or card loss.\
> \
> The 'newCardId' is used by D1 to fetch the new PAN and/or new expiry date to be updated from the CMS if those information are not provided in encryptedData parameter.\
> \
> \*\*Limitation\*\*: Card product update is currently not supported.<br>

```json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"parameters":{"issuer-id-path":{"description":"The id of the issuer","in":"path","name":"issuerId","required":true,"schema":{"$ref":"#/components/schemas/issuerId"}},"card-id-path":{"description":"The id of the card","in":"path","name":"cardId","required":true,"schema":{"$ref":"#/components/schemas/cardId"}}},"schemas":{"issuerId":{"maxLength":10,"minLength":10,"type":"string"},"cardId":{"type":"string","description":"Unique identifier of the card.","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"operationStatusSuccessful":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["SUCCESSFUL"]}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"operationStatusFailed":{"title":"operation","type":"object","description":"Operation result information.","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]}}}},"responses":{"OperationsInternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/operationStatusFailed"},{"$ref":"#/components/schemas/errorGeneric"}]}}}}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations:renew":{"post":{"description":"This request is used by the issuer backend to renew/replace an existing card after card expiration or card loss.\n\nThe 'newCardId' is used by D1 to fetch the new PAN and/or new expiry date to be updated from the CMS if those information are not provided in encryptedData parameter.\n\n**Limitation**: Card product update is currently not supported.\n","parameters":[{"$ref":"#/components/parameters/issuer-id-path"},{"$ref":"#/components/parameters/card-id-path"},{"$ref":"#/components/parameters/x-correlation-id"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["newCardId","newCardState"],"properties":{"newCardId":{"$ref":"#/components/schemas/cardId"},"newCardProductId":{"type":"string","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}","description":"Reserved for future use; card product update is currently not supported."},"newCardState":{"type":"string","description":"New state of the card after renew","enum":["ACTIVE","INACTIVE"]},"encryptedData":{"type":"string","title":"encryptedData","maxLength":8192,"pattern":"^(?:[\\x20-\\x2D\\x2F-\\x7F]*\\.){4}(?:[\\x20-\\x2D\\x2F-\\x7F]*)$","description":"The encryptedData is the encrypted json (cf http://www.json.org/ ) representation of the new card information.<br/>This field is mandatory for AMEX cards and optional information for all the other schemes, if not provided Thales will call **[get card credentials API](https://thales-dis-dbp.stoplight.io/docs/d1-api-public/8518eb9d80bc7-get-card-credentials)** to retrieve the data.<br/> This value is encrypted using the JWE encryption (please refer to the **[Encrypt sensitive data](../../../integrate-the-d1-api/encrypt-sensitive-data)** for more details)<br/><br/><b>Content</b><br/><br/>Once deciphered, the plaintext contains a json structure with:\n\t\n|JSON field parameter name|description|MOC|Format|\n|-------|-------|-------|-------|\n|pan|The funding pan value.|M|string - from 10 to 19 digits|\n|exp|The expiry date of the card.|M|string - 4 digits, following the format MMYY|\n|psn|PAN Sequence number.|O|string - 2 digits (only applicable to AMEX scheme)|\n|auxiliaryPan|The auxiliary funding pan value. It shall be provided when cobadge is supported and if the card has an auxiliary pan.|C|string - up to 19 digits|\n|auxiliaryExp|The auxiliary expiry date of the card. It shall be provided when cobadge is supported and if the card has an auxiliary pan.|C|string - 4 digits, following the format MMYY|"},"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","description":"The reason why the action has been performed. If not provided, default reason code is ISSUER_DECISION.","enum":["ISSUER_DECISION","USER_DECISION","CARD_LOST","CARD_STOLEN","CARD_BROKEN","CARD_EXPIRED"]}}}}}},"responses":{"200":{"description":"Card was renewed successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/operationStatusSuccessful"}}}},"400":{"description":"Bad Request, Invalid request URI or header, or unsupported nonstandard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"401":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"403":{"description":"Forbidden action, that can be blocked for different reasons:\n- end user (consumer) state shall be active,\n- in case the new card was already registered, check that the 2 cards belong to the same end user (consumer),\n- in case the new card was already registered, check that the new and old cards are linked to the same CardProductId.\n\nAfter a migration done from D1 V1 APIs to D1 V2 APIs a 403 may be returned if\n\n- The newCardId provided in the payload is equal to the cardId but the card PAN has been updated. When PAN needs to be updated, the V2 replace API should be called.\n- The newCardId provided in the payload is not equal to the cardId but the card PAN is still the same. When a card expiry date update without PAN update is required, the V2 renew API should be called.\n- The newCardId provided in the payload is not equal to the cardId but the state passed is INACTIVE. When a state INACTIVE is required, the V2 suspend API should be called after a renew v1 with ACTIVE.\n- The reasonCode provided in the payload is not allowed. Check the card status, or set the reason code to ISSUER_DECISION\n","content":{"application/json":{"schema":{"type":"object","properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"status":{"type":"string","description":"Status of the operation","enum":["FAILED"]},"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}}}}},"404":{"description":"Card not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"500":{"$ref":"#/components/responses/OperationsInternalServerError"}},"summary":"Renew","tags":["Operations"],"operationId":"renewCard-v2"}}}}
```

## Get all operations

> This request is used by the issuer backend to  retrieve all operations related to a card. The API specifies the starting point (offset) and the number of operations (limit) to be retrieved. Offset 0 (the default) corresponds to the most recent operation. For example a limit of 5 and an offset of 2 would return the five most recent operations before the most recent two”.\
> \
> If no operations are available for the given cardId, an empty list is returned.\
> \
> Operations that are older than 3 months are removed.

````json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"operationAllCard":{"title":"operationAllCard","type":"object","description":"Operation details related to a specific operationId in GetAllOperationsByCardId API","required":["operationId","operation","status","startTime","requestorType","requestorId"],"properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"operation":{"type":"string","description":"The operation type.","enum":["ACTIVATE","D1_PAY_ENROLMENT","CLICK_TO_PAY_ENROLMENT","CLICK_TO_PAY_UPDATE","CLICK_TO_PAY_OPTOUT","DELETE","DIGITIZE","DISPLAY","PIN_CHANGE","PIN_DISPLAY","PRODUCE","PUSH","REGISTER","RENEW","REPLACE","RESUME","SUSPEND","UPDATE_ORDER","VERIFY","CARDHOLDER_VERIFICATION"]},"status":{"type":"string","enum":["SUCCESSFUL","PENDING","FAILED"],"description":"Status of the operation"},"startTime":{"$ref":"#/components/schemas/operationStartTime"},"endTime":{"$ref":"#/components/schemas/operationEndTime"},"requestorType":{"type":"string","enum":["ISSUER","USER","TSP","CCI","D1"]},"requestorId":{"type":"string","description":"Identifier of the principal who initiates the operation\n  - consumerId if requestorType is USER\n  - issuerId if requestorType is ISSUER\n  - cci user id if requestorType is CCI\n  - D1 if it's an operation automatically triggered by D1 (can be card suspended due to several authorisation with invalid cvv)"},"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","enum":["USER_DECISION","ISSUER_DECISION","DEVICE_LOST","DEVICE_STOLEN","CARD_LOST","CARD_STOLEN","CARD_BROKEN","DEVICE_FOUND","CARD_FOUND","CARD_EXPIRED","CARD_NOT_RECEIVED","FRAUD","CLOSED_CARD","CLOSED_ACCOUNT"]},"details":{"oneOf":[{"title":"ACTIVATE operation","description":"Container to hold detailed information of ACTIVATE operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"D1_PAY_ENROLMENT operation","description":"Container to hole details information of D1 Pay enrolment operation","properties":{"digitalCardId":{"$ref":"#/components/schemas/digitalCardId"},"walletApplicationId":{"$ref":"#/components/schemas/walletApplicationId"}}},{"title":"DIGITIZE operation","description":"Container to hold detailed information regarding the executed operation (DIGITIZE)","properties":{"eligibilityInformation":{"$ref":"#/components/schemas/eligibilityInformation"},"digitizationInformation":{"$ref":"#/components/schemas/digitizationInformation"},"digitalCardId":{"$ref":"#/components/schemas/digitalCardId"}}},{"title":"DISPLAY operation","description":"Container to hold detailed information of DISPLAY operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"PIN_CHANGE operation","description":"Container to hold detailed information of PIN_CHANGE operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"},"pinType":{"type":"string","enum":["ISO0","3DES_SECCOS"],"description":"The type of PIN which is used for the card."}}},{"title":"PIN_DISPLAY operation","description":"Container to hold detailed information of PIN_DISPLAY operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"PRODUCE operation","description":"Container to hold detailed information of PRODUCE operation","properties":{"issuerRequestId":{"$ref":"#/components/schemas/operationId"},"dueDate":{"type":"string","format":"date","description":"The estimated card production date. It uses the format ```YYYY-MM-DD```."}}},{"title":"PUSH operations","description":"Container to hold detailed information of PUSH operations","properties":{"digitalCardRequestorId":{"type":"string","description":"Id of the token requestor to which we will push the card. Also known as TRID on scheme side.","minLength":11,"maxLength":11,"pattern":"[0-9]{11}"},"digitalCardRequestorName":{"type":"string","description":"Name of the token requestor to which we will push the card.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9 _-]{1,64}"},"program":{"type":"string","description":"Protocol or API that was involded in the PUSH operation.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9 _-]{1,64}"}}},{"title":"REGISTER, SUSPEND, RESUME, DELETE operations","description":"Container to hold any detailed information regarding the executed operation (REGISTER, SUSPEND, RESUME, RENEW, DELETE)","properties":{"oldState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED","SUSPENDED"],"description":"Old state of the card"},"newState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED","SUSPENDED"],"description":"New state of the card"},"consumerState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED"],"description":"The state of the end user (consumer).<br/>**Note**: Consumer state is deprecated, this optional parameter will soon be removed from the response."}}},{"title":"RENEW operation","description":"Container to hold detailed information of RENEW operation","properties":{"oldCardId":{"type":"string","description":"Old id of the card","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"newCardId":{"type":"string","description":"New id of the card","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"oldState":{"type":"string","enum":["ACTIVE","INACTIVE","SUSPENDED"],"description":"Old state of the card"},"newState":{"type":"string","enum":["ACTIVE","INACTIVE","SUSPENDED"],"description":"New state of the card"},"consumerState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED"],"description":"The state of the end user (consumer).<br/>**Note**: Consumer state is deprecated, this optional parameter will soon be removed from the response."}}},{"title":"UPDATE_ORDER operation","description":"Container to hold detailed information of UPDATE_ORDER operation","properties":{"pullType":{"$ref":"#/components/schemas/pullType"}}}],"type":"object"},"errorCode":{"type":"string","description":"External error code"},"error":{"type":"string","description":"Human readable string representing the error, only present in case of operation failure","maxLength":256,"minLength":0}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"operationStartTime":{"type":"string","title":"Operation Start Time","description":"The time the request has been processed.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD","minLength":1,"maxLength":64},"operationEndTime":{"type":"string","title":"Operation End Time","description":"The time the operation has been completed.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD\nnote: This is an optional field and might not be returned for synchronous operations.","minLength":1,"maxLength":64},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"sdkType":{"type":"string","description":"The type of SDK which is used","enum":["APP","WEB","NONE"]},"digitalCardId":{"type":"string","description":"Unique identifier of the digital card.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"walletApplicationId":{"type":"string","description":"Unique Indentifier of wallet application","maxLength":100},"eligibilityInformation":{"type":"object","description":"Provides details about the eligibility check operation","properties":{"cardBIN":{"type":"string","minLength":6,"maxLength":6},"eligible":{"type":"boolean"},"cardProduct":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":256}}}},"required":["cardBIN","eligible"]},"digitizationInformation":{"type":"object","description":"Provides details about the tokenization (digitization) operation whatever the result is (that is, successful, pending or cancelled)","title":"digitizationInformation","required":["digitizationChecks","digitizationResult"],"properties":{"digitizationChecks":{"type":"object","required":["issuerVerifications","decisionEngineVerifications","digitalCardRequestorAssessment"],"properties":{"issuerVerifications":{"$ref":"#/components/schemas/issuerVerifications"},"decisionEngineVerifications":{"$ref":"#/components/schemas/decisionEngineVerifications-2"},"digitalCardRequestorAssessment":{"$ref":"#/components/schemas/digitalCardRequestorAssessment-2"},"verificationCodes":{"type":"array","maxItems":100,"description":"D1 Verification codes generated by the decision engine during rule evaluation. Following values are possible:\n\t \n|value |description| \n|-----------|----------------------------------| \n|ADDRESS-MATCH|Full billing address match (Street Line 1 and ZIP Code and Country code)|\n|ADDRESS-NO_MATCH|Full billing address mismatch (Street Line 1 and ZIP Code and Country code)|\n|ADDRESS-PARTIAL_MATCH|Partial billing address mismatch (Street Line 1 or ZIP Code or Country code)|\n|ADDRESS_COUNTRYCODE-NO_MATCH|Country codes are available but do not match the comparison|\n|ADDRESS_LINE1-NO_MATCH|Address Street Line 1 information are available but do not match the comparison|\n|ADDRESS_LINE2-NO_MATCH|Address Street Line 2 information are available but do not match the comparison|\n|ADDRESS_ZIPCODE-NO_MATCH|ZIP codes are available but do not match the comparison|\n|ISS_LANGUAGE-INVALID|Cardholder device language provided by the issuer is not encoded as a valid language|\n|ISS_LANGUAGE-UNAVAILABLE|Cardholder device language not provided by the issuer|\n|ISS_LOCALIZATION-INVALID|Cardholder country code provided by the issuer is not encoded as a valid language|\n|ISS_LOCALIZATION-UNAVAILABLE|Cardholder country code not provided by the issuer|\n|ISS_PHONE_NUMBER-INVALID|Cardholder phone number provided by the issuer is not recognized as a valid number|\n|ISS_PHONE_NUMBER-UNAVAILABLE|Cardholder phone number not provided by the issuer|\n|ISS_ADDRESS-INVALID|Billing address provided by the Issuer is not valid and/or inaccurate|\n|ISS_ADDRESS-UNAVAILABLE|Billing address not provided by the issuer in GetConsumerInfo API response|\n|LANGUAGE-MATCH|Cardholder device language matches|\n|LANGUAGE-NO_MATCH|Cardholder device language does not match|\n|LOCALIZATION-MATCH|Cardholder localization obtained by resolving data provided in the tokenization request (device coordinates and/or IP Address) matches with customer residency address country code|\n|LOCALIZATION-NO_MATCH|Cardholder localization obtained by resolving data provided in the tokenization request (device coordinates and/or IP Address) do not match with customer residency address country code|\n|LOCALIZATION-PARTIAL_MATCH|One of the country codes obtained by resolving IP address & device location coordinates do not match with customer residency address country code|\n|NAME-MATCH|Cardholder name matches|\n|NAME-NO_MATCH|Cardholder name does not match|\n|NAME-PARTIAL_MATCH|Cardholder name only partially matches|\n|PHONE_NUMBER-MATCH|Cardholder phone number matches|\n|PHONE_NUMBER-NO_MATCH|Cardholder phone number does not match|\n|PHONE_NUMBER-PARTIAL_MATCH|Cardholder phone number suffix matches|\n|TR_ACCOUNT_SCORE-UNAVAILABLE|Account scoring not provided in tokenization request|\n|TR_ADDRESS-INVALID|Billing address provided by the token requester is not valid and/or inaccurate|\n|TR_ADDRESS-UNAVAILABLE|Billing address not provided by the token requester in the tokenization request or one of those fields is missing: Street Line 1 or ZIP Code or Country code|\n|TR_DEVICE_SCORE-UNAVAILABLE|Device scoring not provided in tokenization request|\n|TR_IPADDRESS-UNAVAILABLE|Cardholder device IP Address not provided in the tokenization request|\n|TR_IPADDRESS-INVALID|Cardholder device IP Address provided in the tokenization request cannot be correctly resolved into a country code\n|TR_LANGUAGE-UNAVAILABLE|Cardholder device language not provided in the tokenization request|\n|TR_LANGUAGE-INVALID|Cardholder device language provided in the tokenization request is not encoded as a valid language|\n|TR_LOCALIZATION-UNAVAILABLE|Cardholder device location coordinates not provided in the tokenization request|\n|TR_LOCALIZATION-INVALID|Cardholder device location coordinates provided in the tokenization request cannot be correctly resolved into a valid country|\n|TR_NAME-UNAVAILABLE|Cardholder name not provided in tokenization request|\n|TR_PHONE_NUMBER-UNAVAILABLE|Cardholder phone number not provided in the tokenization request|\n|TR_PHONE_NUMBER-INVALID|Cardholder phone number provided in the tokenization request is not recognized as a valid number|\n|TR_RECOMMENDATION-UNAVAILABLE|Wallet recommendation not provided in tokenization request|","items":{"type":"string"}},"matchedRule":{"type":"object","description":"Decision Engine rule triggerig the final decision.\r\n\r\nApplicable only to Decision Engine Version V2","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of the matching rule."},"name":{"type":"string","description":"Name of the matching rule."},"scenario":{"type":"object","description":"The actual matching scenario ","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of the matched scenario."},"name":{"type":"string","description":"Name of the matched scenario."}}}}}}},"digitizationResult":{"type":"object","required":["flow"],"properties":{"flow":{"type":"string","description":"Tokenization Decision Engine assessment result.\nFollowing values are possible:\n- RED (DECLINE)\n- GREEN (APPROVE)\n- YELLOW (STEP-UP)","minLength":1,"maxLength":64,"enum":["RED","YELLOW","GREEN"]},"score":{"type":"string","minLength":1,"maxLength":1,"pattern":"[1-5]{1,1}$","description":"This is the final score the decision engine has computed considering all the verifications and the scoring from the requestor and/or TSP.\nScore goes from 1 (low trust) to 5 (high trust)."},"idAndVMethods":{"$ref":"#/components/schemas/idAndVMethods"},"digitizationDecisionTimestamp":{"type":"string","minLength":1,"maxLength":64,"description":"The time when the digitization decision has been sent to the TSP.\nThis parameter can be used by the Issuer to manage the notifications to cardholder in case of PENDING status of digitize operation.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD\n"}}}}},"issuerVerifications":{"title":"issuerVerifications","type":"object","properties":{"cardIsExpired":{"$ref":"#/components/schemas/result"},"cardIsLostOrStolen":{"$ref":"#/components/schemas/result"},"wrongCVV":{"$ref":"#/components/schemas/result"},"fraudSuspect":{"$ref":"#/components/schemas/result"},"cardIsInvalid":{"$ref":"#/components/schemas/result"}},"required":["cardIsExpired","cardIsLostOrStolen","wrongCVV","fraudSuspect","cardIsInvalid"]},"result":{"title":"result","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}}},"decisionEngineVerifications-2":{"title":"decisionEngineVerifications","type":"object","properties":{"tooManyDigitizationRequests":{"$ref":"#/components/schemas/result"},"tooManyCVVVerificationFailed":{"$ref":"#/components/schemas/result"},"walletPhoneNumberNotMatchingConsumerPhoneNumber":{"$ref":"#/components/schemas/result"},"digitizationCountExceededOnSameFPAN":{"$ref":"#/components/schemas/result"},"digitizationCountExceededOnSameDevice":{"$ref":"#/components/schemas/result"},"cardIsExpired":{"$ref":"#/components/schemas/result"},"cardIsInvalid":{"$ref":"#/components/schemas/result"},"wrongCVV":{"$ref":"#/components/schemas/result"},"CVVNotProvided":{"$ref":"#/components/schemas/CVVNotProvided-2"}},"required":["tooManyDigitizationRequests","tooManyCVVVerificationFailed","walletPhoneNumberNotMatchingConsumerPhoneNumber","digitizationCountExceededOnSameFPAN","digitizationCountExceededOnSameDevice","cardIsExpired","cardIsInvalid","wrongCVV","CVVNotProvided"]},"CVVNotProvided-2":{"title":"CVVNotProvided","type":"object","description":"If CVV has not been provided by the digital card requestor, then D1 verifies if this is incompatible with either the card capture method used or the digital card type requested.","properties":{"incompatibleWithCaptureMethod":{"$ref":"#/components/schemas/captureMethodIncompatible-2"},"incompatibleWithDigitalCardType":{"$ref":"#/components/schemas/digitalCardTypeIncompatible"}},"required":["incompatibleWithCaptureMethod","incompatibleWithDigitalCardType"]},"captureMethodIncompatible-2":{"title":"captureMethodIncompatible","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}}},"digitalCardTypeIncompatible":{"title":"digitalCardTypeIncompatible","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}},"description":"If the digital card type required is NOT one of the following:\n- COF (card on file)\n- ECOM (e-Commerce)\n\nthen the absence of CVV is unexpected, the result will be YES"},"digitalCardRequestorAssessment-2":{"title":"digitalCardRequestorAssessment","type":"object","required":["averageScore","deviceScore","recommendation"],"properties":{"averageScore":{"type":"string","description":"Average scoring from the digital card requestor. Following values are possible:\n\nNOT_APPLICABLE (score is based on data from digital card requestor. If the data is not available, average can't be computed).\n1\n2\n3\n4\n5"},"deviceScore":{"type":"string","description":"Following values are possible:\n\nNOT_APPLICABLE (score is based on data from digital card requestor. If the data is not available, score can't be provided).\n1\n2\n3\n4\n5"},"recommendation":{"$ref":"#/components/schemas/walletRecommendation"},"reasonCodesRecommendation":{"type":"string","description":"Reason codes, if any, from digital card requestor.\n\nOtherwise NOT_APPLICABLE","maxLength":64,"deprecated":true},"reasonCodesRecommendationDescription":{"type":"array","description":" This field shall allow to map the Wallet Reason Code Recommendation with a more user friendly description in line with the mapping table defined below:\n\t \n|reasonCode |In case of Yellow flow description| \n|-----------|----------------------------------| \n|01 |User Wallet Account ID too new relative to launch| \n|02 |User Wallet Account ID too new relative to provisioning request| \n|03 |User Wallet Account ID/Card Pair is newer than date threshold| \n|04 |Changes made to account data within date threshold| \n|05 |Suspicious transactions linked to this account.| \n|06 |The Account has not had activity in the last year.| \n|07 |Suspended cards in the secure element|\n|08 |The device was put in lost mode in the last 7 days for longer than the duration threshold| \n|09 |The number of provisioning attempts on this device in 72 hours exceeds the threshold| \n|0A |There have been more than the threshold number of different cards attempted at provisioning to this phone in 24 hours.| \n|0B |The card provisioning request contains a distinct name in excess of the permitted threshold| \n|0C |Device Score is less than 3| \n|0D |Account Score is less than 4| \n|0E |Device provisioning location outside of OEM marketplace store home country| \n|0F |Model rules not available at this time (in cases where back end systems time out).| \n|0G |Orange path flag: Device is considered at high risk for card provisioning | \n|0H |Phone Number Score is less than 3|\n|V1 |Cardholder name does not match the name registered in the wallet|\n|V2 |Wallet account device binding age is below threshold.This threshold is defined by the wallet. Please check with the wallet provider.|\n|VA |A recent account activity was detected. This threshold is defined by the wallet. Please check with the wallet provider.|\n|VC |Number of transactions in the last 12 months below a certain threshold: in the last 12 months a limited number of transactions have been performed. This threshold is defined by the wallet. Please check with the wallet provider. |","uniqueItems":true,"items":{"type":"object"}}}},"walletRecommendation":{"type":"string","description":"Wallet/Digital Card Requestor colour recommended during the card tokenization request\n\nPlease note that in certain situations a recommendation might be not provided by the wallet.","enum":["NOT_APPLICABLE","GREEN","YELLOW","ORANGE","RED"]},"idAndVMethods":{"type":"object","properties":{"supported":{"type":"array","description":"Any value described in the \"**selected**\" field","items":{"type":"string"}},"selected":{"type":"string","minLength":1,"maxLength":64,"description":"The following values are possible:\n- OTP_BY_SMS\n- OTP_BY_EMAIL\n- BANK_APP\n- CUSTOMER_SERVICE\n- 3DS"}}},"pullType":{"type":"string","description":"The type of operation performed to update card order","enum":["ACCELERATE","ACCELERATE_AND_REDIRECT","CANCEL","REDIRECT"]},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"newErrorGeneric":{"type":"object","description":"Error object with errorCode & error message.","properties":{"errorCode":{"type":"string","description":"The type of the error"},"error":{"type":"string","description":"Provide more error details if possible.<br/>For example name of the field with invalid format.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}}},"responses":{"BadRequest":{"description":"Bad Request, Invalid request URI or header, or unsupported non-standard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"Unauthorized":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"InternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}}},"parameters":{"offset-query-no-max":{"name":"offset","in":"query","schema":{"type":"integer","minimum":0},"description":"Index from which the query starts returning operations – Offset 0 (the default) corresponds to the most recent operation."},"limit-query":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":10},"description":"Number of operations to be returned"}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations":{"get":{"summary":"Get all operations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"operations":{"type":"array","items":{"$ref":"#/components/schemas/operationAllCard"}},"remainingOperations":{"type":"integer"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Ressource not found, Unknown issuerId or consumerId or card id'. The below table defines the possible error:\n| errorCode      | error       | Retryable | Comments                             |\n| -------------- | ------------| ----------| -----------------------------------|\n| -              | -           | no | No error details available         |\n| UNKNOWN_CARD   | -           | no | Unknown cardId |\n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/newErrorGeneric"}}}},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Operations"],"operationId":"get-all-card-operations-by-cardId","parameters":[{"$ref":"#/components/parameters/offset-query-no-max"},{"$ref":"#/components/parameters/limit-query"}],"description":"This request is used by the issuer backend to  retrieve all operations related to a card. The API specifies the starting point (offset) and the number of operations (limit) to be retrieved. Offset 0 (the default) corresponds to the most recent operation. For example a limit of 5 and an offset of 2 would return the five most recent operations before the most recent two”.\n\nIf no operations are available for the given cardId, an empty list is returned.\n\nOperations that are older than 3 months are removed."}}}}
````

## Get operation

> This request is used by the issuer backend to retrieve the information related to an operation on a card.\
> \
> Operations older than 3 months are removed.

````json
{"openapi":"3.0.0","info":{"title":"Inbound Card API","version":"1.0"},"tags":[{"name":"Operations","description":"Different operations that can be done on a card."}],"servers":[{"url":"https://api.d1.thalescloud.io/banking/v1","description":"Production server"},{"url":"https://api.d1-stg.thalescloud.io/banking/v1","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"description":"A JWT generated by the [Get Authorization Token API](oauth2-api).<br/>The server checks the validity of the provided token to control access to this protected resource. Please refer to [Get OAuth 2.0 access token](../../../integrate-the-d1-api/get-oauth-2.0-access-token) for more details on the flow and on how to get this JWT.","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"operationCard":{"title":"operationCard","type":"object","description":"Operation details related to a specific operationId in GetCardOperation API","required":["operationId","operation","status","startTime","requestorType","requestorId"],"properties":{"operationId":{"$ref":"#/components/schemas/operationId"},"operation":{"type":"string","description":"The operation type.","enum":["ACTIVATE","D1_PAY_ENROLMENT","CLICK_TO_PAY_ENROLMENT","CLICK_TO_PAY_UPDATE","CLICK_TO_PAY_OPTOUT","DELETE","DIGITIZE","DISPLAY","PIN_CHANGE","PIN_DISPLAY","PRODUCE","PUSH","REGISTER","RENEW","REPLACE","RESUME","SUSPEND","UPDATE_ORDER","VERIFY","CARDHOLDER_VERIFICATION"]},"status":{"type":"string","enum":["SUCCESSFUL","PENDING","FAILED"],"description":"Status of the operation"},"startTime":{"$ref":"#/components/schemas/operationStartTime"},"endTime":{"$ref":"#/components/schemas/operationEndTime"},"requestorType":{"type":"string","enum":["ISSUER","USER","TSP","CCI","D1"]},"requestorId":{"type":"string","description":"Identifier of the principal who initiates the operation\n  - consumerId if requestorType is USER\n  - issuerId if requestorType is ISSUER\n  - cci user id if requestorType is CCI\n  - D1 if it's an operation automatically triggered by D1 (can be card suspended due to several authorisation with invalid cvv)"},"reason":{"$ref":"#/components/schemas/reason"},"reasonCode":{"type":"string","enum":["USER_DECISION","ISSUER_DECISION","DEVICE_LOST","DEVICE_STOLEN","CARD_LOST","CARD_STOLEN","CARD_BROKEN","DEVICE_FOUND","CARD_FOUND","CARD_EXPIRED","CARD_NOT_RECEIVED","FRAUD","CLOSED_CARD","CLOSED_ACCOUNT"]},"details":{"oneOf":[{"title":"ACTIVATE operation","description":"Container to hold detailed information of ACTIVATE operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"D1_PAY_ENROLMENT operation","description":"Container to hole details information of D1 Pay enrolment operation","properties":{"digitalCardId":{"$ref":"#/components/schemas/digitalCardId"},"walletApplicationId":{"$ref":"#/components/schemas/walletApplicationId"}}},{"title":"DIGITIZE operation","description":"Container to hold detailed information regarding the executed operation (DIGITIZE)","properties":{"eligibilityInformation":{"$ref":"#/components/schemas/eligibilityInformation"},"digitizationInformation":{"$ref":"#/components/schemas/digitizationInformation"},"digitalCardId":{"$ref":"#/components/schemas/digitalCardId"},"digitalCardInformation":{"$ref":"#/components/schemas/digitalCardInformation"}}},{"title":"DISPLAY operation","description":"Container to hold detailed information of DISPLAY operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"PIN_CHANGE operation","description":"Container to hold detailed information of PIN_CHANGE operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"},"pinType":{"type":"string","enum":["ISO0","3DES_SECCOS"],"description":"The type of PIN which is used for the card."}}},{"title":"PIN_DISPLAY operation","description":"Container to hold detailed information of PIN_DISPLAY operation","properties":{"sdkType":{"$ref":"#/components/schemas/sdkType"}}},{"title":"PRODUCE operation","description":"Container to hold detailed information of PRODUCE operation","properties":{"issuerRequestId":{"$ref":"#/components/schemas/operationId"},"dueDate":{"type":"string","format":"date","description":"The estimated card production date. It uses the format ```YYYY-MM-DD```."}}},{"title":"PUSH operations","description":"Container to hold detailed information of PUSH operations","properties":{"digitalCardRequestorId":{"type":"string","description":"Id of the token requestor to which we will push the card. Also known as TRID on scheme side.","minLength":11,"maxLength":11,"pattern":"[0-9]{11}"},"digitalCardRequestorName":{"type":"string","description":"Name of the token requestor to which we will push the card.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9 _-]{1,64}"},"program":{"type":"string","description":"Protocol or API that was involded in the PUSH operation.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9 _-]{1,64}"}}},{"title":"REGISTER, SUSPEND, RESUME, DELETE operations","description":"Container to hold any detailed information regarding the executed operation (REGISTER, SUSPEND, RESUME, RENEW, DELETE)","properties":{"oldState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED","SUSPENDED"],"description":"Old state of the card"},"newState":{"type":"string","enum":["ACTIVE","INACTIVE","DELETED","SUSPENDED"],"description":"New state of the card"},"consumerState":{"type":"string","deprecated":true,"enum":["ACTIVE","INACTIVE","DELETED"],"description":"The state of the end user (consumer).<br/>**Note**: Consumer state is deprecated, this optional parameter will soon be removed from the response."}}},{"title":"RENEW operation","description":"Container to hold detailed information of RENEW operation","properties":{"oldCardId":{"type":"string","description":"Old id of the card","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"newCardId":{"type":"string","description":"New id of the card","minLength":1,"maxLength":48,"pattern":"[A-Za-z0-9_-]{1,48}"},"oldState":{"type":"string","enum":["ACTIVE","INACTIVE","SUSPENDED"],"description":"Old state of the card"},"newState":{"type":"string","enum":["ACTIVE","INACTIVE","SUSPENDED"],"description":"New state of the card"},"consumerState":{"type":"string","deprecated":true,"enum":["ACTIVE","INACTIVE","DELETED"],"description":"The state of the end user (consumer).<br/>**Note**: Consumer state is deprecated, this optional parameter will soon be removed from the response."}}},{"title":"UPDATE_ORDER operation","description":"Container to hold detailed information of UPDATE_ORDER operation","properties":{"pullType":{"$ref":"#/components/schemas/pullType"}}}],"type":"object"},"errorCode":{"type":"string","description":"External error code"},"error":{"type":"string","description":"Human readable string representing the error, only present in case of operation failure","maxLength":256,"minLength":0}}},"operationId":{"type":"string","description":"Unique identifier of the operation","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"operationStartTime":{"type":"string","title":"Operation Start Time","description":"The time the request has been processed.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD","minLength":1,"maxLength":64},"operationEndTime":{"type":"string","title":"Operation End Time","description":"The time the operation has been completed.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD\nnote: This is an optional field and might not be returned for synchronous operations.","minLength":1,"maxLength":64},"reason":{"type":"string","title":"reason","pattern":"^[a-zA-Z0-9 ]{1,64}$","description":"The reason why the action is performed.\n\nThis a free text field in case the Issuer wants to send details, that will be returned in the operations list."},"sdkType":{"type":"string","description":"The type of SDK which is used","enum":["APP","WEB","NONE"]},"digitalCardId":{"type":"string","description":"Unique identifier of the digital card.","minLength":1,"maxLength":64,"pattern":"[A-Za-z0-9_-]{1,64}"},"walletApplicationId":{"type":"string","description":"Unique Indentifier of wallet application","maxLength":100},"eligibilityInformation":{"type":"object","description":"Provides details about the eligibility check operation","properties":{"cardBIN":{"type":"string","minLength":6,"maxLength":6},"eligible":{"type":"boolean"},"cardProduct":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"name":{"type":"string","minLength":1,"maxLength":256}}}},"required":["cardBIN","eligible"]},"digitizationInformation":{"type":"object","description":"Provides details about the tokenization (digitization) operation whatever the result is (that is, successful, pending or cancelled)","title":"digitizationInformation","required":["digitizationChecks","digitizationResult"],"properties":{"digitizationChecks":{"type":"object","required":["issuerVerifications","decisionEngineVerifications","digitalCardRequestorAssessment"],"properties":{"issuerVerifications":{"$ref":"#/components/schemas/issuerVerifications"},"decisionEngineVerifications":{"$ref":"#/components/schemas/decisionEngineVerifications-2"},"digitalCardRequestorAssessment":{"$ref":"#/components/schemas/digitalCardRequestorAssessment-2"},"verificationCodes":{"type":"array","maxItems":100,"description":"D1 Verification codes generated by the decision engine during rule evaluation. Following values are possible:\n\t \n|value |description| \n|-----------|----------------------------------| \n|ADDRESS-MATCH|Full billing address match (Street Line 1 and ZIP Code and Country code)|\n|ADDRESS-NO_MATCH|Full billing address mismatch (Street Line 1 and ZIP Code and Country code)|\n|ADDRESS-PARTIAL_MATCH|Partial billing address mismatch (Street Line 1 or ZIP Code or Country code)|\n|ADDRESS_COUNTRYCODE-NO_MATCH|Country codes are available but do not match the comparison|\n|ADDRESS_LINE1-NO_MATCH|Address Street Line 1 information are available but do not match the comparison|\n|ADDRESS_LINE2-NO_MATCH|Address Street Line 2 information are available but do not match the comparison|\n|ADDRESS_ZIPCODE-NO_MATCH|ZIP codes are available but do not match the comparison|\n|ISS_LANGUAGE-INVALID|Cardholder device language provided by the issuer is not encoded as a valid language|\n|ISS_LANGUAGE-UNAVAILABLE|Cardholder device language not provided by the issuer|\n|ISS_LOCALIZATION-INVALID|Cardholder country code provided by the issuer is not encoded as a valid language|\n|ISS_LOCALIZATION-UNAVAILABLE|Cardholder country code not provided by the issuer|\n|ISS_PHONE_NUMBER-INVALID|Cardholder phone number provided by the issuer is not recognized as a valid number|\n|ISS_PHONE_NUMBER-UNAVAILABLE|Cardholder phone number not provided by the issuer|\n|ISS_ADDRESS-INVALID|Billing address provided by the Issuer is not valid and/or inaccurate|\n|ISS_ADDRESS-UNAVAILABLE|Billing address not provided by the issuer in GetConsumerInfo API response|\n|LANGUAGE-MATCH|Cardholder device language matches|\n|LANGUAGE-NO_MATCH|Cardholder device language does not match|\n|LOCALIZATION-MATCH|Cardholder localization obtained by resolving data provided in the tokenization request (device coordinates and/or IP Address) matches with customer residency address country code|\n|LOCALIZATION-NO_MATCH|Cardholder localization obtained by resolving data provided in the tokenization request (device coordinates and/or IP Address) do not match with customer residency address country code|\n|LOCALIZATION-PARTIAL_MATCH|One of the country codes obtained by resolving IP address & device location coordinates do not match with customer residency address country code|\n|NAME-MATCH|Cardholder name matches|\n|NAME-NO_MATCH|Cardholder name does not match|\n|NAME-PARTIAL_MATCH|Cardholder name only partially matches|\n|PHONE_NUMBER-MATCH|Cardholder phone number matches|\n|PHONE_NUMBER-NO_MATCH|Cardholder phone number does not match|\n|PHONE_NUMBER-PARTIAL_MATCH|Cardholder phone number suffix matches|\n|TR_ACCOUNT_SCORE-UNAVAILABLE|Account scoring not provided in tokenization request|\n|TR_ADDRESS-INVALID|Billing address provided by the token requester is not valid and/or inaccurate|\n|TR_ADDRESS-UNAVAILABLE|Billing address not provided by the token requester in the tokenization request or one of those fields is missing: Street Line 1 or ZIP Code or Country code|\n|TR_DEVICE_SCORE-UNAVAILABLE|Device scoring not provided in tokenization request|\n|TR_IPADDRESS-UNAVAILABLE|Cardholder device IP Address not provided in the tokenization request|\n|TR_IPADDRESS-INVALID|Cardholder device IP Address provided in the tokenization request cannot be correctly resolved into a country code\n|TR_LANGUAGE-UNAVAILABLE|Cardholder device language not provided in the tokenization request|\n|TR_LANGUAGE-INVALID|Cardholder device language provided in the tokenization request is not encoded as a valid language|\n|TR_LOCALIZATION-UNAVAILABLE|Cardholder device location coordinates not provided in the tokenization request|\n|TR_LOCALIZATION-INVALID|Cardholder device location coordinates provided in the tokenization request cannot be correctly resolved into a valid country|\n|TR_NAME-UNAVAILABLE|Cardholder name not provided in tokenization request|\n|TR_PHONE_NUMBER-UNAVAILABLE|Cardholder phone number not provided in the tokenization request|\n|TR_PHONE_NUMBER-INVALID|Cardholder phone number provided in the tokenization request is not recognized as a valid number|\n|TR_RECOMMENDATION-UNAVAILABLE|Wallet recommendation not provided in tokenization request|","items":{"type":"string"}},"matchedRule":{"type":"object","description":"Decision Engine rule triggerig the final decision.\r\n\r\nApplicable only to Decision Engine Version V2","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of the matching rule."},"name":{"type":"string","description":"Name of the matching rule."},"scenario":{"type":"object","description":"The actual matching scenario ","required":["id"],"properties":{"id":{"type":"string","description":"Unique identifier of the matched scenario."},"name":{"type":"string","description":"Name of the matched scenario."}}}}}}},"digitizationResult":{"type":"object","required":["flow"],"properties":{"flow":{"type":"string","description":"Tokenization Decision Engine assessment result.\nFollowing values are possible:\n- RED (DECLINE)\n- GREEN (APPROVE)\n- YELLOW (STEP-UP)","minLength":1,"maxLength":64,"enum":["RED","YELLOW","GREEN"]},"score":{"type":"string","minLength":1,"maxLength":1,"pattern":"[1-5]{1,1}$","description":"This is the final score the decision engine has computed considering all the verifications and the scoring from the requestor and/or TSP.\nScore goes from 1 (low trust) to 5 (high trust)."},"idAndVMethods":{"$ref":"#/components/schemas/idAndVMethods"},"digitizationDecisionTimestamp":{"type":"string","minLength":1,"maxLength":64,"description":"The time when the digitization decision has been sent to the TSP.\nThis parameter can be used by the Issuer to manage the notifications to cardholder in case of PENDING status of digitize operation.\nFormat ISO 8601 YYYY-MM-DDThh:mm:ssTZD\n"}}}}},"issuerVerifications":{"title":"issuerVerifications","type":"object","properties":{"cardIsExpired":{"$ref":"#/components/schemas/result"},"cardIsLostOrStolen":{"$ref":"#/components/schemas/result"},"wrongCVV":{"$ref":"#/components/schemas/result"},"fraudSuspect":{"$ref":"#/components/schemas/result"},"cardIsInvalid":{"$ref":"#/components/schemas/result"}},"required":["cardIsExpired","cardIsLostOrStolen","wrongCVV","fraudSuspect","cardIsInvalid"]},"result":{"title":"result","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}}},"decisionEngineVerifications-2":{"title":"decisionEngineVerifications","type":"object","properties":{"tooManyDigitizationRequests":{"$ref":"#/components/schemas/result"},"tooManyCVVVerificationFailed":{"$ref":"#/components/schemas/result"},"walletPhoneNumberNotMatchingConsumerPhoneNumber":{"$ref":"#/components/schemas/result"},"digitizationCountExceededOnSameFPAN":{"$ref":"#/components/schemas/result"},"digitizationCountExceededOnSameDevice":{"$ref":"#/components/schemas/result"},"cardIsExpired":{"$ref":"#/components/schemas/result"},"cardIsInvalid":{"$ref":"#/components/schemas/result"},"wrongCVV":{"$ref":"#/components/schemas/result"},"CVVNotProvided":{"$ref":"#/components/schemas/CVVNotProvided-2"}},"required":["tooManyDigitizationRequests","tooManyCVVVerificationFailed","walletPhoneNumberNotMatchingConsumerPhoneNumber","digitizationCountExceededOnSameFPAN","digitizationCountExceededOnSameDevice","cardIsExpired","cardIsInvalid","wrongCVV","CVVNotProvided"]},"CVVNotProvided-2":{"title":"CVVNotProvided","type":"object","description":"If CVV has not been provided by the digital card requestor, then D1 verifies if this is incompatible with either the card capture method used or the digital card type requested.","properties":{"incompatibleWithCaptureMethod":{"$ref":"#/components/schemas/captureMethodIncompatible-2"},"incompatibleWithDigitalCardType":{"$ref":"#/components/schemas/digitalCardTypeIncompatible"}},"required":["incompatibleWithCaptureMethod","incompatibleWithDigitalCardType"]},"captureMethodIncompatible-2":{"title":"captureMethodIncompatible","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}}},"digitalCardTypeIncompatible":{"title":"digitalCardTypeIncompatible","type":"object","properties":{"result":{"type":"string","enum":["YES","NO","NOT_APPLICABLE"]}},"description":"If the digital card type required is NOT one of the following:\n- COF (card on file)\n- ECOM (e-Commerce)\n\nthen the absence of CVV is unexpected, the result will be YES"},"digitalCardRequestorAssessment-2":{"title":"digitalCardRequestorAssessment","type":"object","required":["averageScore","deviceScore","recommendation"],"properties":{"averageScore":{"type":"string","description":"Average scoring from the digital card requestor. Following values are possible:\n\nNOT_APPLICABLE (score is based on data from digital card requestor. If the data is not available, average can't be computed).\n1\n2\n3\n4\n5"},"deviceScore":{"type":"string","description":"Following values are possible:\n\nNOT_APPLICABLE (score is based on data from digital card requestor. If the data is not available, score can't be provided).\n1\n2\n3\n4\n5"},"recommendation":{"$ref":"#/components/schemas/walletRecommendation"},"reasonCodesRecommendation":{"type":"string","description":"Reason codes, if any, from digital card requestor.\n\nOtherwise NOT_APPLICABLE","maxLength":64,"deprecated":true},"reasonCodesRecommendationDescription":{"type":"array","description":" This field shall allow to map the Wallet Reason Code Recommendation with a more user friendly description in line with the mapping table defined below:\n\t \n|reasonCode |In case of Yellow flow description| \n|-----------|----------------------------------| \n|01 |User Wallet Account ID too new relative to launch| \n|02 |User Wallet Account ID too new relative to provisioning request| \n|03 |User Wallet Account ID/Card Pair is newer than date threshold| \n|04 |Changes made to account data within date threshold| \n|05 |Suspicious transactions linked to this account.| \n|06 |The Account has not had activity in the last year.| \n|07 |Suspended cards in the secure element|\n|08 |The device was put in lost mode in the last 7 days for longer than the duration threshold| \n|09 |The number of provisioning attempts on this device in 72 hours exceeds the threshold| \n|0A |There have been more than the threshold number of different cards attempted at provisioning to this phone in 24 hours.| \n|0B |The card provisioning request contains a distinct name in excess of the permitted threshold| \n|0C |Device Score is less than 3| \n|0D |Account Score is less than 4| \n|0E |Device provisioning location outside of OEM marketplace store home country| \n|0F |Model rules not available at this time (in cases where back end systems time out).| \n|0G |Orange path flag: Device is considered at high risk for card provisioning | \n|0H |Phone Number Score is less than 3|\n|V1 |Cardholder name does not match the name registered in the wallet|\n|V2 |Wallet account device binding age is below threshold.This threshold is defined by the wallet. Please check with the wallet provider.|\n|VA |A recent account activity was detected. This threshold is defined by the wallet. Please check with the wallet provider.|\n|VC |Number of transactions in the last 12 months below a certain threshold: in the last 12 months a limited number of transactions have been performed. This threshold is defined by the wallet. Please check with the wallet provider. |","uniqueItems":true,"items":{"type":"object"}}}},"walletRecommendation":{"type":"string","description":"Wallet/Digital Card Requestor colour recommended during the card tokenization request\n\nPlease note that in certain situations a recommendation might be not provided by the wallet.","enum":["NOT_APPLICABLE","GREEN","YELLOW","ORANGE","RED"]},"idAndVMethods":{"type":"object","properties":{"supported":{"type":"array","description":"Any value described in the \"**selected**\" field","items":{"type":"string"}},"selected":{"type":"string","minLength":1,"maxLength":64,"description":"The following values are possible:\n- OTP_BY_SMS\n- OTP_BY_EMAIL\n- BANK_APP\n- CUSTOMER_SERVICE\n- 3DS"}}},"digitalCardInformation":{"title":"digitalCardInformation","type":"object","description":"Provides details about the digital card. Only available when digitalCardInfo = true","required":["digitalCardRequestorInformation","digitalCardsDetails"],"properties":{"deviceInformation":{"$ref":"#/components/schemas/deviceInformation"},"digitalCardRequestorInformation":{"title":"digitalCardRequestorInformation","type":"object","description":"Provides details about the digital card requestor.","properties":{"id":{"type":"string","description":"Digital Card requestor identifier. This is provided by the TSP itself.","minLength":11,"maxLength":11},"name":{"type":"string","maxLength":256,"description":"Wallet or Merchant human readable name"},"walletAccountId":{"type":"object","description":"Unique identifier of a wallet user account","additionalProperties":{}},"captureMethod":{"$ref":"#/components/schemas/captureMethod"}}},"digitalCardsDetails":{"type":"array","minItems":1,"maxItems":2,"description":null,"items":{"type":"object","required":["digitalCardId","state"],"properties":{"digitalCardId":{"type":"string","minLength":1,"maxLength":64,"description":"Unique identifier of the token specified by the TSP"},"panSuffix":{"type":"string","minLength":4,"maxLength":4,"description":"Last four digits of the token"},"state":{"$ref":"#/components/schemas/digitalCardState"},"type":{"$ref":"#/components/schemas/tokenType"},"provisioningTime":{"type":"string","maxLength":32,"description":"The provisioning time of the token. Format ISO 8601 YYYY-MM-DDThh:mm:ssTZD"},"isPrimary":{"type":"boolean","description":"Boolean Flag indicating whether the token is primary or auxiliary."},"credentials":{"type":"string","description":"The field is the json (cf http://www.json.org/ ) representation of the DIGITAL card.\nJWE encryption is used to secure the field (please refer to the [Encrypt sensitive data](../../../integrate-the-d1-api/encrypt-sensitive-data) for more details)\nDetails:\n\n{\n\n\"pan\":\"...\",\n\n\"exp\":\"...\"\n\n}\n\n\nThe PAN is Mandatory,  up to 19 digits.\n\nThe expiry date in the format MMYY. It is not provided for UPI scheme.","minLength":1,"maxLength":8196}}}}}},"deviceInformation":{"title":"deviceInformation","type":"object","description":"Provides details about the device that has been used for the card tokenization.\nNote that this data is available only if the check eligbility has passed with success.\nData availability dependes on the requestor.","properties":{"deviceId":{"type":"string","minLength":1,"maxLength":128,"description":"Identifier of the token storage."},"digitalCardStorageType":{"type":"string","maxLength":32,"description":"Type of the token storage location. Following values are possible:\n- HCE\n- SPAY_PHONE\n- SPAY_TABLET\n- SPAY_WATCH\n- SPAY_TV\n- IPHONE\n- IWATCH\n- IPAD\n- MAC_BOOK\n- ANDROID_PHONE\n- ANDROID_TABLET\n- ANDROID_WATCH\n- MOBILE_PHONE\n- TABLET\n- WATCH\n- MOBILE_PHONE_OR_TABLET\n- BRACELET\n- PC\n- HOUSEHOLD\n- WEARABLE\n- AUTOMOBILE\n- UNKNOWN"},"manufacturer":{"type":"string","minLength":1,"maxLength":32,"description":"Device manufacturer name"},"brand":{"type":"string","minLength":1,"maxLength":32,"description":"Device brand"},"model":{"type":"string","minLength":1,"maxLength":32,"description":"Device model"},"osVersion":{"type":"string","minLength":1,"maxLength":16,"description":"Device OS version"},"firmwareVersion":{"type":"string","description":"Device firmware version","minLength":1,"maxLength":32},"phoneNumber":{"type":"string","description":"Device phone number","minLength":1,"maxLength":20},"fourLastDigitPhoneNumber":{"type":"string","minLength":1,"maxLength":4},"deviceName":{"type":"string","maxLength":128,"description":"Device name set by the end user"},"deviceParentId":{"type":"string","description":"ID of parent device. Applies to wearable","minLength":1,"maxLength":64},"language":{"type":"string","description":"Language set on the device in ISO 639-3","minLength":1,"maxLength":3},"serialNumber":{"type":"string","minLength":1,"maxLength":64,"description":"Device serial number"},"timeZone":{"type":"string","description":"Device time zone abbreviation. Example: PST, GMT, etc...","minLength":1,"maxLength":32},"timeZoneSetting":{"type":"string","maxLength":32,"description":"Who has set the timezone.\nPossible values:\n- NETWORK_SET\n- CONSUMER_SET"},"simSerialNumber":{"type":"string","description":"Secure Element serial number","minLength":1,"maxLength":24},"IMEI":{"type":"string","minLength":1,"maxLength":32},"networkOperator":{"type":"string","description":"Network operator name.","maxLength":32},"networkType":{"type":"string","description":"Network type. Can be:\n- CELLULAR\n- WIFI","maxLength":16}},"required":["deviceId"]},"captureMethod":{"description":"Method used by the user or the issuer to capture card information to digitize.\n\nDescription:\n- CAMERA: when card information is captured by the on-device camera\n- MANUAL: when the consumer enters the card information manually, through the device keyboard\n- BANK_APP: when the card information is exchanged between the banking App and the Issuer App\n- ON-FILE: when the card information is retrieved by a merchant who has stored the card information\n- READER_MODE: when the card information is retrieved through a NFC interaction between the device and the physical card (applies to VISA and some domestic schemes)\n- TOKEN: when the card information is retrieved through a device-based token. This is applicable only to VISA token for token provisioning use case\n- CHIP_DIP: card information is captured by inserting (dip) the card into a terminal (only VISA)\n- UNKNOWN: the origin of the card information capture is not known  ","type":"string","maxLength":64},"digitalCardState":{"type":"string","description":"The state of the digital card (token)\n\nN.B. Tokens in DELETED state are included only if the corresponding issuer onboarding flag (i.e. manageDeletedToken) is set.\n","enum":["ACTIVE","INACTIVE","DELETED","DEPLOYMENT_ONGOING","PENDING_ACTIVATION"],"title":"digitalCardState"},"tokenType":{"type":"string","maxLength":16,"description":"The type of the token. Following values are supported:\n- SE\n- HCE\n- COF\n- ECOM\n- QRC"},"pullType":{"type":"string","description":"The type of operation performed to update card order","enum":["ACCELERATE","ACCELERATE_AND_REDIRECT","CANCEL","REDIRECT"]},"errorGeneric":{"type":"object","description":"Generic error returned by the APIs.","properties":{"error":{"type":"string","description":"Description of the error.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}},"newErrorGeneric":{"type":"object","description":"Error object with errorCode & error message.","properties":{"errorCode":{"type":"string","description":"The type of the error"},"error":{"type":"string","description":"Provide more error details if possible.<br/>For example name of the field with invalid format.<br/>This field is for troubleshooting purposes only, it can change at any time so MUST NOT be parsed, and is not supposed to be human readable so CANNOT be displayed to end users."}}}},"responses":{"BadRequest":{"description":"Bad Request, Invalid request URI or header, or unsupported non-standard parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"Unauthorized":{"description":"The provided Authorization header is missing or invalid","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}},"InternalServerError":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/errorGeneric"}}}}}},"paths":{"/issuers/{issuerId}/cards/{cardId}/operations/{operationId}":{"get":{"summary":"Get operation","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/operationCard"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Ressource not found, Unknown issuerId or consumerId or card id'. The below table defines the possible error:\n| errorCode      | error       | Retryable | Comments                             |\n| -------------- | ------------| ----------| -----------------------------------|\n| -              | -           | no | No error details available         |\n| UNKNOWN_CARD   | -           | no | Unknown cardId |\n| UNKNOWN_OPERATION    | -           | no | Unknown operationId |          \n","content":{"application/json":{"schema":{"$ref":"#/components/schemas/newErrorGeneric"}}}},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Operations"],"operationId":"get-card-operation-operationId","description":"This request is used by the issuer backend to retrieve the information related to an operation on a card.\n\nOperations older than 3 months are removed.","parameters":[{"schema":{"type":"boolean","default":false},"in":"query","description":"Flag indicating whether digital card details (including the device data used to digitize and the requestor data) should be provided in the response. Only applicable to DIGITIZE Operations","name":"digitalCardInfo"}]}}}}
````


---

# 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/d1-v1-api/d1-v1-api-references/card-operations/inbound/operations.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.