# 6. Place an Order

With an active account, you can place fund orders. First, find a fund to invest in.

## Browse available instruments

This returns the instruments available for your client, including ISIN codes, pricing, tradability flags, and minimum investment amounts.

## Create a subscription (buy) order

A subscription order purchases fund units for a specified amount. The account must have sufficient cash balance (from a deposit) to cover the order.

The order is created with status `received` and progresses through: `received` → `pending` → `sent` → `settled`.

### Order request schema

```json
{
  "$ref": "#/components/schemas/order_subscription",
  "components": {
    "schemas": {
      "uuid": {
        "$id": "/models/uuid.yaml",
        "title": "UUID",
        "type": "string",
        "example": "49ad7378-121c-4a53-9894-dfd14a7b4877",
        "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
      },
      "executor_ref": {
        "$id": "/models/common/executor_ref.yaml",
        "type": "string",
        "title": "executor reference",
        "description": "SSN of the individual executing the operation. On write operations, validated against the account owner's SSN — requests with a mismatched value are rejected.\n\nThe partner is responsible for verifying the executor's identity (e.g. via BankID) before including this value.\n",
        "example": "197001010003"
      },
      "order_subscription": {
        "$id": "/models/order/order_subscription.yaml",
        "type": "object",
        "description": "subscription order",
        "title": "subscription order",
        "required": [
          "account",
          "instrument",
          "orderType",
          "amount",
          "executorRef"
        ],
        "properties": {
          "orderType": {
            "const": "subscription"
          },
          "account": {
            "$ref": "#/components/schemas/uuid",
            "description": "Account ID"
          },
          "clientRef": {
            "type": "string",
            "description": "Client applied ref",
            "example": "my_order_123"
          },
          "executorRef": {
            "$ref": "#/components/schemas/executor_ref"
          },
          "instrument": {
            "type": "string",
            "example": "US64110L1061USD",
            "description": "Fondo instrument ID"
          },
          "amount": {
            "type": "number",
            "example": 100,
            "description": "The amount to subscribe for.\n"
          }
        }
      }
    }
  }
}
```

## Validate before submitting

Add `?validate-only` to dry-run the order without creating it. The request body is the same — Fondo validates the order and returns errors without creating it.

The response may contain an array of validation errors describing what failed.

**Next:** [Withdrawals](/guides/api-guide/getting-started/withdrawals)