---
title: "List locate orders"
method: GET
path: "/accounts/{account_id}/locate-orders"
tags: ["Locates"]
---

# List locate orders

`GET /accounts/{account_id}/locate-orders`

## Request

- Base URL: `https://api.clearstreet.io/studio/v2`
- URL: `https://api.clearstreet.io/studio/v2/accounts/{account_id}/locate-orders`
- Auth: HTTP bearer

List all locate orders

## Path parameters

- `account_id` string, required: Account ID for the account.

## Response `200`

Successful response

- object
  - `data` LocateOrder[], required
    - `locate_order_id` string, required: Unique locate ID assigned by us.
    - `requested_at` integer, required: Milliseconds since epoch.
    - `updated_at` integer, required: Milliseconds since epoch.
    - `mpid` string, required: Unique MPID assigned by us.
    - `account_id` string, required: Account ID for the account.
    - `account_number` string, required: Account number for the account.
    - `symbol` string, required
    - `status` 'pending' | 'offered' | 'filled' | 'rejected' | 'declined' | 'expired' | 'cancelled', required: The status of the locate order.
    - `requested_quantity` string, required: String representation of quantity.
    - `locate_id` string: Unique locate ID assigned by us.
    - `located_at` integer: Milliseconds since epoch.
    - `expires_at` integer: Milliseconds since epoch.
    - `borrow_rate` string: String representation of a rate.
    - `located_quantity` string: String representation of quantity.
    - `total_cost` string: String representation of a price.
    - `desk_comment` string: Comment from the desk.
    - `trader_comment` string: Comment from the trader.
    - `reference_id` string: An ID that you provide.

## Other responses

- `default`: Error response

## Changes

- **2024-12-09** `507601d53317`: 1 info
  - added the required property `data/items/account_number` to the response with the `200` status

[Operation history](https://skmtc.dev/clear-street/apis/common-api-models/changes/accounts/:account_id/locate-orders/get.md)

---

[API](https://skmtc.dev/clear-street/apis/common-api-models.md) - [All operations](https://skmtc.dev/clear-street/apis/common-api-models/llms.txt) - [OpenAPI document](https://skmtc.dev/clear-street/apis/common-api-models/revisions/585e71254e37?raw)