--- title: "Get an incoming transfer by ID" method: GET path: "/v1/incoming-transfers/{incomingTransferId}" tags: ["incoming-transfer"] --- # Get an incoming transfer by ID `GET /v1/incoming-transfers/{incomingTransferId}` Retrieves an incoming transfer by id. You can pull the incoming-transfer ID from the webhook payload. ## Path parameters - `incomingTransferId` string, uuid, required ## Headers - `X-External-Correlation-Id` string, uuid ## Response `200` The incoming transfer. - IncomingTransfer — An incoming transfer credited to a Wise balance. - `id` string, uuid, required — Unique identifier for the incoming transfer. - `profileId` integer, required — Profile ID of the balance owner. - `balanceId` integer, required — Balance ID associated with the incoming transfer. This is the balance that was credited. - `accountDetailsId` integer — Account details ID that received the incoming transfer. A balance may have multiple account details (e.g. multiple IBANs). This identifies the specific one that was credited. Omitted when the payment was received via correspondent model. - `state` 'CREDITED', required — Current state of the incoming transfer. Additional states will be added in the future. - `scheme` 'SWIFT' | 'SEPA' | 'ACH' | 'FASTER_PAYMENTS' | 'WISE_NETWORK', required — The payment scheme through which the incoming transfer was received. These are not necessarily clearing systems as we also include SWIFT here. - `endToEndId` string — End-to-end identifier assigned by the debtor for reconciliation purposes. Omitted when not provided by the debtor. - `uetr` string, uuid — Universal End-to-End Transaction Reference. A globally unique identifier (UUID v4) assigned by the debtor agent to track the payment across the entire chain. - `unstructuredReference` string — Unstructured remittance information provided by the debtor. Free-text field carried through the payment rail. - `creditedTime` string, date-time, required — Timestamp when the incoming transfer was credited to the balance. - `debtor` Debtor, required — The debtor (ordering party) of the incoming transfer. - `name` string, required — Full name of the debtor. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. - `account` Account — Account identifier for a payment participant. - `number` string, required — Account identifier — IBAN, BBAN, or other scheme-specific account number. - `agent` FinancialInstitution — Financial institution (bank) associated with a payment participant. At least one of `bic`, `nationalCode`, or `name` will be present. - `bic` string — SWIFT BIC (Business Identifier Code) of the financial institution. - `nationalCode` string — Domestic clearing system membership identifier (e.g. UK sort code, US ABA routing number). - `nationalCodeType` 'ABA' | 'SORT_CODE' — Identifies the domestic clearing system the `nationalCode` belongs to. - `name` string — Name of the financial institution. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. - `creditor` Creditor, required — The creditor (beneficiary) of the incoming transfer. - `name` string, required — Full name of the creditor. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. - `account` Account, required — Account identifier for a payment participant. - `number` string, required — Account identifier — IBAN, BBAN, or other scheme-specific account number. - `agent` FinancialInstitution — Financial institution (bank) associated with a payment participant. At least one of `bic`, `nationalCode`, or `name` will be present. - `bic` string — SWIFT BIC (Business Identifier Code) of the financial institution. - `nationalCode` string — Domestic clearing system membership identifier (e.g. UK sort code, US ABA routing number). - `nationalCodeType` 'ABA' | 'SORT_CODE' — Identifies the domestic clearing system the `nationalCode` belongs to. - `name` string — Name of the financial institution. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. - `amounts` Amounts, required — Payment amount waterfall representing the flow of funds: `instructed` → `interbankSettlement` → `credited`. - `instructed` MoneyAmount, required — An amount with its currency. - `value` string, required — Decimal amount value, scaled to the currency's minor unit. - `currency` string, required — ISO 4217 three-letter currency code. - `interbankSettlement` MoneyAmount, required — An amount with its currency. - `value` string, required — Decimal amount value, scaled to the currency's minor unit. - `currency` string, required — ISO 4217 three-letter currency code. - `credited` MoneyAmount, required — An amount with its currency. - `value` string, required — Decimal amount value, scaled to the currency's minor unit. - `currency` string, required — ISO 4217 three-letter currency code. - `exchangeRate` string, required — Wise's effective FX rate applied to this incoming transfer (source currency → target balance currency) as a decimal string. "1" when no conversion was needed. - `chargeBearer` 'DEBTOR' | 'CREDITOR' | 'SHARED' | 'SERVICE_LEVEL' — Charge bearer code indicating who pays the transaction fees. Omitted if not specified in the payment message. - `previousInstructingAgents` FinancialInstitution[], required — Financial institutions that previously instructed this payment (the historical chain the payment passed through before reaching Wise). Ordered by position in the chain. - `bic` string — SWIFT BIC (Business Identifier Code) of the financial institution. - `nationalCode` string — Domestic clearing system membership identifier (e.g. UK sort code, US ABA routing number). - `nationalCodeType` 'ABA' | 'SORT_CODE' — Identifies the domestic clearing system the `nationalCode` belongs to. - `name` string — Name of the financial institution. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. - `fees` Fees, required — Breakdown of fees applied to the incoming transfer. Contains both Wise fees and correspondent/intermediary bank fees. - `wise` WiseFee[], required — Fees charged by Wise (e.g. conversion fee, handling fee). Empty array when no Wise fees apply. - `type` 'OTHER', required — Category of the Wise fee. Additional fee types will be added in future versions. - `value` string, required — Decimal fee amount. - `currency` string, required — ISO 4217 currency code. - `correspondent` CorrespondentFee[], required — Fees deducted by correspondent or intermediary banks before the funds reached Wise. Each entry includes the charging agent when available in the pacs message. Array is empty where there are no charges. - `value` string, required — Decimal fee amount deducted by the correspondent bank. - `currency` string, required — ISO 4217 currency code. - `agent` FinancialInstitution — Financial institution (bank) associated with a payment participant. At least one of `bic`, `nationalCode`, or `name` will be present. - `bic` string — SWIFT BIC (Business Identifier Code) of the financial institution. - `nationalCode` string — Domestic clearing system membership identifier (e.g. UK sort code, US ABA routing number). - `nationalCodeType` 'ABA' | 'SORT_CODE' — Identifies the domestic clearing system the `nationalCode` belongs to. - `name` string — Name of the financial institution. - `address` Address2 — Structured postal address. Fields are optional and populated based on what the payment rail provides. - `firstLine` string — First line of the address (unstructured). - `streetName` string — Street name. - `buildingNumber` string — Building number. - `townName` string — City or town. - `postalCode` string — Postal or ZIP code. - `countrySubDivision` string — State, province, or region. - `countryCode` string — ISO 3166-1 alpha-2 country code. ## Other responses - `401` — Missing or invalid authentication. - `403` — Insufficient permissions. - `404` — Resource not found. - `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header. --- [API](https://skmtc.net/wise/apis/platform-api.md) · [All operations](https://skmtc.net/wise/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wise/platform-api/versions/4907a1d269ab/schema)