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

> Retrieve a list of all student records in the system.

Returns an array of all student records stored in the database. No filtering or pagination is applied — all students are returned in a single response.

<Info>
  This endpoint does not require authentication. It is publicly accessible.
</Info>

## Request

This endpoint accepts no request body and no query parameters.

## Response

Returns an array of student objects.

<ResponseField name="" type="object[]" required>
  Array of student records. Each object contains the following fields:

  <Expandable title="Student object properties" defaultOpen>
    <ResponseField name="_id" type="string" required>
      MongoDB-generated unique identifier for the student.
    </ResponseField>

    <ResponseField name="name" type="string">
      Full name of the student.
    </ResponseField>

    <ResponseField name="email" type="string">
      Email address of the student.
    </ResponseField>

    <ResponseField name="class" type="string">
      The class the student is enrolled in.
    </ResponseField>

    <ResponseField name="section" type="string">
      The section within the class.
    </ResponseField>

    <ResponseField name="rollNumber" type="number">
      The student's roll number.
    </ResponseField>

    <ResponseField name="__v" type="number">
      MongoDB internal version key.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://your-api-host/api/student/list
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "_id": "64f1a2b3c4d5e6f7a8b9c0d1",
      "name": "Priya Sharma",
      "email": "priya.sharma@school.edu",
      "class": "10",
      "section": "A",
      "rollNumber": 42,
      "__v": 0
    },
    {
      "_id": "64f1a2b3c4d5e6f7a8b9c0d2",
      "name": "Arjun Mehta",
      "email": "arjun.mehta@school.edu",
      "class": "9",
      "section": "B",
      "rollNumber": 17,
      "__v": 0
    },
    {
      "_id": "64f1a2b3c4d5e6f7a8b9c0d3",
      "name": "Sneha Patel",
      "email": "sneha.patel@school.edu",
      "class": "10",
      "section": "B",
      "rollNumber": 5,
      "__v": 0
    }
  ]
  ```
</ResponseExample>