---
title: "Get a specific payout for a customer within Flow workflows"
method: GET
path: "/entities/{entityDID}/flow/customers/{customerDID}/payouts/{payoutId}"
tags: ["Flow"]
---

# Get a specific payout for a customer within Flow workflows

`GET /entities/{entityDID}/flow/customers/{customerDID}/payouts/{payoutId}`

## Request

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

Retrieves detailed information about a specific payout transaction for a customer
within a Flow workflow context. This endpoint verifies that the payout belongs
to the specified customer and returns comprehensive transaction details.

## Path parameters

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

## Response `200`

Payout details retrieved successfully

- object
  - `transfer` object
    - `@id` string: Unique identifier for the transfer
    - `@type` 'Payout': Type of transaction
    - `ref` string: Client reference (without flow- prefix)
    - `asset` string: Asset identifier for the transaction
    - `amount` string: Transaction amount
    - `status` 'OUTGOING' | 'INCOMING' | 'AWAITING-YOURS' | 'AWAITING-COUNTERPARTY' | 'REJECTED' | 'AUTHORIZED' | 'FLAGGED' | 'SETTLED' | 'FLAGGED-SETTLEMENT' | 'REVERTED' | 'REVERT-AUTHORIZED' | 'REVERT-REJECTED' | 'REVERT-FLAGGED' | 'REVERT-REQUESTED' | 'FROZEN' | 'CLEARED': The status of a transfer
    - `originator` string: Originator entity information
    - `beneficiary` string: Beneficiary entity information
    - `memo` string: Transaction memo or note
    - `supportedAssets` string[]: List of supported assets for this transaction
    - `flowState` string: Current Flow workflow state
    - `invoice` object: Flow-specific invoice data
    - `paymentLink` string: Payment link for customer interaction
    - `customerDid` string: Customer DID identifier
    - `merchantDid` string: Merchant DID identifier
    - `requiresCustomerApproval` boolean: Whether customer approval is required
    - `createdAt` string, date-time: Transaction creation timestamp
    - `agents` unknown[]: Associated agents for the transaction
      - unknown
    - `amounts` object: Detailed amount breakdown
    - `log` unknown[]: Transaction activity log
      - unknown
    - `policyEvaluations` unknown[]: Policy evaluation results
      - unknown

## 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`: Customer or payout not 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)