List Students

Retrieves a paginated list of students enrolled in the school.

Query Parameters

page

integer

default:"1"

Page number for pagination (minimum: 1)

page_size

integer

default:"20"

Number of items per page (minimum: 1, maximum: 100)

string

Search term to filter students by full name or document number (case-insensitive)

grade

string

Filter students by grade level (partial match)

is_active

boolean

default:"true"

Filter by active status. Set to null to retrieve all students regardless of status

Response

Returns a paginated list of students with their associated guardians.

total

integer

Total number of students matching the filters

page

integer

Current page number

page_size

integer

Number of items per page

items

array

Array of student objects

Show Student Object

uuid

Unique identifier for the student

school_id

uuid

School identifier

user_id

uuid

Associated user account ID (if linked)

document_type

string

Type of identification document. Valid values: TI, RC, CC, CE, NUIP, PASSPORT

document_number

string

Identification document number

full_name

string

Student’s full name

birth_date

date

Date of birth in YYYY-MM-DD format

gender

string

Student’s gender

is_active

boolean

Whether the student is currently active

extra_data

object

Additional custom data for the student

piar_data

object

PIAR (Individual Plan for Reasonable Adjustments) data for students with special educational needs

guardians

array

Array of guardian objects associated with this student

Show Guardian Object

uuid

Guardian’s unique identifier

document_type

string

Type of identification document

document_number

string

Identification document number

full_name

string

Guardian’s full name

phone

string

Contact phone number

string

Contact email address

address

string

Physical address

occupation

string

Guardian’s occupation

workplace

string

Guardian’s workplace

is_active

boolean

Whether the guardian record is active

relationship

string

Relationship to the student (e.g., “Father”, “Mother”, “Uncle”)

is_primary

boolean

Whether this is the primary guardian

priority

integer

Contact priority order (minimum: 1)

can_pickup

boolean

Whether this guardian is authorized to pick up the student

is_emergency_contact

boolean

Whether this guardian should be contacted in emergencies

link_id

uuid

Unique identifier for the student-guardian relationship

created_at

datetime

Timestamp when the relationship was created

created_at

datetime

Timestamp when the student was created

updated_at

datetime

Timestamp when the student was last updated

Permissions Required

One of the following permissions:

read:students
read:own_students
read:all

curl -X GET "https://api.athena-erp.com/students?page=1&page_size=20&search=Juan&is_active=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "total": 150,
  "page": 1,
  "page_size": 20,
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "school_id": "123e4567-e89b-12d3-a456-426614174000",
      "user_id": null,
      "document_type": "TI",
      "document_number": "1234567890",
      "full_name": "Juan Pérez García",
      "birth_date": "2010-05-15",
      "gender": "M",
      "is_active": true,
      "extra_data": {},
      "piar_data": {},
      "guardians": [
        {
          "id": "660e8400-e29b-41d4-a716-446655440001",
          "document_type": "CC",
          "document_number": "98765432",
          "full_name": "María García",
          "phone": "+57 300 1234567",
          "email": "[email protected]",
          "address": "Calle 123 #45-67",
          "occupation": "Ingeniera",
          "workplace": "Tech Corp",
          "is_active": true,
          "relationship": "Mother",
          "is_primary": true,
          "priority": 1,
          "can_pickup": true,
          "is_emergency_contact": true,
          "link_id": "770e8400-e29b-41d4-a716-446655440002",
          "created_at": "2024-01-15T10:30:00Z"
        }
      ],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-02-20T14:45:00Z"
    }
  ]
}

Authentication

Enrollments

Students

Academic

Discipline

Communications

Schools

Query Parameters

Response

Permissions Required

Build docs developers (and LLMs) love

Authentication

Enrollments

Students

Academic

Discipline

Communications

Schools

​Query Parameters

​Response

​Permissions Required

Build docs developers (and LLMs) love

Query Parameters

Response

Permissions Required