NextSchoolNextSchool Data API

EQ (Care Module)

Emotional Quotient assessment — template, student list, and scored result nested on Student

EQ

The EQ (แบบประเมินความฉลาดทางอารมณ์) is a 52-item emotional intelligence questionnaire. Unlike SDQ, EQ is student-only — there is no teacher or parent respondent.

All queries require authentication and are school-scoped. The EQ surface is read-only — this API exposes template, student list, and scored result queries. Answers are captured through the care application.

Scoring

The 52 questions roll up into 9 sub-dimensions grouped into the classic Thai EQ triad of ดี (GOOD), เก่ง (SMART), and สุข (HAPPY).

GroupDimensionNORMAL rangeThai name
GOOD (ดี)SELF_CONTROL13 – 18ควบคุมตนเอง
GOOD (ดี)EMPATHY16 – 21เห็นใจผู้อื่น
GOOD (ดี)RESPONSIBILITY17 – 23รับผิดชอบ
SMART (เก่ง)MOTIVATION15 – 21มีแรงจูงใจ
SMART (เก่ง)DECISION_MAKING14 – 20ตัดสินใจและแก้ปัญหา
SMART (เก่ง)RELATIONSHIP15 – 20สัมพันธภาพ
HAPPY (สุข)SELF_ESTEEM9 – 14ภูมิใจตนเอง
HAPPY (สุข)LIFE_SATISFACTION16 – 22พอใจชีวิต
HAPPY (สุข)INNER_PEACE15 – 22สุขสงบทางใจ

For every dimension:

ScoreLevelThai
< normalMinLOWต่ำกว่าเกณฑ์
normalMin ≤ score ≤ normalMaxNORMALเกณฑ์ปกติ
> normalMaxHIGHสูงกว่าปกติ
no answersNOT_ASSESSEDยังไม่ประเมิน

Get EQ Template

Returns the template row and all 52 questions in order with their answer choices. Cached 60 minutes in-process.

query {
  eqTemplate {
    id
    name
    questions {
      id
      orderNumber
      questionText
      answers {
        id
        answerText
        answerPoint
      }
    }
  }
}

List Students with Completion Status

query {
  eqStudents(classroomId: 42, status: "progress", limit: 50) {
    studentId
    code
    title
    firstname
    lastname
    classroomName
    orderNumber
    answered
    done
  }
}

Parameters

ParameterTypeDefaultDescription
academicYearIdIntactive yearScope results to a specific academic year
semesterIdIntScope to a single semester (overrides academicYearId)
classroomIdIntFilter to one classroom
statusStringallcompleted | progress | not_started | all
limitInt50Maximum number of rows
offsetInt0Number of rows to skip

Get Scored Result (nested on Student)

Use the top-level student(id) query (school-scoped) and select the eq field. If semesterId is omitted, the active semester for the caller school is used. Duplicate answers for the same question are deduped automatically.

query {
  student(id: 12345) {
    id
    fullName
    eq {
      totalScore
      totalAnswered
      dimensions {
        name
        nameText       # e.g. "ควบคุมตนเอง"
        group          # GOOD | SMART | HAPPY
        groupText      # "ดี" | "เก่ง" | "สุข"
        score
        answeredCount
        level          # LOW | NORMAL | HIGH | NOT_ASSESSED
        levelText      # "ต่ำกว่าเกณฑ์" | "เกณฑ์ปกติ" | "สูงกว่าปกติ" | "ยังไม่ประเมิน"
      }
      answers {
        questionId
        orderNumber
        questionText
        answerText
        answerPoint
      }
    }
  }
}

Student.eq

ArgumentTypeDescription
semesterIdIntOptional. Defaults to the active semester for the caller school.

Returns EqResult — a wrapper containing the nine dimension scores, a total, and the deduped raw answers.

EqResult

FieldTypeDescription
dimensions[EqDimension!]!All 9 sub-dimensions in stable canonical order
totalScoreFloatSum of every dimension score
totalAnsweredIntCount of answered questions across every dimension
answers[EqAnswer!]!Raw answers ordered by orderNumber (deduped by question)

EqDimension

FieldTypeDescription
nameEqDimensionNameEnum — e.g. SELF_CONTROL, INNER_PEACE
nameTextStringThai name (e.g. ควบคุมตนเอง)
groupEqGroupGOOD | SMART | HAPPY
groupTextString"ดี" / "เก่ง" / "สุข"
scoreFloatRaw summed score for this dimension
answeredCountIntNumber of answered questions in this dimension
levelEqLevelLOW | NORMAL | HIGH | NOT_ASSESSED
levelTextStringThai label for the level

EqAnswer

FieldTypeDescription
questionIdIntQuestion identifier
orderNumberInt1-based position in the template
questionTextStringThai question text
answerIdIntChosen answer identifier
answerTextStringThai answer text
answerPointFloatRaw score for the chosen answer

Errors

CodeCause
UNAUTHENTICATEDNo valid JWT or API key
FORBIDDENJWT has no schoolId
NOT_FOUNDStudent not found in your school, EQ template missing, or no active semester when semesterId is omitted

On this page