# List orders

Returns every order placed under client_id, including both subscriptions and redemptions.
Each order object provides its id, orderType, current status (e.g., received, sent, confirmed, settled), associated account, references (clientRef, executorRef), the targeted instrument, requested units or amount, and full lifecycle timestamps (createdDate, modifiedDate, canceledDate).
Use this endpoint to monitor all fund orders and their progress from initiation through settlement.

Endpoint: GET /v2/partner/client/{client_id}/order
Version: 2.0.0
Security: oAuth

## Query parameters:

  - `start` (string)
    The sortedId to start from. Use for pagination.
    Example: "20240101abcdef"

  - `limit` (number)
    Limit results. Default is none
    Example: 100

  - `modifiedFrom` (string)
    The modifiedDate to start from. Use for reconciliation.
    Example: "2024-01-01T00:00:01.000Z"

## Path parameters:

  - `client_id` (string, required)
    The ID of requested client.
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

## Response 200 fields (application/json):

  - `id` (string)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `status` (any)
    Order status

  - `sortedId` (string)
    ULID (Universally Unique Lexicographically Sortable Identifier)
    Example: "01ARZ3NDEKTSV4RRFFQ69G5FAV"

  - `orderType` (any, required)
    Enum: "subscription", "redemption"

  - `account` (string, required)
    UUID (Universally Unique Identifier)
    Example: "49ad7378-121c-4a53-9894-dfd14a7b4877"

  - `clientRef` (string)
    Client applied ref
    Example: "my_order_123"

  - `executorRef` (string)
    Id or reference to the client placing the order, authorized by power of attorney.

Reference should be SSN of the individual client
    Example: "197001010003"

  - `instrument` (string, required)
    Fondo instrument ID
    Example: "US64110L1061USD"

  - `units` (number, required)
    Number of units. 7 decimals. Required for redemption orders.
    Example: 1000

  - `amount` (number, required)
    For a subscription order, this is the amount to subscribe for. For a redemption order this will be calculated on confirmation.
    Example: 100

  - `createdDate` (string)
    date when created
    Example: "2018-12-13T23:59:00.001Z"

  - `modifiedDate` (string)
    Date when last modified
    Example: "2018-12-13T23:59:00.001Z"

  - `canceledDate` (string)
    Date when canceled
    Example: "2018-12-13T23:59:00.001Z"

## Response 400 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "invalid_request"

  - `error_description` (string)
    Description of error

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "unauthorized"

  - `error_description` (string)
    Description of error

## Response 403 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "forbidden"

  - `error_description` (string)
    Description of error

## Response 500 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "server_error"

  - `error_description` (string)
    Description of error

## Response 503 fields (application/json):

  - `error` (string, required)
    Error code
    Enum: "service_unavailable"

  - `error_description` (string)
    Description of error