---
title: "Request to fetch messages for a specific virtual card"
method: POST
path: "/getMessages"
---

# Request to fetch messages for a specific virtual card

`POST /getMessages`

This method is used by Wallet Server to fetch messages for a specific virtual card.

## Headers

- `x-pod` string, required

## Request body

- GetMessagesReq
  - `requestHeader` RequestHeader, required
    - `requestId` string, required — Unique request identifier
    - `sessionId` string, required — Unique session identifier used to trace the calls across systems during a use case.
    - `generationDateTime` string, date-time — Date time representing when the request or response has been generated.<br/>RFC3339 format.<br/> Examples:<li>"2018-12-24T17:32:28Z"<li>"2019-10-02T10:00:00-05:00"
  - `walletCardId` string, required — The Wallet Card Identifier. Unique for each wallet card.
  - `lastUpdatedTimestamp` string, date-time — Timestamp used for filtering messages.</br> Messages already provided to wallet server before this timestamp will not be returned.</br> Its format is as specified in RFC 3339

## Response `200`

getMessages response payload

- GetMessagesRes
  - `responseHeader` ResponseHeader, required
    - `responseId` string, required — Unique response identifier
    - `sessionId` string, required — Unique session identifier used to trace the calls across systems during a use case.
    - `generationDateTime` string, date-time — Date time representing when the request or response has been generated.<br/>RFC3339 format.<br/> Examples:<li>"2018-12-24T17:32:28Z"<li>"2019-10-02T10:00:00-05:00"
    - `statusCode` number, required — Status code to the request |Status code | Description| |-------|-------| |0|OK| |111|Missing mandatory parameter| |112|Bad parameter format| |113|Unknown issuer| |118|Unknown session| |119|Unknown virtual card| |432|Operation is not allowed with current card state| |911|Operation failed| |921|Unexpected server error|
    - `statusMessage` string — Textual status message
  - `lastUpdatedTimestamp` string, date-time — Timestamp used for filtering messages.</br> Messages already provided to wallet server before this timestamp will not be returned.</br> Its format is as specified in RFC 3339
  - `messages` object[] — Array of message for the supplied walletCardId using lastUpdatedTimestamp for filtering
    - `identifier` string, required — unique identifier of the message
    - `messageDate` string, date-time, required — Date when the message was generated.</br> Its format is as specified in RFC 3339
    - `expirationDate` string, date-time, required — Date when the message is no longer valid and should be removed.</br> Its format is as specified in RFC 3339
    - `content` string, required — Plain text message to be displayed to the end user
    - `allowDeepLink` boolean — Flag indicating if the message should "deep link" to the issuer's app

## Other responses

- `500` — Internal Server Error

---

[API](https://skmtc.net/thalescloud/apis/d1-oauth-api.md) · [All operations](https://skmtc.net/thalescloud/apis/d1-oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thalescloud/d1-oauth-api/versions/96089514858c/schema)