> ## Documentation Index
> Fetch the complete documentation index at: https://yn-c9bb3266.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Purposes List

> Enum values for payout purpose codes used when creating payouts.

Use these purpose codes in the `purpose` field when creating a [Payout](/api-reference/payouts/create). The purpose classifies the reason for the fund transfer and may be required by certain providers or jurisdictions.

## Personal & Family

| Purpose              | Description                            |
| -------------------- | -------------------------------------- |
| `FAMILY_AND_FRIENDS` | Family and friend maintenance/transfer |
| `PERSONAL_TRANSFER`  | Personal transfer                      |
| `REMITTANCES`        | Remittances                            |
| `SAVINGS`            | Savings                                |
| `RETIREMENT`         | Retirement account                     |
| `PENSION`            | Pension purposes                       |

## Business Services

| Purpose                   | Description                      |
| ------------------------- | -------------------------------- |
| `PROVIDER_SERVICES`       | Provider general services        |
| `ADVERTISING_SERVICES`    | Provider advertising services    |
| `REPRESENTATION_SERVICES` | Provider representation services |
| `ADVISORY_SERVICES`       | Provider advisory services       |
| `FREELANCER_SERVICES`     | Provider freelancer services     |
| `SUPPLIER`                | Supplier payments                |
| `BUSINESS_TO_BUSINESS`    | Business to business             |
| `CORPORATE_PAYMENT`       | Corporate payments               |

## Commerce

| Purpose                      | Description                  |
| ---------------------------- | ---------------------------- |
| `MARKETPLACE`                | Marketplace purchases        |
| `PURCHASE_OF_PHYSICAL_GOODS` | Purchase of physical goods   |
| `PURCHASE_OF_DIGITAL_GOODS`  | Purchase of digital goods    |
| `PURCHASE_OF_SERVICES`       | Purchase of general services |

## Employment

| Purpose               | Description              |
| --------------------- | ------------------------ |
| `PAYROLL`             | Payroll payment services |
| `GIFTS_AND_BENEFITS`  | Gifts and benefits       |
| `EXPENSES`            | General expenses         |
| `REWARDS`             | Rewards purposes         |
| `AFFILIATION_PROGRAM` | Affiliation programs     |

## Financial

| Purpose                | Description                           |
| ---------------------- | ------------------------------------- |
| `CAPITAL_CONTRIBUTION` | Capital contribution                  |
| `INVESTMENTS`          | Investment owed to a financial entity |
| `INVESTMENTS_SHARES`   | Investment shares                     |
| `LOANS`                | Loans settlement                      |
| `INSURANCE`            | Insurance payments                    |
| `TAXES`                | Tax payments                          |

## Logistics & Travel

| Purpose                        | Description                           |
| ------------------------------ | ------------------------------------- |
| `LOGISTICS_AND_TRANSPORTATION` | Logistics and transportation services |
| `DELIVERY`                     | Delivery services                     |
| `TRAVEL_FLIGHTS`               | Travel tickets or tourism agencies    |
| `TRAVEL_ACCOMMODATIONS`        | Travel accommodations                 |

## Real Estate

| Purpose      | Description                               |
| ------------ | ----------------------------------------- |
| `REAL_STATE` | Real estate purchase and general expenses |
| `RENT`       | Property rental                           |

## Education & Health

| Purpose            | Description           |
| ------------------ | --------------------- |
| `EDUCATION`        | Education costs       |
| `TRAININGS`        | Training costs        |
| `TUITION_COSTS`    | Study/tuition costs   |
| `MEDICAL_SERVICES` | Medical care services |

## Other

| Purpose                    | Description                     |
| -------------------------- | ------------------------------- |
| `CHARITY`                  | Charity donations               |
| `ENTERTAINMENT`            | Entertainment services          |
| `TRADEMARKS_AND_COPYRIGHT` | Trademark and copyright rewards |
| `GOVERNMENT`               | Public/government services      |
| `OTHERS`                   | Other payout purposes           |

## Usage Example

```json theme={"theme":{"light":"github-dark","dark":"github-dark"}}
{
  "amount": {
    "value": 5000.00,
    "currency": "USD"
  },
  "country": "US",
  "purpose": "PAYROLL",
  "merchant_reference": "payroll-2026-03",
  "description": "March 2026 payroll"
}
```

## Related Pages

* [Create Payout](/api-reference/payouts/create). Where purpose codes are used
* [Payout Object](/api-reference/payouts/object). The payout resource
