> ## 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.

<ParamField query="status" type="string">Filter to one commitment status.</ParamField>
<ParamField query="page" type="integer">Defaults to 1.</ParamField>
<ParamField query="limit" type="integer">Max 100.</ParamField>

<ResponseExample>
  ```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
    }
  }
  ```
</ResponseExample>