---
title: "Create an instant funding request"
method: POST
path: "/v1/instant_funding"
tags: ["Instant Funding"]
---

# Create an instant funding request

`POST /v1/instant_funding`

Creates an instant funding request. The request will be processed and the funds will be
made available to the account in the form of a Memopost non trade activity. Upon settlement
the Memoposted will be corrected to a CSD activity.

**Idempotency**: When the `Idempotency-Key` header is supplied, this endpoint is
idempotent. Multiple requests with the same key and identical request body will
create only one transfer. A subsequent request returns the previously created
transfer with the same response (no duplicate is created). If the same key is used
with a different request body, the API returns `422 Unprocessable Entity`.

**Recommended for production**: Always supply `Idempotency-Key` when creating
transfers. This allows safe retries on timeouts, network errors, or 5xx responses
without risking duplicate transfers. Use a client-generated unique value (e.g. UUID).

## Headers

- `Idempotency-Key` string

## Request body

- CreateIFTransferRequest — Request to create a new instant funding transfer
  - `account_no` string, required
  - `amount` string, decimal, required
  - `source_account_no` string, required

## Response `200`

Instant transfer request created.

- InstantFunding
  - `account_no` string, required
  - `amount` string, decimal, required
  - `created_at` string, date-time, required
  - `deadline` string, date, required
  - `fees` IFFee[], required
    - `amount` string, decimal, required
    - `id` string, uuid, required
    - `type` 'partner' | 'alpaca', required — Status: * `partner`: The fee on a transfer that was allocated to the partner * `alpaca`: The fee on a transfer that was allocated to Alpaca
  - `id` string, uuid, required
  - `interests` Interest[], required
    - `amount` string, decimal, required
    - `created_at` string, date-time, required
    - `date` string, date, required
    - `id` string, uuid, required
    - `reconciled_at` string, date-time, required
    - `status` 'PENDING' | 'CANCELED' | 'EXECUTED' | 'FAILED' | 'COMPLETED', required — Status: * `PENDING`: Created and waiting to be processed * `CANCELED`: Canceled * `EXECUTED`: All fees (including Partner fee) are transacted * `FAILED`: Failed mostly due to technical reasons * `COMPLETED`: All transactions are settled
  - `remaining_payable` string, decimal, required
  - `source_account_no` string, required
  - `status` 'PENDING' | 'CANCELED' | 'EXECUTED' | 'FAILED' | 'COMPLETED', required — Status: * `PENDING`: Created and waiting to be processed * `CANCELED`: Canceled * `EXECUTED`: All fees (including Partner fee) are transacted * `FAILED`: Failed mostly due to technical reasons * `COMPLETED`: All transactions are settled
  - `system_date` string, date, required
  - `total_interest` string, decimal, required

## Other responses

- `422` — Unprocessable Entity. Returned when an idempotency key is reused with a different request body.
- `default` — Error response.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)