# Transfer transaction

Notification that a Transfer transaction has been processed.

Endpoint: POST /transfers/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)
    Enum: "PENDING", "COMPLETED", "FAILED", "SCHEDULED", "CANCELLED"

  - `transfer` (object, required)

  - `transfer.id` (object, required)

  - `transfer.id.type` (string, required)

  - `transfer.profileId` (string, required)

  - `transfer.tag` (string)

  - `transfer.source` (object, required)

  - `transfer.destination` (object, required)

  - `transfer.destinationAmount` (object, required)
    The object representing a monetary amount in a particular currency.

  - `transfer.destinationAmount.currency` (string, required)
    The currency expressed in ISO-4217 code. Example: GBP, EUR, USD.

  - `transfer.destinationAmount.amount` (string, required)
    The monetary amount, scaled to the lowest denomination of the currency.

  - `transfer.state` (string, required)
    Enum: "INITIALISED", "COMPLETED", "REJECTED", "FAILED", "PENDING", "SCHEDULED", "CANCELLED"

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

  - `transfer.conflict` (string)
    Enum: "UNDEFINED", "NO_ERROR", "PROFILE_INACTIVE", "MODEL_CONSTRAINTS_VIOLATED", "DENIED_BY_INTERCEPTOR", "DENIED_BY_INSTRUMENT", "DENIED_BY_FOREX_TRADE", "CURRENCY_MISMATCH", "INSUFFICIENT_FUNDS", "SYSTEM_ERROR", "SOURCE_NOT_FOUND", "DESTINATION_NOT_FOUND", "FEE_NOT_CONFIGURED_FOR_CURRENCY", "DESTINATION_LIMIT_EXCEEDED", "TRANSFER_BETWEEN_INSTRUMENTS_UNSUPPORTED", "SOURCE_INSTRUMENT_BLOCKED", "DESTINATION_INSTRUMENT_BLOCKED", "INVALID_AMOUNT", "SCHEDULED_TIMESTAMP_INVALID"

  - `transfer.scheduledTimestamp` (string)
    The epoch timestamp at which the transaction is scheduled to be executed.

  - `transfer.cancellationReason` (string)
    The reason the scheduled transaction was cancelled.

  - `transfer.executionTimestamp` (string)
    The epoch timestamp at which the transaction was executed, transitioning to a final state such as COMPLETED, REJECTED, or FAILED.

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


## Response 204 fields