Ed-Fi RFC 13 - Open API Spec
This page contains the full Open API specification.
Change History
- June 29, 2018: Initial Draft
- Ed-Fi-EnrollmentAPI-RFC13.json
{
"swagger": "2.0",
"info": {
"version": "RFC 13",
"title": "Ed-Fi Enrollment API",
"description": "The RFC describes a set of read-only REST APIs for transfer of basic student and teacher demographic data and enrollment data for K\ufffd12 education. The API is intended to allow source systems to provide the basic data needed to provision a broad range of online teaching and learning applications, and to do so using resource models that align with the Ed-Fi Unifying Data Model 3.0."
},
"produces": [
"application/json"
],
"paths": {
"/ed-fi/enrollment/localEducationAgencies": {
"get": {
"tags": [
"localEducationAgencies"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getLocalEducationAgencies",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "localEducationAgencyId",
"in": "query",
"description": "The identifier assigned to a local education agency.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/localEducationAgency"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/localEducationAgencies/{id}": {
"get": {
"tags": [
"localEducationAgencies"
],
"summary": "Retrieves a specific resource using the resource's identifier (using the \"Get By Id\" pattern).",
"description": "This GET operation retrieves a resource by the specified resource identifier.",
"operationId": "getLocalEducationAgenciesById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/fields"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/localEducationAgency"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/schools": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSchools",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/school"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/schools/{id}": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves a specific resource using the resource's identifier (using the \"Get By Id\" pattern).",
"description": "This GET operation retrieves a resource by the specified resource identifier.",
"operationId": "getSchoolsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/fields"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/school"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/localEducationAgencies/{localEducationAgency_id}/schools": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSchoolsByLocalEducationAgency",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "localEducationAgency_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/school"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/sections/{section_id}/schools": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSchoolsBySection",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "section_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/school"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/staffs/{staff_id}/schools": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSchoolsByStaff",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "staff_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/school"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/students/{student_id}/schools": {
"get": {
"tags": [
"schools"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSchoolsByStudent",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "student_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/school"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/sections": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSections",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "sectionIdentifier",
"in": "query",
"description": "The local identifier assigned to a section.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 255
},
{
"name": "localCourseCode",
"in": "query",
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "schoolYear",
"in": "query",
"description": "The identifier for the school year.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "sessionName",
"in": "query",
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/section"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/sections/{id}": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves a specific resource using the resource's identifier (using the \"Get By Id\" pattern).",
"description": "This GET operation retrieves a resource by the specified resource identifier.",
"operationId": "getSectionsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/fields"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/section"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/localEducationAgencies/{localEducationAgency_id}/sections": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSectionsByLocalEducationAgency",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "sectionIdentifier",
"in": "query",
"description": "The local identifier assigned to a section.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 255
},
{
"name": "localCourseCode",
"in": "query",
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "schoolYear",
"in": "query",
"description": "The identifier for the school year.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "sessionName",
"in": "query",
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "localEducationAgency_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/section"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/schools/{school_id}/sections": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSectionsBySchool",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "sectionIdentifier",
"in": "query",
"description": "The local identifier assigned to a section.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 255
},
{
"name": "localCourseCode",
"in": "query",
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "schoolYear",
"in": "query",
"description": "The identifier for the school year.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "sessionName",
"in": "query",
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "school_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/section"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/staffs/{staff_id}/sections": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSectionsByStaff",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "sectionIdentifier",
"in": "query",
"description": "The local identifier assigned to a section.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 255
},
{
"name": "localCourseCode",
"in": "query",
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "schoolYear",
"in": "query",
"description": "The identifier for the school year.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "sessionName",
"in": "query",
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "staff_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/section"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/students/{student_id}/sections": {
"get": {
"tags": [
"sections"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getSectionsByStudent",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "sectionIdentifier",
"in": "query",
"description": "The local identifier assigned to a section.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 255
},
{
"name": "localCourseCode",
"in": "query",
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "schoolId",
"in": "query",
"description": "The identifier assigned to a school.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "schoolYear",
"in": "query",
"description": "The identifier for the school year.",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "integer",
"format": "int32"
},
{
"name": "sessionName",
"in": "query",
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"required": false,
"x-Ed-Fi-isIdentity": true,
"type": "string",
"maxLength": 60
},
{
"name": "student_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/section"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/staffs": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStaffs",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/staff"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/staffs/{id}": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves a specific resource using the resource's identifier (using the \"Get By Id\" pattern).",
"description": "This GET operation retrieves a resource by the specified resource identifier.",
"operationId": "getStaffsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/fields"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/staff"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/localEducationAgencies/{localEducationAgency_id}/staffs": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStaffsByLocalEducationAgency",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "localEducationAgency_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/staff"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/schools/{school_id}/staffs": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStaffsBySchool",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "school_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/staff"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/sections/{section_id}/staffs": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStaffsBySection",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "section_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/staff"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/students/{student_id}/staffs": {
"get": {
"tags": [
"staffs"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStaffsByStudent",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "student_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/staff"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/students": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStudents",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/student"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/students/{id}": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves a specific resource using the resource's identifier (using the \"Get By Id\" pattern).",
"description": "This GET operation retrieves a resource by the specified resource identifier.",
"operationId": "getStudentsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/fields"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/student"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/localEducationAgencies/{localEducationAgency_id}/students": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStudentsByLocalEducationAgency",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "localEducationAgency_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/student"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/schools/{school_id}/students": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStudentsBySchool",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "school_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/student"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/sections/{section_id}/students": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStudentsBySection",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "section_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/student"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/enrollment/staffs/{staff_id}/students": {
"get": {
"tags": [
"students"
],
"summary": "Retrieves specific resources using the resource's property values (using the \"Get\" pattern).",
"description": "This GET operation provides access to resources using the \"Get\" search pattern. The values of any properties of the resource that are specified will be used to return all matching results (if it exists).",
"operationId": "getStudentsByStaff",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"$ref": "#/parameters/fields"
},
{
"$ref": "#/parameters/queryExpression"
},
{
"name": "staff_id",
"in": "path",
"required": true,
"type": "string",
"maxLength": 0
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/student"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
}
},
"definitions": {
"localEducationAgency": {
"required": [
"localEducationAgencyId",
"id",
"nameOfInstitution",
"localEducationAgencyCategoryDescriptor",
"addresses"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"addresses": {
"description": "An unordered collection of educationOrganizationAddresses. ",
"type": "array",
"items": {
"$ref": "#/definitions/localEducationAgency_educationOrganizationAddress"
}
},
"localEducationAgencyId": {
"format": "int32",
"description": "The identifier assigned to a local education agency.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"charterStatusDescriptor": {
"description": "A school or agency providing free public elementary or secondary education to eligible students under a specific charter granted by the state legislature or other appropriate authority and designated by such authority to be a charter school.",
"maxLength": 306,
"type": "string"
},
"identificationCodes": {
"description": "An unordered collection of educationOrganizationIdentificationCodes. ",
"type": "array",
"items": {
"$ref": "#/definitions/localEducationAgency_educationOrganizationIdentificationCode"
}
},
"institutionTelephones": {
"description": "An unordered collection of educationOrganizationInstitutionTelephones. ",
"type": "array",
"items": {
"$ref": "#/definitions/localEducationAgency_educationOrganizationInstitutionTelephone"
}
},
"localEducationAgencyCategoryDescriptor": {
"description": "The category of local education agency/district. For example: Independent or Charter.",
"maxLength": 306,
"type": "string"
},
"nameOfInstitution": {
"description": "The full, legally accepted name of the institution.",
"maxLength": 75,
"type": "string"
},
"shortNameOfInstitution": {
"description": "A short name for the institution.",
"maxLength": 75,
"type": "string"
},
"stateEducationAgencyId": {
"format": "int32",
"description": "The identifier assigned to a state education agency.",
"type": "integer"
},
"webSite": {
"description": "The public web site address (URL) for the EducationOrganization.",
"maxLength": 255,
"type": "string"
}
}
},
"localEducationAgency_educationOrganizationAddress": {
"required": [
"addressTypeDescriptor",
"streetNumberName",
"city",
"stateAbbreviationDescriptor",
"postalCode"
],
"type": "object",
"properties": {
"addressTypeDescriptor": {
"description": "The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"streetNumberName": {
"description": "The street number and street name or post office box number of an address.",
"maxLength": 150,
"type": "string"
},
"city": {
"description": "The name of the city in which an address is located.",
"maxLength": 30,
"type": "string"
},
"stateAbbreviationDescriptor": {
"description": "The abbreviation for the state (within the United States) or outlying area in which an address is located.",
"maxLength": 306,
"type": "string"
},
"postalCode": {
"description": "The five or nine digit zip code or overseas postal code portion of an address.",
"maxLength": 17,
"type": "string"
},
"nameOfCounty": {
"description": "The name of the county, parish, borough, or comparable unit (within a state) in 'which an address is located.",
"maxLength": 30,
"type": "string"
}
}
},
"localEducationAgency_educationOrganizationIdentificationCode": {
"required": [
"educationOrganizationIdentificationSystemDescriptor",
"identificationCode"
],
"type": "object",
"properties": {
"educationOrganizationIdentificationSystemDescriptor": {
"description": "The school system, state, or agency assigning the identification code.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"identificationCode": {
"description": "A unique number or alphanumeric code that is assigned to an education organization by a school, school system, state, or other agency or entity.",
"maxLength": 60,
"type": "string"
}
}
},
"localEducationAgency_educationOrganizationInstitutionTelephone": {
"required": [
"institutionTelephoneNumberTypeDescriptor",
"telephoneNumber"
],
"type": "object",
"properties": {
"institutionTelephoneNumberTypeDescriptor": {
"description": "The type of communication number listed for an individual or organization.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"telephoneNumber": {
"description": "The telephone number including the area code, and extension, if applicable.",
"maxLength": 24,
"type": "string"
}
}
},
"school": {
"required": [
"schoolId",
"id",
"nameOfInstitution",
"addresses",
"educationOrganizationCategories",
"gradeLevels"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"addresses": {
"description": "An unordered collection of educationOrganizationAddresses. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_educationOrganizationAddress"
}
},
"educationOrganizationCategories": {
"description": "An unordered collection of educationOrganizationCategories. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_educationOrganizationCategory"
}
},
"gradeLevels": {
"description": "An unordered collection of schoolGradeLevels. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_schoolGradeLevel"
}
},
"schoolId": {
"format": "int32",
"description": "The identifier assigned to a school.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"identificationCodes": {
"description": "An unordered collection of educationOrganizationIdentificationCodes. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_educationOrganizationIdentificationCode"
}
},
"institutionTelephones": {
"description": "An unordered collection of educationOrganizationInstitutionTelephones. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_educationOrganizationInstitutionTelephone"
}
},
"localEducationAgency": {
"$ref": "#/definitions/school_localEducationAgency"
},
"nameOfInstitution": {
"description": "The full, legally accepted name of the institution.",
"maxLength": 75,
"type": "string"
},
"schoolCategories": {
"description": "An unordered collection of schoolCategories. ",
"type": "array",
"items": {
"$ref": "#/definitions/school_schoolCategory"
}
},
"schoolTypeDescriptor": {
"description": "The type of education institution as classified by its primary focus.",
"maxLength": 306,
"type": "string"
},
"shortNameOfInstitution": {
"description": "A short name for the institution.",
"maxLength": 75,
"type": "string"
},
"webSite": {
"description": "The public web site address (URL) for the EducationOrganization.",
"maxLength": 255,
"type": "string"
}
}
},
"school_educationOrganizationAddress": {
"required": [
"addressTypeDescriptor",
"streetNumberName",
"city",
"stateAbbreviationDescriptor",
"postalCode"
],
"type": "object",
"properties": {
"addressTypeDescriptor": {
"description": "The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"streetNumberName": {
"description": "The street number and street name or post office box number of an address.",
"maxLength": 150,
"type": "string"
},
"city": {
"description": "The name of the city in which an address is located.",
"maxLength": 30,
"type": "string"
},
"stateAbbreviationDescriptor": {
"description": "The abbreviation for the state (within the United States) or outlying area in which an address is located.",
"maxLength": 306,
"type": "string"
},
"postalCode": {
"description": "The five or nine digit zip code or overseas postal code portion of an address.",
"maxLength": 17,
"type": "string"
},
"nameOfCounty": {
"description": "The name of the county, parish, borough, or comparable unit (within a state) in 'which an address is located.",
"maxLength": 30,
"type": "string"
}
}
},
"school_educationOrganizationCategory": {
"required": [
"category"
],
"type": "object",
"properties": {
"category": {
"description": "The classification of the education agency within the geographic boundaries of a state according to the level of administrative and operational control granted by the state.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"school_educationOrganizationIdentificationCode": {
"required": [
"educationOrganizationIdentificationSystemDescriptor",
"identificationCode"
],
"type": "object",
"properties": {
"educationOrganizationIdentificationSystemDescriptor": {
"description": "The school system, state, or agency assigning the identification code.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"identificationCode": {
"description": "A unique number or alphanumeric code that is assigned to an education organization by a school, school system, state, or other agency or entity.",
"maxLength": 60,
"type": "string"
}
}
},
"school_educationOrganizationInstitutionTelephone": {
"required": [
"institutionTelephoneNumberTypeDescriptor",
"telephoneNumber"
],
"type": "object",
"properties": {
"institutionTelephoneNumberTypeDescriptor": {
"description": "The type of communication number listed for an individual or organization.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"telephoneNumber": {
"description": "The telephone number including the area code, and extension, if applicable.",
"maxLength": 24,
"type": "string"
}
}
},
"school_localEducationAgency": {
"required": [
"id",
"localEducationAgencyId"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"localEducationAgencyId": {
"format": "int32",
"description": "The identifier assigned to a local education agency.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
}
}
},
"school_schoolCategory": {
"required": [
"category"
],
"type": "object",
"properties": {
"category": {
"description": "The one or more categories of school. For example: High School, Middle School, and/or Elementary School.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"school_schoolGradeLevel": {
"required": [
"gradeLevelDescriptor"
],
"type": "object",
"properties": {
"gradeLevelDescriptor": {
"description": "The grade levels served at the school.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"section": {
"required": [
"sectionIdentifier",
"localCourseCode",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"localCourseCode": {
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"maxLength": 60,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"sectionIdentifier": {
"description": "The local identifier assigned to a section.",
"maxLength": 255,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"academicSubjectDescriptor": {
"description": "The intended major subject area of the course.",
"maxLength": 306,
"type": "string"
},
"availableCredits": {
"format": "double",
"description": "The value of credits or units of value awarded for the completion of a course.",
"type": "number"
},
"classPeriods": {
"description": "An unordered collection of sectionClassPeriods. ",
"type": "array",
"items": {
"$ref": "#/definitions/section_sectionClassPeriod"
}
},
"educationalEnvironmentDescriptor": {
"description": "The setting in which a child receives education and related services; for example: Center-based instruction Home-based instruction Hospital class Mainstream Residential care and treatment facility ...",
"maxLength": 306,
"type": "string"
},
"location": {
"$ref": "#/definitions/section_location"
},
"locationSchoolReference": {
"$ref": "#/definitions/section_school"
},
"sequenceOfCourse": {
"format": "int32",
"description": "When a section is part of a sequence of parts for a course, the number of the sequence. If the course has only one part, the value of this section attribute should be 1.",
"type": "integer"
},
"session": {
"$ref": "#/definitions/section_session"
},
"staff": {
"description": "An unordered collection of staffSectionAssociations. ",
"type": "array",
"items": {
"$ref": "#/definitions/section_staffSectionAssociation"
}
},
"students": {
"description": "An unordered collection of studentSectionAssociations. ",
"type": "array",
"items": {
"$ref": "#/definitions/section_studentSectionAssociation"
}
}
}
},
"section_location": {
"required": [
"id",
"schoolId",
"classroomIdentificationCode"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"schoolId": {
"format": "int32",
"description": "The identifier assigned to a school.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"classroomIdentificationCode": {
"description": "A unique number or alphanumeric code assigned to a room by a school, school system, state, or other agency or entity.",
"maxLength": 20,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"section_school": {
"required": [
"id",
"schoolId"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"schoolId": {
"format": "int32",
"description": "The identifier assigned to a school.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
}
}
},
"section_sectionClassPeriod": {
"required": [
"classPeriodName"
],
"type": "object",
"properties": {
"classPeriodName": {
"description": "An indication of the portion of a typical daily session in which students receive instruction in a specified subject (e.g., morning, sixth period, block period, or AB schedules).",
"maxLength": 60,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"section_session": {
"required": [
"id",
"schoolId",
"schoolYear",
"termDescriptor",
"sessionName",
"beginDate",
"endDate",
"totalInstructionalDays"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"schoolId": {
"format": "int32",
"description": "The identifier assigned to a school.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"schoolYear": {
"format": "int32",
"description": "The identifier for the school year.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"termDescriptor": {
"description": "An descriptor value indicating the term (e.g. 'Fall Semester', 'Second Quarter', 'Summer Semester', etc.).",
"maxLength": 306,
"type": "string"
},
"sessionName": {
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"maxLength": 60,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"beginDate": {
"format": "date-time",
"description": "Month, day, and year of the first day of the Session.",
"type": "string"
},
"endDate": {
"format": "date-time",
"description": "Month, day and year of the last day of the Session.",
"type": "string"
},
"totalInstructionalDays": {
"format": "int32",
"description": "The total number of instructional days in the school calendar.",
"type": "integer"
}
}
},
"section_staffSectionAssociation": {
"required": [
"id",
"staffUniqueId"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"staffUniqueId": {
"description": "A unique alphanumeric code assigned to a staff.",
"maxLength": 32,
"type": "string"
}
}
},
"section_studentSectionAssociation": {
"required": [
"id",
"studentUniqueId"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"studentUniqueId": {
"description": "A unique alphanumeric code assigned to a student.",
"maxLength": 32,
"type": "string"
}
}
},
"staff": {
"required": [
"id",
"staffUniqueId",
"firstName",
"lastSurname"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"addresses": {
"description": "An unordered collection of staffAddresses. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffAddress"
}
},
"birthDate": {
"format": "date-time",
"description": "The month, day, and year on which an individual was born.",
"type": "string"
},
"educationOrganizationAssignments": {
"description": "An unordered collection of staffEducationOrganizationAssignmentAssociations. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffEducationOrganizationAssignmentAssociation"
}
},
"electronicMails": {
"description": "An unordered collection of staffElectronicMails. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffElectronicMail"
}
},
"firstName": {
"description": "A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change.",
"maxLength": 75,
"type": "string"
},
"hispanicLatinoEthnicity": {
"description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central, and South America, and other Spanish cultures, regardless of race. The term, \"Spanish origin,\" can be used in addition to \"Hispanic or Latino.\"",
"type": "boolean"
},
"identificationCodes": {
"description": "An unordered collection of staffIdentificationCodes. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffIdentificationCode"
}
},
"languages": {
"description": "An unordered collection of staffLanguages. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffLanguage"
}
},
"lastSurname": {
"description": "The name borne in common by members of a family.",
"maxLength": 75,
"type": "string"
},
"loginId": {
"description": "The login ID for the user; used for security access control interface.",
"maxLength": 60,
"type": "string"
},
"personalTitlePrefix": {
"description": "A prefix used to denote the title, degree, position, or seniority of the person.",
"maxLength": 30,
"type": "string"
},
"races": {
"description": "An unordered collection of staffRaces. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffRace"
}
},
"sexDescriptor": {
"description": "A person's gender.",
"maxLength": 306,
"type": "string"
},
"staffUniqueId": {
"description": "A unique alphanumeric code assigned to a staff.",
"maxLength": 32,
"type": "string"
},
"telephones": {
"description": "An unordered collection of staffTelephones. ",
"type": "array",
"items": {
"$ref": "#/definitions/staff_staffTelephone"
}
}
}
},
"staff_staffAddress": {
"required": [
"addressTypeDescriptor",
"streetNumberName",
"city",
"stateAbbreviationDescriptor",
"postalCode"
],
"type": "object",
"properties": {
"addressTypeDescriptor": {
"description": "The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"streetNumberName": {
"description": "The street number and street name or post office box number of an address.",
"maxLength": 150,
"type": "string"
},
"city": {
"description": "The name of the city in which an address is located.",
"maxLength": 30,
"type": "string"
},
"stateAbbreviationDescriptor": {
"description": "The abbreviation for the state (within the United States) or outlying area in which an address is located.",
"maxLength": 306,
"type": "string"
},
"postalCode": {
"description": "The five or nine digit zip code or overseas postal code portion of an address.",
"maxLength": 17,
"type": "string"
},
"nameOfCounty": {
"description": "The name of the county, parish, borough, or comparable unit (within a state) in 'which an address is located.",
"maxLength": 30,
"type": "string"
}
}
},
"staff_staffEducationOrganizationAssignmentAssociation": {
"required": [
"staffClassificationDescriptor"
],
"type": "object",
"properties": {
"staffClassificationDescriptor": {
"description": "The titles of employment, official status, or rank of education staff.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"staff_staffElectronicMail": {
"required": [
"electronicMailTypeDescriptor",
"electronicMailAddress"
],
"type": "object",
"properties": {
"electronicMailTypeDescriptor": {
"description": "The type of email listed for an individual or organization. For example: Home/Personal, Work, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"electronicMailAddress": {
"description": "The electronic mail (e-mail) address listed for an individual or organization.",
"maxLength": 128,
"type": "string"
}
}
},
"staff_staffIdentificationCode": {
"required": [
"staffIdentificationSystemDescriptor",
"identificationCode"
],
"type": "object",
"properties": {
"staffIdentificationSystemDescriptor": {
"description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a staff member.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a staff member by a school, school system, a state, or other agency or entity.",
"maxLength": 60,
"type": "string"
}
}
},
"staff_staffLanguage": {
"required": [
"languageDescriptor"
],
"type": "object",
"properties": {
"languageDescriptor": {
"description": "A specification of which written or spoken communication is being used.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"staff_staffRace": {
"required": [
"raceDescriptor"
],
"type": "object",
"properties": {
"raceDescriptor": {
"description": "The general racial category which most clearly reflects the individual's recognition of his or her community or with which the individual most identifies. The way this data element is listed, it must allow for multiple entries so that each individual can specify all appropriate races.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"staff_staffTelephone": {
"required": [
"telephoneNumberTypeDescriptor",
"telephoneNumber"
],
"type": "object",
"properties": {
"telephoneNumberTypeDescriptor": {
"description": "The type of communication number listed for an individual or organization.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"orderOfPriority": {
"format": "int32",
"description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc.",
"type": "integer"
},
"telephoneNumber": {
"description": "The telephone number including the area code, and extension, if applicable.",
"maxLength": 24,
"type": "string"
}
}
},
"student": {
"required": [
"id",
"studentUniqueId",
"firstName",
"lastSurname",
"birthDate"
],
"type": "object",
"properties": {
"id": {
"description": "",
"type": "string"
},
"birthDate": {
"format": "date-time",
"description": "The month, day, and year on which an individual was born.",
"type": "string"
},
"educationOrganizations": {
"description": "An unordered collection of studentEducationOrganizationAssociations. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation"
}
},
"firstName": {
"description": "A name given to an individual at birth, baptism, or during another naming ceremony, or through legal change.",
"maxLength": 75,
"type": "string"
},
"lastSurname": {
"description": "The name borne in common by members of a family.",
"maxLength": 75,
"type": "string"
},
"middleName": {
"description": "A secondary name given to an individual at birth, baptism, or during another naming ceremony.",
"maxLength": 75,
"type": "string"
},
"personalTitlePrefix": {
"description": "A prefix used to denote the title, degree, position, or seniority of the person.",
"maxLength": 30,
"type": "string"
},
"schools": {
"description": "An unordered collection of studentSchoolAssociations. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentSchoolAssociation"
}
},
"studentUniqueId": {
"description": "A unique alphanumeric code assigned to a student.",
"maxLength": 32,
"type": "string"
}
}
},
"student_studentEducationOrganizationAssociation": {
"required": [
"educationOrganizationId",
"sexDescriptor"
],
"type": "object",
"properties": {
"educationOrganizationId": {
"format": "int32",
"description": "The identifier assigned to an education organization.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
},
"loginId": {
"description": "The login ID for the user; used for security access control interface.",
"maxLength": 60,
"type": "string"
},
"sexDescriptor": {
"description": "A person's gender.",
"maxLength": 306,
"type": "string"
},
"hispanicLatinoEthnicity": {
"description": "An indication that the individual traces his or her origin or descent to Mexico, Puerto Rico, Cuba, Central, and South America, and other Spanish cultures, regardless of race. The term, \"Spanish origin,\" can be used in addition to \"Hispanic or Latino.\"",
"type": "boolean"
},
"addresses": {
"description": "An unordered collection of studentEducationOrganizationAssociationAddresses. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationAddress"
}
},
"electronicMails": {
"description": "An unordered collection of studentEducationOrganizationAssociationElectronicMails. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationElectronicMail"
}
},
"identificationCodes": {
"description": "An unordered collection of studentEducationOrganizationAssociationStudentIdentificationCodes. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationStudentIdentificationCode"
}
},
"languages": {
"description": "An unordered collection of studentEducationOrganizationAssociationLanguages. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationLanguage"
}
},
"races": {
"description": "An unordered collection of studentEducationOrganizationAssociationRaces. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationRace"
}
},
"telephones": {
"description": "An unordered collection of studentEducationOrganizationAssociationTelephones. ",
"type": "array",
"items": {
"$ref": "#/definitions/student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationTelephone"
}
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationAddress": {
"required": [
"addressTypeDescriptor",
"streetNumberName",
"city",
"stateAbbreviationDescriptor",
"postalCode"
],
"type": "object",
"properties": {
"addressTypeDescriptor": {
"description": "The type of address listed for an individual or organization. For example: Physical Address, Mailing Address, Home Address, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"streetNumberName": {
"description": "The street number and street name or post office box number of an address.",
"maxLength": 150,
"type": "string"
},
"city": {
"description": "The name of the city in which an address is located.",
"maxLength": 30,
"type": "string"
},
"stateAbbreviationDescriptor": {
"description": "The abbreviation for the state (within the United States) or outlying area in which an address is located.",
"maxLength": 306,
"type": "string"
},
"postalCode": {
"description": "The five or nine digit zip code or overseas postal code portion of an address.",
"maxLength": 17,
"type": "string"
},
"nameOfCounty": {
"description": "The name of the county, parish, borough, or comparable unit (within a state) in 'which an address is located.",
"maxLength": 30,
"type": "string"
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationElectronicMail": {
"required": [
"electronicMailTypeDescriptor",
"electronicMailAddress"
],
"type": "object",
"properties": {
"electronicMailTypeDescriptor": {
"description": "The type of email listed for an individual or organization. For example: Home/Personal, Work, etc.)",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"electronicMailAddress": {
"description": "The electronic mail (e-mail) address listed for an individual or organization.",
"maxLength": 128,
"type": "string"
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationLanguage": {
"required": [
"languageDescriptor"
],
"type": "object",
"properties": {
"languageDescriptor": {
"description": "A specification of which written or spoken communication is being used.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationRace": {
"required": [
"raceDescriptor"
],
"type": "object",
"properties": {
"raceDescriptor": {
"description": "The general racial category which most clearly reflects the individual's recognition of his or her community or with which the individual most identifies. The data model allows for multiple entries so that each individual can specify all appropriate races.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationStudentIdentificationCode": {
"required": [
"assigningOrganizationIdentificationCode",
"studentIdentificationSystemDescriptor",
"identificationCode"
],
"type": "object",
"properties": {
"assigningOrganizationIdentificationCode": {
"description": "The organization code or name assigning the StudentIdentificationCode.",
"maxLength": 60,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"studentIdentificationSystemDescriptor": {
"description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a student.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a student by a school, school system, a state, or other agency or entity.",
"maxLength": 60,
"type": "string"
}
}
},
"student_studentEducationOrganizationAssociation_studentEducationOrganizationAssociationTelephone": {
"required": [
"telephoneNumberTypeDescriptor",
"telephoneNumber"
],
"type": "object",
"properties": {
"telephoneNumberTypeDescriptor": {
"description": "The type of communication number listed for an individual or organization.",
"maxLength": 306,
"type": "string",
"x-Ed-Fi-isIdentity": true
},
"orderOfPriority": {
"format": "int32",
"description": "The order of priority assigned to telephone numbers to define which number to attempt first, second, etc.",
"type": "integer"
},
"telephoneNumber": {
"description": "The telephone number including the area code, and extension, if applicable.",
"maxLength": 24,
"type": "string"
}
}
},
"student_studentSchoolAssociation": {
"required": [
"entryGradeLevelDescriptor",
"id",
"schoolId"
],
"type": "object",
"properties": {
"entryGradeLevelDescriptor": {
"description": "The grade level or primary instructional level at which a student enters and receives services in a school or an educational institution during a given academic session.",
"maxLength": 306,
"type": "string"
},
"id": {
"description": "",
"type": "string"
},
"schoolId": {
"format": "int32",
"description": "The identifier assigned to a school.",
"type": "integer",
"x-Ed-Fi-isIdentity": true
}
}
}
},
"parameters": {
"offset": {
"name": "offset",
"in": "query",
"description": "Indicates how many items should be skipped before returning results.",
"required": false,
"type": "integer",
"format": "int32"
},
"limit": {
"name": "limit",
"in": "query",
"description": "Indicates the maximum number of items that should be returned in the results.",
"required": false,
"type": "integer",
"format": "int32",
"maxItems": 100,
"minItems": 1
},
"id": {
"name": "id",
"in": "path",
"description": "A resource identifier that uniquely identifies the resource.",
"required": true,
"type": "string"
},
"fields": {
"name": "fields",
"in": "query",
"description": "Specifies a subset of properties that should be returned for each entity (e.g. \"property1,collection1(collProp1,collProp2)\").",
"required": false,
"type": "string"
},
"queryExpression": {
"name": "q",
"in": "query",
"description": "Specifies a query filter expression for the request. Currently only supports range-based queries on dates and numbers (e.g. \"[2016-03-07..2016-03-10]\").",
"required": false,
"type": "string"
}
},
"responses": {
"Created": {
"description": "The resource was created. The location of the resource is available in the Location header of the response."
},
"Updated": {
"description": "The resource was updated. "
},
"Deleted": {
"description": "The resource was successfully deleted."
},
"NotModified": {
"description": "The resource has not been modified."
},
"BadRequest": {
"description": "Bad Request. The request was invalid and cannot be completed. See the response body for specific validation errors. This will typically be an issue with the query parameters or their values."
},
"Unauthorized": {
"description": "Unauthorized. The request requires authentication. The OAuth bearer token was either not provided or is invalid. The operation may succeed once authentication has been successfully completed."
},
"Forbidden": {
"description": "Forbidden. The request cannot be completed in the current authorization context. Contact your administrator if you believe this operation should be allowed."
},
"NotFound": {
"description": "The resource could not be found."
},
"Conflict": {
"description": "Conflict. The request cannot be completed because it would result in an invalid state. See the response body for details."
},
"PreconditionFailed": {
"description": "The resource has been modified by another consumer."
},
"Error": {
"description": "An unhandled error occurred on the server. See the response body for details."
}
},
"tags": [
{
"name": "localEducationAgencies"
},
{
"name": "schools"
},
{
"name": "sections"
},
{
"name": "staffs"
},
{
"name": "students"
}
]
}