Skip to main content

Basic node queries

Fetch lessons by grade level

query {
  lessons(where: { gradeLevel_INCLUDES: "K" }, limit: 10) {
    identifier
    name
    gradeLevel
    courseCode
    timeRequired
  }
}

Relationship queries

Find activities and their materials

query {
  activities(limit: 5) {
    identifier
    name
    hasPartMaterials {
      identifier
      name
      materialType
      content
    }
  }
}

Get educational alignments

query {
 lessons(limit: 3) {
   identifier
   name
   hasEducationalAlignmentStandardsFrameworkItems {
     identifier
     description
     gradeLevel
   }
 }
}

Advanced filtering

Multiple grade levels

query {
  lessons(where: { 
    gradeLevel_INCLUDES: "K"
  }, limit: 10) {
    identifier
    name
    gradeLevel
  }
}

Filter by subject and author

query {
  courses(where: { 
    academicSubject: "Mathematics",
    author_CONTAINS: "Illustrative Mathematics"
  }, limit: 5) {
    identifier
    name
    author
    academicSubject
  }
}

Illustrated Math (IM) curriculum course level queries

List all courses in IM

Return all IM courses in the Knowledge Graph.
{ courses(where: { author: "Illustrative Mathematics" }) { name identifier gradeLevel } }

List all units in a course

Get all units for Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { curriculumLabel: "Unit" }) { ordinalName name identifier } } }

List all sections in a course

Return all sections for each Unit in grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { curriculumLabel: "Unit" }) { ordinalName hasPartLessonGroupings(where: { curriculumLabel: "Section" }) { ordinalName name identifier } } } }

List all lessons in a course

Return all lessons for each section of each unit in Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { curriculumLabel: "Unit" }) { ordinalName hasPartLessonGroupings(where: { curriculumLabel: "Section" }) { ordinalName hasPartLessons { ordinalName name identifier } } } } }

List all instructional routines in a course

Return all instructional routines used in Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { usesRoutineInstructionalRoutines { name identifier } } }

List all common core math standards (CCSS) aligned to a course

Return all CCSS math standards that have educational alignment with Grade 6.
{ courses( where: { name: "Grade 6" author: "Illustrative Mathematics" } ) { hasEducationalAlignmentStandardsFrameworkItemsConnection( where: { node: { statementType: "Standard" } } ) { edges { properties { curriculumAlignmentType } node { statementCode description identifier } } } } }

Get the course guide for a course

Return course guide information for grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartMaterials(where: { name: "Course Guide" }) { identifier content } } }

Get the course by the course ID

Return metadata and content for the course ID [xxxxx].
{ courses(where: { author: "Illustrative Mathematics", identifier: "im:01dac62a-f836-5da5-bae4-1df14f1dfa8f" }) { name courseCode hasPartMaterials { content } } }

IM unit-level queries

List all sections in a unit

Return all sections for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1", curriculumLabel: "Unit" }) { hasPartLessonGroupings(where: { curriculumLabel: "Section" }) { ordinalName name identifier } } } }

List all lessons in a unit

Return all lessons for each Section for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1", curriculumLabel: "Unit" }) { hasPartLessonGroupings(where: { curriculumLabel: "Section" }) { ordinalName hasPartLessons { ordinalName name identifier } } } } }

List all common core math standards aligned to a unit

Return all the CCSS math standards that have educational alignment with Unit 1 of Grade 6.
{ courses( where: { name: "Grade 6" author: "Illustrative Mathematics" } ) { hasPartLessonGroupings( where: { ordinalName: "Unit 1" curriculumLabel: "Unit" } ) { hasEducationalAlignmentCfItemsConnection( where: { node: { CASE_CFItemType: "Standard" } } ) { edges { properties { curriculumAlignmentType } node { CASE_humanCodingScheme CASE_fullStatement identifier } } } } } }

List the prerequisite units for a unit

