---
title: "Listar alunos da escola"
method: GET
path: "/alpaclass/v1/producer/teams/:teamId/students"
tags: ["Alpaclass"]
---

# Listar alunos da escola

`GET /alpaclass/v1/producer/teams/:teamId/students`

## Request

- Base URL: `https://api.eduzz.com`
- URL: `https://api.eduzz.com/alpaclass/v1/producer/teams/:teamId/students`
- Auth: OAuth 2
  - Implicit: `https://accounts.eduzz.com/oauth/authorize`
  - Scopes: `alpaclass_student_read`
- TypeScript: <https://skmtc.dev/eduzz/apis/eduzz-public-api/docs/alpaclass/v1/producer/teams/:teamId/students/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `teamId` string, required: Id da escola

## Query parameters

- `page` number: Página atual
- `itemsPerPage` number: Número máximo de itens por página
- `sort` string: Ordenação dos itens podendo ter várias ordenações, seguindo o seguinte padrão: campo:ordenação Ex.: name:asc,email:desc
- `id` string: Id do aluno
- `email` string: E-mail do aluno
- `document` string: Documento do aluno
- `startDate` string, date-time: Data de início do cadastro dos alunos
- `endDate` string, date-time: Data de fim do cadastro dos alunos
- `isFrozen` boolean: Status de congelamento do aluno

## Response `200`

Listar alunos da escola

- object
  - `pages` number, required: Número de páginas
  - `page` number, required: Página atual
  - `itemsPerPage` number, required: Número máximo de itens por página
  - `totalItems` number, required: Número total de items
  - `items` object[], required: Alunos da escola
    - `id` string, required: Id do aluno
    - `name` string, required: Nome do aluno
    - `email` string, required: Email do aluno
    - `createdAt` string, date-time, required: Data de criação do aluno

## Changes

- **2026-10-26** `f93320e6a417`: 9 info
  - the `query` request parameter `document` became optional
  - the `query` request parameter `email` became optional
  - the `query` request parameter `endDate` became optional
  - the `query` request parameter `id` became optional
  - …5 more
- **2026-10-10** `8e41c62b53a8`: 16 breaking
  - the `query` request parameter `document` became required
  - the `query` request parameter `email` became required
  - the `query` request parameter `endDate` became required
  - the `query` request parameter `id` became required
  - …12 more
- **2026-04-19** `5abec7e14710`: 9 warning, 9 info
  - deleted the `query` request parameter `0`
  - deleted the `query` request parameter `1`
  - deleted the `query` request parameter `2`
  - deleted the `query` request parameter `3`
  - …14 more
- **2026-01-22** `e11d279eea68`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/eduzz/apis/eduzz-public-api/changes/alpaclass/v1/producer/teams/:teamId/students/get.md)

---

[API](https://skmtc.dev/eduzz/apis/eduzz-public-api.md) - [All operations](https://skmtc.dev/eduzz/apis/eduzz-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eduzz/apis/eduzz-public-api/revisions/5d05c72e5bf5?raw)