> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/praveenarya123/sps-backend/llms.txt
> Use this file to discover all available pages before exploring further.

# List fees

> Retrieve all fee records in the system.

Returns an array of all fee records stored in the database.

<Note>
  No authentication is required to call this endpoint.
</Note>

<Info>
  This endpoint returns all fee records without any server-side filtering. To view fees for a specific student, retrieve the full list and filter by `studentId` on the client side.
</Info>

## Response

Returns an array of fee objects.

<ResponseField name="_id" type="string">
  The unique MongoDB ObjectId of the fee record.
</ResponseField>

<ResponseField name="studentId" type="string">
  The MongoDB ObjectId of the student the fee is assigned to.
</ResponseField>

<ResponseField name="amount" type="number">
  The monetary amount of the fee.
</ResponseField>

<ResponseField name="status" type="string">
  The current payment status of the fee (e.g., `PENDING`, `PAID`, `OVERDUE`).
</ResponseField>

<ResponseField name="__v" type="number">
  Internal MongoDB document version key.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url http://localhost:5000/api/finance/list
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "_id": "64c5d8b3e2f1a0b4c5d6e7f8",
      "studentId": "64a1f2c3e4b0d5f6a7b8c9d0",
      "amount": 250,
      "status": "PENDING",
      "__v": 0
    },
    {
      "_id": "64c5d8b3e2f1a0b4c5d6e7f9",
      "studentId": "64a1f2c3e4b0d5f6a7b8c9d2",
      "amount": 500,
      "status": "PAID",
      "__v": 0
    },
    {
      "_id": "64c5d8b3e2f1a0b4c5d6e7fa",
      "studentId": "64a1f2c3e4b0d5f6a7b8c9d3",
      "amount": 175,
      "status": "OVERDUE",
      "__v": 0
    }
  ]
  ```
</ResponseExample>