Return the prerequisite units for Unit 1 of Grade 6.
{ lessonGroupings(where: { ordinalName: "Unit 1", courseCode: "im360:6" }) { lessonGroupingshasDependency { ordinalName name identifier } } }

List the dependent units for a unit

Return units depending on Unit 1 of Grade 6.
{ lessonGroupings(where: { ordinalName: "Unit 1", courseCode: "im360:6" }) { hasDependencyLessonGroupings { ordinalName name identifier } } }

Get the family materials of a unit

Return the family material information for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartMaterials(where: { name_CONTAINS: "Family Materials" }) { name identifier content } } } }

Get the unit overview of a unit

Return the unit overview information for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartMaterials(where: { name_CONTAINS: "Overview" }) { name identifier } } } }

List the end-of-unit assessments of a unit

Return the end-of-unit assessments for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartAssessments(where: { curriculumLabel_CONTAINS: "End-of-Unit" }) { name identifier } } } }

List the Check Your Readiness assessments for a unit

Return the Check Your Readiness assessments for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartAssessments(where: { curriculumLabel_CONTAINS: "Check Your Readiness" }) { name identifier } } } }

List the mid-unit assessments of a unit

Return the mid-unit assessments for Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartAssessments(where: { curriculumLabel_CONTAINS: "Mid-Unit" }) { name identifier } } } }

List the glossary terms referenced by a unit

Return the glossary terms referenced by Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings { hasPartLessons { referencesGlossaryTerms { name description identifier } } } } } }

Get the unit by unit ID

Return metadata and content for the unit ID [xxxxx].
{ lessonGroupings(where: { identifier: "im:a0e15ae9-dd70-5df0-93ad-9d6b99fc5ad2" }) { name ordinalName hasPartMaterials { content } } }

IM section-level queries

List all lessons in a section

Return all lessons for Section A of Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1", curriculumLabel: "Unit" }) { hasPartLessonGroupings(where: { ordinalName: "Section A", curriculumLabel: "Section" }) { hasPartLessons { ordinalName name identifier } } } } }

List all common core math standards aligned to a section

Get all the CCSS math standards that have educational alignment with Section A of Unit 1 of Grade 6.
{ courses( where: { name: "Grade 6", author: "Illustrative Mathematics" } ) { hasPartLessonGroupings( where: { ordinalName: "Unit 1", curriculumLabel: "Unit" } ) { hasPartLessonGroupings( where: { ordinalName: "Section A", curriculumLabel: "Section" } ) { hasEducationalAlignmentStandardsFrameworkItemsConnection( where: { node: { statementType: "Standard" } } ) { edges { properties { curriculumAlignmentType } node { statementCode description identifier } } } } } } }

Get the section narrative of a section

Return the section narrative information for section A of unit 1 of grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartMaterials { name identifier content } } } } }

List the section checkpoint assessment of a section

Return the section checkpoint assessment for Section A of Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6", author: "Illustrative Mathematics" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartAssessments(where: { curriculumLabel_CONTAINS: "Checkpoint" }) { name identifier } } } } }

Get the section-by-section ID

Return metadata and content for the section ID [xxxxx].
{ lessonGroupings(where: { identifier: "im:0908dab1-c834-5194-947b-492a1348a403" }) { identifier name ordinalName hasPartMaterials { content } } }

IM lesson-level queries

List all activities of a lesson

Return all activities that are part of lesson 1, section A, unit 1 of grade 6.
{ courses(where: { name: "Grade 6" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { hasPartActivities { name identifier } } } } } }

List all cool-down assessments in a lesson

Get cool-down assessments of Lesson 1, Section A, Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { hasPartAssessments(where: { curriculumLabel: "Cool-down" }) { name identifier } } } } } }

List all practice problems in a lesson

Get practice problems of Lesson 1, Section A, Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { hasPartAssessments(where: { curriculumLabel: "Practice Problems" }) { name identifier } } } } } }

List all classroom materials used in a lesson

