---
title: "Get Transfer"
method: POST
path: "/getTransfer"
tags: ["Transfers"]
---

# Get Transfer

`POST /getTransfer`

> 👍 Availability
>
>Some of the field descriptions for this endpoint reference FedNow or Fedwire, which are future capabilities not yet available for clients.

Use the Get Transfer endpoint to retrieve information about an existing incoming or outgoing transferthat was initiated by the <a href="ref:payhub_post_createTransfer" target="_blank">Create Transfer</a>.

## Headers

- `Authorization` string, required

## Request body

- object
  - `accountNo` string, required — The <<glossary:PRN>> associated with this transfer. The `direction` field in the response identifies whether this account is the source or destination of the funds. Pattern: PRN Example: "`074103447228`"
  - `transferId` string, required — Unique identifier for the specific transfer to retrieve. Pattern: Alphanumeric string Example: "`890e4567-e89b-12d3-a456-426614174222`"

## Response `200`

Successful Response

- object
  - `transferId` string, required — The unique identifier for the transfer.
  - `currencyAmount` object, required — Response-side currency amount. Raises InternalServiceException (500) on invalid persisted data — bad values in response construction reflect server-side data integrity issues, not client error.
    - `amount` number, required
    - `currency` string — Currency code following ISO 4217 standard. Validation: Exactly 3 uppercase letters. Pattern: ^[A-Z]{3}$ Example: 'USD' (US Dollar), 'EUR' (Euro), 'GBP' (British Pound)
  - `purpose` string — The purpose provided for the transfer.
  - `remittanceInfo` string — Additional details about the transfer, such as an invoice number.
  - `createdDate` string, required — Timestamp when the transfer was created or received.
  - `paymentMethod` 'ACH' | 'FEDNOW' | 'FEDWIRE' | 'CARD', required — Payment network used for the transfer. Possible values:
  - `accountNo` string, required — The <<glossary:PRN>> associated with this view of the transfer.
  - `sourceAccount` object, required
    - `type` 'GALILEO_ACCOUNT' | 'EXTERNAL_ACCOUNT_REFERENCE' | 'EXTERNAL_ACCOUNT_LINK_REQUEST' | 'LEGACY', required — Indicates the account category.
  - `destinationAccount` object, required
    - `type` 'GALILEO_ACCOUNT' | 'EXTERNAL_ACCOUNT_REFERENCE' | 'EXTERNAL_ACCOUNT_LINK_REQUEST' | 'LEGACY', required — Indicates the account category.
  - `direction` 'IN' | 'OUT', required — Direction of the transfer relative to the specified account. - IN: The specified account is the destination account of the transfer - OUT: The specified account is the source account of the transfer Note: Direction indicates transfer flow, but actual fund movement depends on the debit/credit indicator. For example, an incoming debit or outgoing credit may both result in funds leaving the specified account.
  - `status` 'CREATED' | 'IN PROGRESS' | 'COMPLETED' | 'FAILED' | 'PENDING REVIEW' | 'SENT' | 'ACCEPTED WITHOUT POST' | 'BLOCKED' | 'REJECTED' | 'REQUESTED' | 'REQUEST APPROVED' | 'REQUEST REJECTED', required — Status of the transaction. **For FedNow and FedWire transactions:** - CREATED: Initial state for transactions after creation via API call. - SENT: Outbound-only state indicating payment message (pacs.008 or pacs.004) successfully published to the payment network, awaiting pacs.002 status report. - IN PROGRESS: Transaction is being processed. - COMPLETED: Terminal success state. Payment network confirmed successful settlement via pacs.002 with ACSC or ACCC status. - FAILED: Terminal failure state. Transaction rejected by payment network or receiving FI initially. **For FedNow transactions only:** - ACCEPTED WITHOUT POST: Special intermediate state for outbound payments. Received pacs.002 with ACWP status - funds have settled but receiving Financial Institution requires additional investigation time before posting. - BLOCKED: Terminal state for outbound payments previously in ACCEPTED WITHOUT POST. Receiving FI sent pacs.002 with BLCK status - funds are blocked and will not be posted. - REJECTED: Terminal state for outbound payments previously in ACCEPTED WITHOUT POST. Received pacs.002 with RJCT status after investigation - funds must be returned via new pacs.004. - REQUESTED: Return has been requested (FedNow returns only). - REQUEST APPROVED: Return request has been approved (FedNow returns only). - REQUEST REJECTED: Return request has been rejected (FedNow returns only).
  - `statusDetails` string, required — Additional details or reasons for the current transfer status.
  - `railInformation` object — Contains payment rail specific information
    - `type` 'ACH' | 'FEDNOW' | 'FEDWIRE' | 'CARD', required — Payment network used for the transfer.
  - `externalId` string — Client-defined identifier provided when the transfer was created.
  - `networkReferenceId` string — Primary network reference for the transaction. For FedWire, this field contains the UETR. For FedNow, it contains either the UETR or the Transaction Identification, as indicated by the `networkReferenceIdType` in the `railInformation` field.
  - `paymentType` 'RETURN' | 'CUSTOMER CREDIT TRANSFER' — - RETURN: Funds sent back to the originator to reverse a specific transaction - CUSTOMER CREDIT TRANSFER: A standard payment initiated by the customer to a third party
  - `returnDetails` object — Payment return information for reversing a previous transfer.
    - `code` string — Reason code describing why the transaction was returned. Validation: - FEDNOW: Required. Uses ISO 20022 External Status Reason Codes (pacs.002 StsRsnInf/Rsn/Cd). Must be 1-4 characters. Common codes include AC01 (Incorrect account number), AC03 (Invalid creditor account number), AC04 (Closed account number), AC06 (Blocked account), AC13 (Invalid debtor account type), AC14 (Invalid agent), AC15 (Account details changed), AG01 (Transaction forbidden). Refer to ISO 20022 ExternalCodeSets for the complete list of reason codes.
    - `additionalInfo` string — Optional additional context for the return. Validation: - FEDNOW: Maximum 105 characters. Maps to ISO 20022 pacs.002 StsRsnInf/AddtlInf.
    - `originalTransactionId` string, uuid, required — Reference to the original transaction being returned (transferId).
  - `failureDetails` object — Contains failure details with different rejection sources
    - `type` 'NETWORK' | 'GALILEO', required — Identifies where the rejection originated.
  - `sourceEntities` object — Source side entities - entities and agents involved in originating the transfer
    - `ultimateSource` object — Entity involved in a transfer
      - `name` string — Name of the entity. FedNow: Maps to ISO 20022 Nm element.
      - `address` object — Postal address of the entity. FedNow: Maps to ISO 20022 PstlAdr element.
        - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
        - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
        - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
        - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
      - `identification` object — Identity information for the first or third party entity
        - `type` 'CONSUMER' | 'CORPORATE', required — Discriminator for entity identification type
        - `other` object[] — List of other unique identifications for the entity. Used for proprietary or custom identifiers not covered by standard fields. FedNow: Maps to ISO 20022 Othr element.
          - `id` string, required — Unique identification value assigned to the entity. Examples: `customer ID`, `tax ID`, `membership number`. FedNow: Maps to ISO 20022 Othr/Id.
    - `initiatingParty` object — Entity involved in a transfer
      - `name` string — Name of the entity. FedNow: Maps to ISO 20022 Nm element.
      - `address` object — Postal address of the entity. FedNow: Maps to ISO 20022 PstlAdr element.
        - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
        - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
        - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
        - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
      - `identification` object — Identity information for the first or third party entity
        - `type` 'CONSUMER' | 'CORPORATE', required — Discriminator for entity identification type
        - `other` object[] — List of other unique identifications for the entity. Used for proprietary or custom identifiers not covered by standard fields. FedNow: Maps to ISO 20022 Othr element.
          - `id` string, required — Unique identification value assigned to the entity. Examples: `customer ID`, `tax ID`, `membership number`. FedNow: Maps to ISO 20022 Othr/Id.
    - `instructingAgent` object — Financial institution involved in originating the transfer
      - `memberId` string — Clearing system member identification. The format depends on the clearing system specified in `clearingSystemId`. FedNow: 9-digit ABA routing number (RTN). Maps to ISO 20022 ClrSysMmbId/MmbId.
      - `clearingSystemId` string — Identifies the clearing system for the member ID. Example: `USABA` for US ABA routing numbers. FedNow: Maps to ISO 20022 ClrSysId/Cd.
      - `bic` string — Business Identifier Code (BIC) of the financial institution. 8 or 11 character SWIFT code. FedNow: Maps to ISO 20022 FinInstnId/BICFI.
      - `lei` string — Legal Entity Identifier (LEI) of the financial institution. 20 character alphanumeric code. FedNow: Maps to ISO 20022 FinInstnId/LEI.
      - `name` string — Name of the financial institution. FedNow: Maps to ISO 20022 FinInstnId/Nm.
      - `address` object — Postal address of the financial institution. FedNow: Maps to ISO 20022 FinInstnId/PstlAdr.
        - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
        - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
        - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
        - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
  - `destinationEntities` object — Destination side entities - entities and agents involved in receiving the transfer
    - `instructedAgent` object — Financial institution involved in originating the transfer
      - `memberId` string — Clearing system member identification. The format depends on the clearing system specified in `clearingSystemId`. FedNow: 9-digit ABA routing number (RTN). Maps to ISO 20022 ClrSysMmbId/MmbId.
      - `clearingSystemId` string — Identifies the clearing system for the member ID. Example: `USABA` for US ABA routing numbers. FedNow: Maps to ISO 20022 ClrSysId/Cd.
      - `bic` string — Business Identifier Code (BIC) of the financial institution. 8 or 11 character SWIFT code. FedNow: Maps to ISO 20022 FinInstnId/BICFI.
      - `lei` string — Legal Entity Identifier (LEI) of the financial institution. 20 character alphanumeric code. FedNow: Maps to ISO 20022 FinInstnId/LEI.
      - `name` string — Name of the financial institution. FedNow: Maps to ISO 20022 FinInstnId/Nm.
      - `address` object — Postal address of the financial institution. FedNow: Maps to ISO 20022 FinInstnId/PstlAdr.
        - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
        - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
        - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
        - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
    - `ultimateDestination` object — Entity involved in a transfer
      - `name` string — Name of the entity. FedNow: Maps to ISO 20022 Nm element.
      - `address` object — Postal address of the entity. FedNow: Maps to ISO 20022 PstlAdr element.
        - `line1` string — First line of the address. Pattern: - Default: 1-105 characters with at least one non-whitespace character - FEDWIRE: 1-105 characters, limited to alphanumeric and special characters
        - `line2` string — Second line of the address (apartment, suite, etc.). Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `city` string — City name. Pattern: - Default: 1-35 characters with at least one non-whitespace character - FEDWIRE: 1-35 characters, limited to alphanumeric and special characters
        - `state` string — State or province code. Pattern: - Default: 2-35 characters with at least one non-whitespace character. For US addresses, typically 2-letter state code (e.g., 'NY', 'CA') - FEDWIRE: 2-35 characters, limited to alphanumeric and special characters
        - `zipCode` string — Postal code or ZIP code. Pattern: - Default: 1-15 characters with at least one non-whitespace character. For US addresses, typically 5-digit ZIP code (e.g., '11201') - FEDWIRE: 1-15 characters, limited to alphanumeric and special characters
        - `country` string — Country code following ISO 3166-1 alpha-2 format. Pattern: Exactly 2 uppercase letters. Examples: 'US' (United States), 'MX' (Mexico)
      - `identification` object — Identity information for the first or third party entity
        - `type` 'CONSUMER' | 'CORPORATE', required — Discriminator for entity identification type
        - `other` object[] — List of other unique identifications for the entity. Used for proprietary or custom identifiers not covered by standard fields. FedNow: Maps to ISO 20022 Othr element.
          - `id` string, required — Unique identification value assigned to the entity. Examples: `customer ID`, `tax ID`, `membership number`. FedNow: Maps to ISO 20022 Othr/Id.

## Other responses

- `400` — Bad Request
- `401` — No valid API credentials provided.
- `403` — The provided API credential does not allow this operation.
- `404` — Not Found
- `422` — Validation Error
- `429` — Too many requests.
- `500` — Internal Server Error
- `502` — Bad Gateway.
- `503` — Service Unavailable.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/revisions/bcd728f97a18/schema)