---
title: "Get Transfer Status"
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/disbursements/transfer/{transferIdentifier}"
tags: ["Disbursement"]
---

# Get Transfer Status

`GET /programs/{programCode}/accounts/{accountIdentifier}/disbursements/transfer/{transferIdentifier}`

Retrieves the status and details of a specific disbursement transfer for the given account and program.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required
- `transferIdentifier` string, required

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetTransferStatusResponse — Get Transfer Status Response – Contains the status and details of a specific transfer. Used to provide transaction details for a given transfer identifier.
  - `transaction` DisbursementTransactionDetail — Disbursement Transaction Detail – Represents detailed information about a disbursement transaction. Used to provide transaction attributes such as identifiers, status, claim code, original transaction codes, source and destination entities, and additional options in transfer status and history responses. Inherits common transaction properties from Gd.Bos.DataTransfer.Response.ResponseObjects.DisbursementTransferInfo.
    - `transferIdentifier` string, nullable — The unique identifier of the transfer transaction.
    - `status` string, nullable — The current status of the transaction (e.g., "pending", "completed", "failed").
    - `statusReason` string, nullable — The reason for the current status, if applicable (e.g., "insufficient funds", "expired").
    - `claimCode` string, nullable — The claim code associated with the transaction, if applicable (e.g., for cash pickup).
    - `claimCodeExpirationDate` string, nullable — The expiration date of the claim code (format: yyyy-MM-dd), if applicable.
    - `originalTransactionCode` integer, nullable — The original transaction code, if this transaction is related to a previous transaction.
    - `originalTransactionCodeDescription` string, nullable — The description of the original transaction code, if applicable.
    - `originalTransactionSubCode` integer, nullable — The original transaction sub-code, if this transaction is related to a previous transaction.
    - `source` DisbursementTransferEntity — Disbursement Transfer Entity – Represents an entity involved in a disbursement transaction, such as the source or destination of a transfer. Used to provide entity details including name, unique identifier, and additional metadata for transaction tracking and auditing.
      - `name` string, nullable — The display name of the entity (e.g., account holder, merchant, or partner).
      - `id` string, nullable — The unique identifier for the entity (e.g., account ID, link ID, or external reference).
      - `details` StringKeyValuePair[], nullable — Additional details or metadata for the entity, represented as a list of string key-value pairs. Used to store custom attributes or options relevant to the entity in the context of the transaction.
        - `key` string
        - `value` string
    - `destination` DisbursementTransferEntity — Disbursement Transfer Entity – Represents an entity involved in a disbursement transaction, such as the source or destination of a transfer. Used to provide entity details including name, unique identifier, and additional metadata for transaction tracking and auditing.
      - `name` string, nullable — The display name of the entity (e.g., account holder, merchant, or partner).
      - `id` string, nullable — The unique identifier for the entity (e.g., account ID, link ID, or external reference).
      - `details` StringKeyValuePair[], nullable — Additional details or metadata for the entity, represented as a list of string key-value pairs. Used to store custom attributes or options relevant to the entity in the context of the transaction.
        - `key` string
        - `value` string
    - `options` StringKeyValuePair[], nullable — Additional options or metadata for the transaction, represented as key-value pairs.
      - `key` string
      - `value` string
    - `amount` number, double — Transaction Amount
    - `currency` string, nullable — Transaction Currency
    - `description` string, nullable — Transaction Description
    - `transactionDate` string, nullable — TransactionDate
    - `externalReferenceId` string, nullable — ExternalReferenceId
  - `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
- `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)