# Create payout from a business' savings account


Transfers money from a business' savings account to its main account.


Endpoint: POST /v1/businesses/{business_id}/deposit_accounts/{account_id}/payout
Version: 1.0

## Path parameters:

  - `business_id` (string, required)
    Unique ID of a business.
    Example: "990bbac68a34add190786b9c74f4c82fcbiz"

  - `account_id` (string, required)
    Unique ID of a Solaris account.
    Example: "e48c29b85992b8772eb7ddd518490920cacc"

## Request fields (application/json):

  - `main_account_id` (string, required)
    ID of the main account.
    Example: "148c29b85992b8772eb7ddd518490110cacc"

  - `reference` (string, required)
    UUID to use as an idempotency reference for the transaction.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

  - `amount` (object, required)
    The amount to pay out to the main account.

  - `amount.value` (integer)
    The amount.
    Example: 5000

  - `amount.unit` (string)
    Money unit used to represent the amount.
    Example: "cents"

  - `amount.currency` (string)
    The currency in which the amount is represented.
    Example: "EUR"

  - `description` (string)
    Optional note about the transaction.
    Example: "Transfer money from Deposit Account to Main Account"

## Response 201 fields (application/json):

  - `id` (string, required)
    Transaction ID of the payout request.
    Example: "d222a0b8-07ea-49be-83c1-68719be286e8"

  - `main_account_id` (string, required)
    ID of the main account.
    Example: "148c29b85992b8772eb7ddd518490110cacc"

  - `reference` (string, required)
    UUID to use as an idempotency reference for the transaction.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

  - `amount` (object, required)
    The amount of the transaction.

  - `amount.value` (integer)
    The amount.
    Example: 5000

  - `amount.unit` (string)
    Money unit used to represent the amount.
    Example: "cents"

  - `amount.currency` (string)
    The currency in which the amount is represented.
    Example: "EUR"

  - `description` (string)
    Optional note about the transaction.
    Example: "Transfer money from Deposit Account to Main Account"

  - `created_at` (string)
    UTC timestamp from when the transaction was requested.
    Example: "2023-10-10T16:02:54Z"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `details` (string)
    Example: "Cannot connect to database."

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `details` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `details` (string)
    Example: "Couldn't find {resource} for id {resource_id}."

## Response 500 fields (application/json):

  - `id` (string)
    Example: "e8915041-9d8c-4d96-9dd1-04e8522ecdbf"

  - `status` (string)
    Example: "500"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Generic Error"

  - `details` (string)
    Example: "There was an error."