Get all classroom materials used in Lesson 1, Section A, Unit 1 of Grade 3.
{ courses(where: { name: "Grade 3" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { usesClassroomMaterials { name identifier description } } } } } }

List all glossary terms referenced by a lesson

Return all glossary terms referenced in Lesson 1, Section A, Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { referencesGlossaryTerms { name description identifier } } } } } }

List all standards aligned to a lesson

Return all common core standards educationally aligned with Lesson 1, Section A, Unit 1 of Grade 6.
{ courses(where: { name: "Grade 6" }) { hasPartLessonGroupings(where: { ordinalName: "Unit 1" }) { hasPartLessonGroupings(where: { ordinalName: "Section A" }) { hasPartLessons(where: { ordinalName: "Lesson 1" }) { hasEducationalAlignmentStandardsFrameworkItems { identifier description statementCode statementType } } } } } }

Get the lesson-by-lesson ID

Return metadata and content for the lesson ID [xxxxx].
{ lessons(where: { author: "Illustrative Mathematics", identifier: "im:3ac685eb-79b3-5c19-952e-c1a71a5017e9" }) { name courseCode hasPartMaterials { content } } }

IM activity-level queries

List all instructional routines in an activity
”Which routines are used in activity ID [xxxxx]?”
{ activities(where: { identifier: "im:44adb838-f550-5efc-a875-6a991b52b7ae" }) { usesRoutineInstructionalRoutines { name identifier description } } }
List all common core math standards aligned to an activity
”Return all common core standards educationally aligned with Activity ID [xxxxx]“
{ activities(where: { identifier: "im:44adb838-f550-5efc-a875-6a991b52b7ae" }) { hasEducationalAlignmentStandardsFrameworkItems { identifier description statementCode statementType } } }

Get the activity by its activity ID

Return metadata and content for the activity ID [xxxxx].
{ activities(where: { identifier: "im:44adb838-f550-5efc-a875-6a991b52b7ae" }) { name ordinalName hasPartMaterials { identifier content } } }

Academic standard query patterns

List all standards documents

Return all standard documents available in the Knowledge Graph.
{ standardsFrameworks { identifier name } }

Find documents by subject or state

Return all Math standards documents from California.
{ standardsFrameworks(where: { academicSubject: "Mathematics", jurisdiction: "California" }) { identifier name } }

Get document by document ID

Return standards document with identifier [xxxxx].
{ standardsFrameworks(where: { identifier: "2d08331b-3769-5b2b-981c-52b03c5e73d1" }) { identifier name } }

Get all standards in a document

Return all standards that are part of a standard document ID [xxxxx].
{ standardsFrameworks(where: { identifier: "2d08331b-3769-5b2b-981c-52b03c5e73d1" }) { hasChildStandardsFrameworkItems { identifier description statementType statementCode } } }

List child standards for a standard

Return all standards that are children of standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "ef129d7a-3f29-58ed-80e3-ba5186af5872" }) { hasChildStandardsFrameworkItems { identifier description statementCode } } }

Get the parent standard for a standard

Return the immediate parent standard of standard ID [xxxxx].
{ standardsFrameworkItems(where: { hasChildStandardsFrameworkItems_SOME: { identifier: "ef129d7a-3f29-58ed-80e3-ba5186af5872" } }) { identifier description statementCode } }

Get the standard-by-standard code

Return content and metadata for standard code ‘7.G.A.1.”
{ standardsFrameworkItems(where: { statementCode: "7.G.A.1" }) { identifier description statementType } }

Get a standard-by-standard ID

Return content and metadata for standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "ef129d7a-3f29-58ed-80e3-ba5186af5872" }) { identifier description statementType statementCode } }

Get standards for a grade

Return all math standards from grade level 6.
{ standardsFrameworkItems(where: { gradeLevel_INCLUDES: "6", academicSubject: "Mathematics" }) { identifier statementCode description } }

Learning progression query patterns

List standards that build toward a standard

