# Funding And Destinations

> API Kickstart for funding endpoints, deposit instructions, and withdrawal destinations.

Source: https://business-api-docs.youhodler.com/docs/reference/funding-and-destinations

This group covers reusable funding surfaces and reusable destination surfaces.
Read it as setup before execution: provision inbound surfaces first, read the
actual deposit coordinates second, then define reusable outbound and rail
configuration surfaces.

> **Why this group exists:** `funding-endpoints`, `deposit-instructions`, and `withdrawal-destinations` are reusable setup surfaces for later financial operations. They prepare the rails before live execution depends on them.

## Reusable Setup Surfaces

### List funding endpoints

Provisioned inbound surfaces. Read funding endpoints to inspect which reusable inbound routes already exist for a tenant or account scope.

[API Reference: List funding endpoints (GET)](/docs/api/reference/funding-endpoints/funding-endpoints-list)

**Request URL — GET**
```http
GET https://business-api.youhodler.com/funding-endpoints?account_ref=client-accounts/aaa111&rail_class=crypto&page_size=20
```
**200 Funding Endpoints**

```json
{
  "items": [
    {
      "account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "asset": "USDC",
      "created_at": "2026-05-01T10:00:00Z",
      "crypto_routing": {
        "asset": "USDC",
        "endpoint": {
          "address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
          "memo": null
        },
        "network": "ethereum"
      },
      "fiat_rail": null,
      "fiat_routing": null,
      "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "network": "ethereum",
      "rail_class": "crypto",
      "status": "active",
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "next_page_token": null
}
```

### List deposit instructions

Readable deposit coordinates. Read deposit instructions after endpoint provisioning when an operator or external system needs the actual inbound coordinates.

[API Reference: List deposit instructions (GET)](/docs/api/reference/deposit-instructions/deposit-instructions-list)

**Request URL — GET**
```http
GET https://business-api.youhodler.com/deposit-instructions?account_ref=client-accounts/aaa111&rail_class=crypto
```
**200 Deposit Instructions**

```json
{
  "items": [
    {
      "account_ref": "client-accounts/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "asset": "USDC",
      "created_at": "2026-05-01T10:00:00Z",
      "crypto_routing": {
        "asset": "USDC",
        "endpoint": {
          "address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
          "memo": null
        },
        "network": "ethereum"
      },
      "expires_at": null,
      "fiat_routing": null,
      "funding_endpoint_id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "rail_class": "crypto",
      "updated_at": "2026-05-01T10:00:00Z"
    }
  ],
  "next_page_token": null
}
```

### Create withdrawal destination

Reusable outbound target. Create a withdrawal destination when later settlement or operational cash-out should point at a named, reusable destination resource.

[API Reference: Create withdrawal destination (POST)](/docs/api/reference/withdrawal-destinations/withdrawal-destinations-create)

**Request URL — POST**
```http
POST https://business-api.youhodler.com/withdrawal-destinations
```
**Request Body — application/json**
```json
{
  "crypto_routing": {
    "asset": "USDC",
    "destination": {
      "address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
      "memo": null
    },
    "label": "My ETH wallet",
    "network": "ethereum"
  },
  "rail_class": "crypto",
  "scope_ref": "clients/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b"
}
```
**201 Destination Created**

```json
{
  "asset": "USDC",
  "created_at": "2026-05-01T10:00:00Z",
  "crypto_routing": {
    "asset": "USDC",
    "destination": {
      "address": "0xAbCd1234567890AbCd1234567890AbCd12345678",
      "memo": null
    },
    "label": "My ETH wallet",
    "network": "ethereum"
  },
  "fiat_routing": null,
  "id": "b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
  "label": "My ETH wallet",
  "rail_class": "crypto",
  "scope_ref": "clients/b8e2f1a0-4c3d-4e5f-9a1b-2c3d4e5f6a7b",
  "status": "active",
  "updated_at": "2026-05-01T10:00:00Z"
}
```