---
title: "Authorize payout by selecting asset and optional settlement address"
method: POST
path: "/entities/{entityDID}/flow/payouts/{payoutId}/settlement_asset"
tags: ["Flow"]
---

# Authorize payout by selecting asset and optional settlement address

`POST /entities/{entityDID}/flow/payouts/{payoutId}/settlement_asset`

## Request

- Base URL: `https://api.eu1.notabene.id`
- URL: `https://api.eu1.notabene.id/entities/{entityDID}/flow/payouts/{payoutId}/settlement_asset`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/notabene/apis/notabene-api/docs/entities/:entityDID/flow/payouts/:payoutId/settlement_asset/post.ts> (a function with typed inputs; its response is checked against the schema)

Authorizes a payout by confirming the asset to be used and, optionally,
a settlement address. Requirements depend on whether the entity is initiator
or responder in the workflow.

## Path parameters

- `entityDID` string, did, required: Decentralized Identifier (DID)
- `payoutId` string, uuid, required

## Request body

- object
  - `asset` string, required: Selected asset (CAIP-19)
  - `settlementAddress` string: Optional settlement address (CAIP-10 or payto://)

## Response `200`

Authorization accepted

- object
  - `message` string
  - `transferId` string
  - `asset` object
  - `settlementAddress` string

## Other responses

- `400`: Bad Request - The server could not process the request due to a client error.
- `401`: Unauthorized - Authentication information is missing or invalid.
- `403`: Forbidden - The server understood the request but refuses to authorize it.
- `404`: Not Found - The requested resource could not be found.
- `500`: Internal Server Error - An unexpected condition was encountered on the server.

---

[API](https://skmtc.dev/notabene/apis/notabene-api.md) - [All operations](https://skmtc.dev/notabene/apis/notabene-api/llms.txt) - [OpenAPI document](https://skmtc.dev/notabene/apis/notabene-api/revisions/70056745a433?raw)