Return all standards that build toward standard 6.NS.B.3.
{ standardsFrameworkItems( where: { buildsTowardsStandardsFrameworkItems_SOME: { statementCode: "6.NS.B.3" } } ) { identifier statementCode description } }
Return all standards that relate to standard 6.NS.B.3.
{ standardsFrameworkItems( where: { relatesToStandardsFrameworkItems_SOME: { statementCode: "5.NBT.B.7" } } ) { identifier statementCode description } }

Learning Component Queries

List all learning components

Return a list of all learning components in Knowledge Graph.
{ learningComponents { identifier description academicSubject } }

Get learning component by ID

Return a learning component that matches the ID [xxxxx].
{ learningComponents(where: { identifier: "4219c4aa-da1f-5f0f-bca8-0482f1d5a02b" }) { identifier description academicSubject } }

Standards + curriculum query patterns

List all courses aligned to a specific standard

Return the courses aligned with standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "62508493-c9ae-5c4a-b317-94d80fe6d775" }) { courseshasEducationalAlignment { name identifier } } }

List all units aligned to a specific standard

Return the units aligned with standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "62508493-c9ae-5c4a-b317-94d80fe6d775" }) { lessonGroupingshasEducationalAlignment(where: { curriculumLabel: "Unit" }) { name ordinalName identifier } } }

List all sections aligned to a specific standard

Return the sections aligned with standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "62508493-c9ae-5c4a-b317-94d80fe6d775" }) { lessonGroupingshasEducationalAlignment(where: { curriculumLabel: "Section" }) { name ordinalName identifier } } }

List all lessons aligned to a specific standard

Return the lessons are aligned with standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "62508493-c9ae-5c4a-b317-94d80fe6d775" }) { lessonshasEducationalAlignment { name ordinalName identifier } } }

List all activities aligned to a specific standard

Return the activities are aligned with the standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "62508493-c9ae-5c4a-b317-94d80fe6d775" }) { activitieshasEducationalAlignment { name ordinalName identifier } } }

List all assessments aligned to a specific standard

Return the assessments aligned with standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "6998c1e0-d5d3-5f9b-9bb6-f167772a499f" }) { assessmentshasEducationalAlignment { name identifier } } }

Learning component + standards query patterns

List all learning components in a grade

Return all learning components that support all standards from Grade 6.
{ standardsFrameworkItems(where: { gradeLevel_INCLUDES: "6" }) { learningComponentssupports { identifier description } } }

List learning components supporting a standard

Return all learning components that support standard ID [xxxxx].
{ standardsFrameworkItems(where: { identifier: "ef129d7a-3f29-58ed-80e3-ba5186af5872" }) { learningComponentssupports { identifier description } } }

List standard(s) supported by a learning component

Return all standards that are supported by learning component ID [xxxxx].
{ learningComponents(where: { identifier: "0013fbee-3e76-500f-9978-42aa1a65f105" }) { supportsStandardsFrameworkItems { identifier description } } }

Learning component, standards, IM curriculum query patterns

List all LCs supporting an IM lesson

Return all learning components that support lesson ID [xxxxx].
{ lessons(where: { identifier: "im:ecf6aa89-0fc9-501c-a4ae-531d9faf8c39" }) { hasEducationalAlignmentStandardsFrameworkItems { learningComponentssupports { identifier description } } } }

Standard crosswalk query patterns

Get all crosswalks

“Return all state to CCSSM standard alignments ordered by Jaccard similarity score.
{
  standardsFrameworkItems {
    statementCode
    jurisdiction
    hasStandardAlignmentStandardsFrameworkItemsConnection {
      edges {
        node {
          statementCode
          jurisdiction
        }
        properties {
          jaccard
          stateLCCount
          ccssLCCount
          sharedLCCount
        }
      }
    }
  }
}

Get crosswalks for a state

