Skip to main content
GET
/
api
/
enrollments
curl -X GET "https://api.athena-erp.com/api/enrollments?page=1&page_size=20&status=active" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "total": 156,
  "page": 1,
  "page_size": 20,
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "school_id": "550e8400-e29b-41d4-a716-446655440000",
      "student_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "school_year_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "grade_level": "10°",
      "group_code": "A",
      "shift": "morning",
      "status": "active",
      "status_history": [
        {
          "status": "pending_documents",
          "changed_at": "2024-01-15T10:30:00Z",
          "changed_by": "d4e5f6a7-b8c9-0123-def1-234567890123"
        },
        {
          "status": "active",
          "changed_at": "2024-01-20T14:25:00Z",
          "changed_by": "d4e5f6a7-b8c9-0123-def1-234567890123"
        }
      ],
      "simat_status": {},
      "extra_data": {},
      "student_name": "Juan Pérez García",
      "school_year_name": "2024",
      "documents": [],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:25:00Z"
    }
  ]
}

Query Parameters

school_year_id
uuid
Filter enrollments by school year ID
grade_level
string
Filter enrollments by grade level (partial match supported)
Search by student name, document number, or enrollment ID
status
string
Filter enrollments by status (e.g., “pending_documents”, “active”, “completed”)
page
integer
default:"1"
Page number for pagination (minimum: 1)
page_size
integer
default:"20"
Number of items per page (minimum: 1, maximum: 100)

Response

total
integer
Total number of enrollments matching the filters
page
integer
Current page number
page_size
integer
Number of items per page
items
array
Array of enrollment objects
curl -X GET "https://api.athena-erp.com/api/enrollments?page=1&page_size=20&status=active" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
  "total": 156,
  "page": 1,
  "page_size": 20,
  "items": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "school_id": "550e8400-e29b-41d4-a716-446655440000",
      "student_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "school_year_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "grade_level": "10°",
      "group_code": "A",
      "shift": "morning",
      "status": "active",
      "status_history": [
        {
          "status": "pending_documents",
          "changed_at": "2024-01-15T10:30:00Z",
          "changed_by": "d4e5f6a7-b8c9-0123-def1-234567890123"
        },
        {
          "status": "active",
          "changed_at": "2024-01-20T14:25:00Z",
          "changed_by": "d4e5f6a7-b8c9-0123-def1-234567890123"
        }
      ],
      "simat_status": {},
      "extra_data": {},
      "student_name": "Juan Pérez García",
      "school_year_name": "2024",
      "documents": [],
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:25:00Z"
    }
  ]
}

Permissions Required

  • read:enrollment
  • read:all

Query Parameters

school_year_id
string

Filter enrollments by school year ID

grade_level
string

Filter enrollments by grade level (partial match supported)

Search by student name, document number, or enrollment ID

status
string

Filter enrollments by status (e.g., “pending_documents”, “active”, “completed”)

page
integer

Page number for pagination (minimum: 1)

page_size
integer

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

Response

200 - application/json

Response 200

total
integer

Total number of enrollments matching the filters

page
integer

Current page number

page_size
integer

Number of items per page

items
object[]

Array of enrollment objects

Build docs developers (and LLMs) love