> ## Documentation Index
> Fetch the complete documentation index at: https://getequity.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List your bids

> Every bid you have placed, with its outcome

Your organisation's commitments across every offering. Bids survive settlement carrying their
outcome, so this stays useful after a deal closes — it is what you reconcile against.

**status** `string`

Filter to one commitment status.

**page** `integer`

Defaults to 1.

**limit** `integer`

Max 100.

```json theme={null}
{
  "status": "success",
  "message": "Commitments fetched successfully",
  "data": {
    "docs": [
      {
        "_id": "68f1c1a3e1b2c3d4e5f60615",
        "token": "68f1c2a4e1b2c3d4e5f60718",
        "amount": 5000000,
        "bid_rate": 19,
        "tranche": "retail",
        "status": "PARTIALLY_ALLOTTED",
        "allotted_amount": 4000000,
        "allotted_units": 400,
        "allotted_rate": 19,
        "refund_amount": 1000000
      }
    ],
    "page": 1,
    "totalDocs": 1
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.