Return all crosswalks for Texas standards to CCSSM with full metadata.
{
  standardsFrameworkItems(
    where: {
      jurisdiction: "Texas"
      academicSubject: "Mathematics"
    }
  ) {
    jurisdiction
    statementCode
    gradeLevel
    description
    academicSubject
    hasStandardAlignmentStandardsFrameworkItemsConnection {
      edges {
        node {
          statementCode
          gradeLevel
          description
          academicSubject
        }
        properties {
          jaccard
          sharedLCCount
          stateLCCount
          ccssLCCount
        }
      }
    }
  }
}

Filter crosswalks by similarity threshold

Return all Texas crosswalks with Jaccard score of 0.7 or higher.
{
  standardsFrameworkItems(
    where: {
      jurisdiction: "Texas"
      hasStandardAlignmentStandardsFrameworkItemsConnection_SOME: {
        edge: { jaccard_GTE: 0.7 }
      }
    }
  ) {
    jurisdiction
    statementCode
    hasStandardAlignmentStandardsFrameworkItemsConnection(
      where: { edge: { jaccard_GTE: 0.7 } }
    ) {
      edges {
        node {
          statementCode
        }
        properties {
          jaccard
          sharedLCCount
          stateLCCount
          ccssLCCount
        }
      }
    }
  }
}

Find the best state match for a CCSS standard

Return the top Texas standards that best match CCSS standard ‘6.EE.B.5’ with full metadata.
{
  standardsFrameworkItems(
    where: {
      statementCode: "6.EE.B.5"
      jurisdiction: "Multi-State"
    }
  ) {
    statementCode
    description
    gradeLevel
    jurisdiction
    academicSubject
    standardsFrameworkItemshasStandardAlignmentConnection(
      where: { node: { jurisdiction: "Texas" } }
    ) {
      edges {
        node {
          statementCode
          description
          gradeLevel
          jurisdiction
          academicSubject
        }
        properties {
          jaccard
          sharedLCCount
          stateLCCount
          ccssLCCount
        }
      }
    }
  }
}

Learner variability navigator (LVN) queries

List all learner models

Return all learner models available in the Knowledge Graph.
{
  learnerModels {
    identifier
    name
    description
    academicSubject
    gradeLevel
  }
}

Get factors for a learner model

Return all factors associated with the ‘Portrait of a Learner 4-8’ learner model.
{
  learnerModels(where: { name: "Portrait of a Learner 4-8" }) {
    name
    identifier
    description
    hasFactorFactors {
      identifier
      name
      description
      category
      gradeLevel
    }
  }
}

Get strategies for a learner model

Return all strategies associated with the ‘Portrait of a Learner 4-8’ learner model.
{
  learnerModels(where: { name: "Portrait of a Learner 4-8" }) {
    name
    identifier
    description
    hasStrategyStrategies {
      identifier
      name
      description
      category
      gradeLevel
    }
  }
}

Get factors that interact with a specific factor

Return all factors that interact with ‘Working Memory’ factor from Building Math 3-6.
{
  factors(where: { identifier: "9501e48b-c985-501f-84ad-98c3f271e322" }) {
    name
    identifier
    description
    category
    gradeLevel
    academicSubject
    interactsWithFactorFactors {
      identifier
      name
      description
      category
      gradeLevel
    }
  }
}

View all strategies that target a specific factor

Return all strategies that target ‘Working Memory’ factor from Building Math 3-6.
{
  factors(where: { identifier: "9501e48b-c985-501f-84ad-98c3f271e322" }) {
    name
    identifier
    category
    gradeLevel
    academicSubject
    strategiestargetsFactorConnection {
      edges {
        node {
          name
          category
        }
        properties {
          connectionType
          factorCategory
        }
      }
    }
  }
}

View all standards relevant to a specific factor

Return all standards that are relevant to ‘Algebraic Thinking’ factor.
{
  factors(where: { name: "Algebraic Thinking" }) {
    name
    identifier
    category
    relevantToStandardStandardsFrameworkItems {
      statementCode
      description
      gradeLevel
      jurisdiction
      academicSubject
    }
  }
}