---
title: "Retrieve a transfer by customer token and transfer ID."
method: GET
path: "/programs/{programCode}/externalAccounts/customers/{customerToken}/transfers/{transferId}"
tags: ["ExternalAccount"]
---

# Retrieve a transfer by customer token and transfer ID.

`GET /programs/{programCode}/externalAccounts/customers/{customerToken}/transfers/{transferId}`

Retrieve the details of a specific transfer for a customer profile using the transfer ID.

## Path parameters

- `programCode` string, required
- `customerToken` string, required
- `transferId` string, required

## Headers

- `X-GD-RequestId` string, required
- `X-GD-CustomerType` string

## Response `200`

Transfer retrieved successfully.

- GetTransferResponse — Represents the response returned when retrieving details of a Green Dot Funds Transfer (GFT) operation. Contains comprehensive information about the transfer, including status, amounts, processor/network details, and any associated network response codes. Inherits standard response metadata from Gd.Bos.DataTransfer.Response.ResponseBase.
  - `transfer` GftTransfer — Represents the details of a Green Dot Funds Transfer (GFT) operation. Contains comprehensive information about the transfer, including identifiers, status, transaction and fee amounts, processor and network details, and a breakdown of applied fees. Used in transfer-related responses to provide a complete view of the transfer's outcome, financials, and processing context.
    - `transferId` string, nullable — The unique identifier for the transfer.
    - `transferStatus` string, nullable — The current status of the transfer (e.g., "pending", "completed", "failed").
    - `transferStatusReason` string, nullable — The reason for the current transfer status, if applicable.
    - `externalReferenceId` string, nullable — The external reference identifier for the transfer, if provided by an external system. This property is not serialized in the response payload.
    - `transactionDate` string, date-time, nullable — The date and time when the transaction was processed.
    - `currency` string, nullable — The ISO 4217 currency code for the transfer (e.g., "USD").
    - `transactionAmount` number, double, nullable — The amount involved in the transfer.
    - `totalFeeAmount` number, double, nullable — The total amount of fees applied to the transfer.
    - `totalTransactionAmount` number, double — The total transaction amount, including fees.
    - `feeDetails` FeeDetailModel[], nullable — A collection of fee details applied to the transfer, including type and amount for each fee.
      - `feeType` string, nullable — The type of fee (e.g., "service", "processing", "network").
      - `feeAmount` number, double — The monetary amount of the fee.
    - `totalTransactionNetAmount` number, double, nullable — The net amount of the transaction after deducting fees.
    - `processor` string, nullable — The name or code of the payment processor that handled the transfer.
    - `network` string, nullable — The name or code of the payment network used for the transfer.
  - `transferNetworkResponse` TransferNetworkResponse — Represents the network response details for a Green Dot Funds Transfer (GFT) operation. Contains information about the payment processor and network status, including processor code, network status code, and a human-readable status description. Used to provide additional context about the outcome of a transfer as reported by external payment networks or processors.
    - `processorCode` string, nullable — The code returned by the payment processor for the transfer.
    - `networkStatusCode` string, nullable — The status code returned by the payment network.
    - `networkStatusDescription` string, nullable — A human-readable description of the network status.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Transfer not found.
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)