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
  }
}

​
IM Curriculum Query Patterns

​
IM 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 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 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 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 of 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 assessment of 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 of 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 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

​
Standard Document-Level Queries

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…” 
{ standardsFrameworks(where: { identifier: "2d08331b-3769-5b2b-981c-52b03c5e73d1" }) { identifier name } }

​
Standard-Level Queries

Get all standards in a document
”Return all standards that are part of 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 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 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 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 Queries

List standards that builds toward a standard
”Return all standards that builds toward standard “6.NS.B.3"" 
{ standardsFrameworkItems( where: { buildsTowardsStandardsFrameworkItems_SOME: { statementCode: "6.NS.B.3" } } ) { identifier statementCode description } }
List standards that are related to a standard
”Return all standards that relates 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 KG” 
{ 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 Queries

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 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 Queries

List all learning components in grade
”Return all learning components that supports all standards from Grade 6” 
{ standardsFrameworkItems(where: { gradeLevel_INCLUDES: "6" }) { learningComponentssupports { identifier description } } }
List learning components supporting a standard
”Return all learning components that supports 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 Queries

List all LCs supporting an IM lesson “Return all learning components that supports lesson ID [xxxxx]“ 
{ lessons(where: { identifier: "im:ecf6aa89-0fc9-501c-a4ae-531d9faf8c39" }) { hasEducationalAlignmentStandardsFrameworkItems { learningComponentssupports { identifier description } } } }

​
Standard Crosswalk Queries

​
Get All Crosswalks

List 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 by State

List all crosswalks for a specific 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
        }
      }
    }
  }
}

​
Get Crosswalks by Jaccard Threshold

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 Best State Match for CCSS Standard

Find best matching state standards 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

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

​
Get Factors for a Learner Model

View all factors of a specific 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

View all strategies of a specific 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 Factor

View all 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
    }
  }
}

​
Get Strategies That Target a Factor

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
        }
      }
    }
  }
}

​
Get Standards Relevant to a Factor

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
    }
  }
}