# Card replacement

Notification that a card replacement has been requested or processed.

Endpoint: POST /managed_cards/replacement/watch
Version: v2

## Header parameters:

  - `call-ref` (string)
    A call reference generated by the caller and unique to the caller to provide correlation between the caller and system with a maximum length of 255

  - `published-timestamp` (integer, required)
    The timestamp, expressed in Epoch timestamp using millisecond precision, when this event was published.

  - `signature-v2` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the call-ref + payload + published-timestamp using your API key.

  - `signature` (string, required)
    The signature to verify the authenticity of this request.  This is the base64 hash (HmacSHA256) of the published-timestamp using your API key.

## Request fields (application/json):

  - `eventType` (string, required)
    The type of replacement event that occurred.
    Enum: "VIRTUAL_REPLACEMENT", "PHYSICAL_REPLACEMENT"

  - `id` (object, required)
    The id of the managed card on which the event occurred.

  - `id.id` (string, required)

  - `id.type` (string, required)
    Enum: "managed_cards", "managed_accounts"

  - `replacementId` (object)
    The id of the replacement card.

  - `replacementReason` (string, required)
    Enum: "DAMAGED", "LOST_STOLEN", "RENEW", "COMPROMISED"

  - `replacementTimestamp` (string, required)
    Epoch timestamp using millisecond precision.

  - `userId` (string)
    The id of the user linked to the managed card that was replaced.


## Response 204 fields