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

# Create a claim code

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

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.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)