---
title: "Create a claim code"
method: POST
path: "/v1.2/Transfers/{transferId}"
tags: ["Transfer"]
---

# Create a claim code

`POST /v1.2/Transfers/{transferId}`

## Request

- Base URL: `https://qa2-partners.greendotcorp.com/Disbursements/API`
- URL: `https://qa2-partners.greendotcorp.com/Disbursements/API/v1.2/Transfers/{transferId}`
- Auth: none declared. Required headers: `requestid`, `enduserip`, `Authorization`

Creates a cash pickup claim code using the specified Transfer ID

## Path parameters

- `transferId` string, required

## Headers

- `requestid` string, required
- `endusersecurityid` string
- `enduserip` string, required
- `partneridentifier` string
- `Authorization` string, required
- `apikey` string

## Request body

- TransferRequest
  - `transferobjects` TransferObjects: TransferObjects
    - `sourceuri` string: Source Uri
    - `destinationuri` string: Target Uri
  - `transaction` Transaction: Transaction
    - `amount` number, double: Transaction Amount
    - `currency` string: Transaction Currency
    - `description` string: Transaction Description
    - `transactiondate` string, date-time: TransactionDate
    - `lastmodifieddate` string, date-time: FulfillmentDate
    - `fees` Fees[]: FulfillmentDate
      - `feeamount` number, double: Fee Amount
      - `feetype` string: Fee Type
      - `requeststatuskey` integer: Request Status Key
  - `options` StringKeyValuePair[]: options
    - `key` string
    - `value` string
  - `retailer` Retailer: Retailer
    - `retailerkey` integer: RetailerKey
    - `storenumber` string: StoreId
    - `terminalid` string: TerminalId
    - `statecode` string: StateCode
    - `storename` string: StoreName
    - `city` string: city
    - `storezip` string: Gets or sets the store zip.

## Response `200`

OK

- TransferResponseV11: TransferResponse
  - `transferid` string: TransferId
  - `status` string: status
  - `claimcode` string: ClaimCode
  - `claimexpirationdate` string, date-time: ClaimExpirationDate
  - `fees` Fees[]: Fees
    - `feeamount` number, double: Fee Amount
    - `feetype` string: Fee Type
    - `requeststatuskey` integer: Request Status Key
  - `allowedamount` number, double: Allowed Amount
  - `fundsavailability` string: FundsAvailability
  - `externalreferenceid` string: ExternalReferenceId = retrieval_reference from MCSend
  - `responsecode` integer: Specifies the status of a Disbursement Core Service Service operation
  - `responsemessage` string: Specifies the descriptive text on the status of a Disbursement Core Service operation
  - `responsedate` string, date-time: RespnseDate
  - `responsedetail` TransferApiResponseDetail: TransferApiResponseDetail
    - `responsedetailcode` integer: ResponseDetailCode
    - `responsedetaildescription` string: ResponseDetailDescription

---

[API](https://skmtc.dev/greendot/apis/cash-pickup-apis-new.md) - [All operations](https://skmtc.dev/greendot/apis/cash-pickup-apis-new/llms.txt) - [OpenAPI document](https://skmtc.dev/greendot/apis/cash-pickup-apis-new/revisions/026e836b67c9?raw)