---
title: "Create Transfers"
method: POST
path: "/v2/transfer"
tags: ["Transfer"]
---

# Create Transfers

`POST /v2/transfer`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/transfer`
- Auth: API key in header `Digital-Signature`

This route is used to send your transfers to their receivers.
You can create up to 100 transfers in a single request.

## Request body

- object
  - `accountNumber` string, required: Receiver bank account number. Use "-" before the validation digit. Example: 876543-2.
  - `amount` integer, required: A positive integer that represents the amount in cents to be transferred. Example: 100 (R$1.00)
  - `bankCode` string, required: Besides informing the receiver bank, this parameter specifies whether this will be a Pix or a Ted transfer. If you wish to send a Pix, pass the bank ISPB (8 digits). Example: 20018183 = StarkBank. If you wish to send a Ted, pass the usual bank code (1 to 3 digits). Example: 665 = Stark
  - `branchCode` string, required: Receiver bank account branch. Use "-" in case there is a validation digit. Example: 1234-5
  - `name` string, required: Receiver full name. Example: "Joana da Silva"
  - `taxId` string, required: Receiver CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: 012.345.678-90
  - `accountType` string: Receiver bank account type. Options are "checking", "payment", "savings" and "salary". "checking" is the default. This parameter only has effect on Pix Transfers.
  - `description` string: Optional description to override default description to be shown in the bank statement. Example: "Payment for service #1234"
  - `displayDescription` string: Description to be shown in the receiver bank interface. ex: "Payment for service #1234"
  - `externalId` string: Unique ID to prevent duplicate transfers. Repeated externalIds should cause failures by duplication. By default, it blocks transfers to the same bank account with the same amount on the same day. Example: "my-internal-id-123456"
  - `rules` string[]: List of rules for modifying transfer behavior. Example: [{"key": "resendingLimit", "value": 5}]
  - `scheduled` string, date-time: Schedule the transfer for a specific date. Today is the default. Ted Transfer's schedules for today will be accepted until 16:00 (BRT) and will be pushed to the next business day afterwards. Pix Transfers are available 24/7 and can be scheduled for any date and time. Example: "2020-08-14T15:23:26+00:00" or "2020-08-14"
  - `tags` string[]: Array of strings to tag the entity for future queries. All tags will be converted to lowercase.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)