SDQ (Care Module)

SDQ

The Strengths and Difficulties Questionnaire (SDQ) is a 25-item screening tool scored across five dimensions. Three respondents fill it out per student: TEACHER, PARENT, and STUDENT. All queries require authentication and are scoped to your school.

The SDQ surface is read-only — this API exposes only template, student list, and scored result queries. Answers are captured through the care application.

Respondent Types

RespondentType is a GraphQL enum with three values:

Scoring Dimensions

For dimensions 1–4: score > threshold → PROBLEM, score == threshold → RISK, otherwise NORMAL. Each dimension returns NOT_ASSESSED until all five of its questions are answered.

For PROSOCIAL: score > 3 → STRENGTH, else NO_STRENGTH (Prosocial is inverted — a high score is a strength, not a risk).

Total score = sum of dimensions 1–4 only (Prosocial is excluded from the total).

Get SDQ Template

Return the template, all 25 questions in order, and the answer choices for each question. Response is cached in-memory for 60 minutes.

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

List Students with Completion Status

Return students in your school with per-respondent completion counts. Defaults to the active academic year when no academicYearId or semesterId is provided.

query {
  sdqStudents(classroomId: 42, status: "progress", limit: 50) {
    studentId
    code
    title
    firstname
    lastname
    classroomName
    orderNumber
    teacherDone
    parentDone
    studentDone
    teacherAnswered
    parentAnswered
    studentAnsweredCount
  }
}

Parameters

Status Filter Semantics

Get Scored Result

SDQ scores are exposed as a nested field on Student. Use the top-level student(id) query (which is school-scoped) and select the sdq field. This returns one entry per respondent (TEACHER, PARENT, STUDENT) in a single call.

# Defaults to the active semester for the caller's school
query {
  student(id: 12345) {
    id
    fullName
    classroomName
    sdq {
      respondent
      totalScore
      totalAnswered
      totalLevel
      totalLevelText    # e.g. "ปกติ"
      dimensions {
        name
        nameText        # e.g. "ด้านอารมณ์"
        score
        answeredCount
        level
        levelText       # e.g. "ปกติ" / "เสี่ยง" / "มีปัญหา" / "มีจุดแข็ง"
      }
    }
  }
}

Pass semesterId explicitly to score a different semester:

query {
  student(id: 12345) {
    sdq(semesterId: 78) {
      respondent
      totalLevel
      totalScore
    }
  }
}

Student.sdq

Returns [SdqRespondentResult!]! — always three entries, one for each respondent. Respondents with no answers appear with totalLevel: NOT_ASSESSED; respondents who answered some but fewer than 20 questions appear with totalLevel: PARTIAL.

Example: Combined list + nested SDQ

Because sdq is a field on Student, you can fetch scores for many students in one round-trip by nesting it under students():

query {
  students(limit: 5, search: "ณัฏฐรินทร์") {
    id
    fullName
    classroomName
    sdq(semesterId: 1448) {
      respondent
      totalLevel
      totalScore
    }
  }
}

SdqRespondentResult

SdqDimension

Errors

All queries return a GraphQL error with these codes when validation fails: