Ed-Fi RFC 21 - Open API Spec
Ian Christopher (Deactivated)
Eric Jansson
Owned by Ian Christopher (Deactivated)
This page contains the full Open API spec listing for the proposed ED-FI RFC 21 - ASSESSMENT OUTCOMES API.
 API Specification
Open API Definition
{
"swagger": "2.0",
"info": {
"description": "The Ed-Fi Assessment Outcomes API describes a REST API surface to enable exchange of assessment metadata and student assessment results between disparate and geographically separated systems operated by different organizations. The API resource models are derived from and consistent with the underling Ed-Fi Unifying Data Model v3.1.",
"version": "rfc21",
"title": "Ed-Fi Assessment Outcomes API"
},
"basePath": "/",
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
{
"name": "assessments",
"description": "This entity represents a tool, instrument, process, or exhibition composed of a systematic sampling of behavior for measuring a student's competence, knowledge, skills, or behavior. An assessment can be used to measure differences in individuals or groups and changes in performance from one occasion to the next."
},
{
"name": "objectiveAssessments",
"description": "This entity represents subtests that assess specific learning objectives."
},
{
"name": "assessmentItems",
"description": "This entity represents one of many single measures that make up an assessment."
},
{
"name": "learningObjectives",
"description": "This entity represents identified learning objectives for courses in specific grades."
},
{
"name": "learningStandards",
"description": "This entity is a sub-element of a learning objective consisting of a precise statement of the expectation of a student's proficiency."
},
{
"name": "studentAssessments",
"description": "This entity represents the analysis or scoring of a student's response on an assessment. The analysis results in a value that represents a student's performance on a set of items on a test."
}
],
"paths": {
"/ed-fi/assessments": {
"get": {
"tags": [
"assessments"
],
"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": "getAssessments",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "assessmentIdentifier",
"in": "query",
"description": "A unique number or alphanumeric code assigned to an assessment.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "namespace",
"in": "query",
"description": "Namespace for the Assessment.",
"required": false,
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessment"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"assessments"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "assessment",
"in": "body",
"description": "The JSON representation of the \"assessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_assessment"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/assessments/{id}": {
"get": {
"tags": [
"assessments"
],
"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": "getAssessmentsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_assessment"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"assessments"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "assessment",
"in": "body",
"description": "The JSON representation of the \"assessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_assessment"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"assessments"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteAssessmentById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/assessmentItems": {
"get": {
"tags": [
"assessmentItems"
],
"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": "getAssessmentItems",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "identificationCode",
"in": "query",
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, state, or other agency or entity.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "assessmentIdentifier",
"in": "query",
"description": "A unique number or alphanumeric code assigned to an assessment.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "namespace",
"in": "query",
"description": "Namespace for the Assessment.",
"required": false,
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentItem"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"assessmentItems"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postAssessmentItem",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "assessmentItem",
"in": "body",
"description": "The JSON representation of the \"assessmentItem\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_assessmentItem"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/assessmentItems/{id}": {
"get": {
"tags": [
"assessmentItems"
],
"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": "getAssessmentItemsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_assessmentItem"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"assessmentItems"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putAssessmentItem",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "assessmentItem",
"in": "body",
"description": "The JSON representation of the \"assessmentItem\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_assessmentItem"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"assessmentItems"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteAssessmentItemById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/learningObjectives": {
"get": {
"tags": [
"learningObjectives"
],
"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": "getLearningObjectives",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "learningObjectiveId",
"in": "query",
"description": "The identifier for the specific learning objective in the context of a standard (e.g., 111.15.3.1.A).",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "namespace",
"in": "query",
"description": "Namespace for the LearningObjective.",
"required": false,
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningObjective"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"learningObjectives"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postLearningObjective",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "learningObjective",
"in": "body",
"description": "The JSON representation of the \"learningObjective\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_learningObjective"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/learningObjectives/{id}": {
"get": {
"tags": [
"learningObjectives"
],
"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": "getLearningObjectivesById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_learningObjective"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"learningObjectives"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putLearningObjective",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "learningObjective",
"in": "body",
"description": "The JSON representation of the \"learningObjective\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_learningObjective"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"learningObjectives"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteLearningObjectiveById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/learningStandards": {
"get": {
"tags": [
"learningStandards"
],
"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": "getLearningStandards",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "learningStandardId",
"in": "query",
"description": "The identifier for the specific learning standard (e.g., 111.15.3.1.A).",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandard"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"learningStandards"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postLearningStandard",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "learningStandard",
"in": "body",
"description": "The JSON representation of the \"learningStandard\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_learningStandard"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/learningStandards/{id}": {
"get": {
"tags": [
"learningStandards"
],
"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": "getLearningStandardsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_learningStandard"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"learningStandards"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putLearningStandard",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "learningStandard",
"in": "body",
"description": "The JSON representation of the \"learningStandard\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_learningStandard"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"learningStandards"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteLearningStandardById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/objectiveAssessments": {
"get": {
"tags": [
"objectiveAssessments"
],
"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": "getObjectiveAssessments",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "identificationCode",
"in": "query",
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, a state, or other agency or entity.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "assessmentIdentifier",
"in": "query",
"description": "A unique number or alphanumeric code assigned to an assessment.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "namespace",
"in": "query",
"description": "Namespace for the Assessment.",
"required": false,
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessment"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"objectiveAssessments"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postObjectiveAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "objectiveAssessment",
"in": "body",
"description": "The JSON representation of the \"objectiveAssessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_objectiveAssessment"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/objectiveAssessments/{id}": {
"get": {
"tags": [
"objectiveAssessments"
],
"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": "getObjectiveAssessmentsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_objectiveAssessment"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"objectiveAssessments"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putObjectiveAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "objectiveAssessment",
"in": "body",
"description": "The JSON representation of the \"objectiveAssessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_objectiveAssessment"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"objectiveAssessments"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteObjectiveAssessmentById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/studentAssessments": {
"get": {
"tags": [
"studentAssessments"
],
"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": "getStudentAssessments",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/offset"
},
{
"$ref": "#/parameters/limit"
},
{
"name": "studentAssessmentIdentifier",
"in": "query",
"description": "A unique number or alphanumeric code assigned to an assessment administered to a student.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "assessmentIdentifier",
"in": "query",
"description": "A unique number or alphanumeric code assigned to an assessment.",
"required": false,
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
{
"name": "namespace",
"in": "query",
"description": "Namespace for the Assessment.",
"required": false,
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
{
"name": "studentUniqueId",
"in": "query",
"description": "A unique alphanumeric code assigned to a student.",
"required": false,
"type": "string",
"maxLength": 32,
"x-Ed-Fi-isIdentity": true
},
{
"name": "id",
"in": "query",
"description": "A resource identifier that uniquely identifies the resource.",
"required": false,
"type": "string"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessment"
}
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"post": {
"tags": [
"studentAssessments"
],
"summary": "Creates or updates resources based on the natural key values of the supplied resource.",
"description": "The POST operation can be used to create or update resources. In database terms, this is often referred to as an \"upsert\" operation (insert + update). Clients should NOT include the resource \"id\" in the JSON body because it will result in an error (you must use a PUT operation to update a resource by \"id\"). The web service will identify whether the resource already exists based on the natural key values provided, and update or create the resource appropriately.",
"operationId": "postStudentAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "studentAssessment",
"in": "body",
"description": "The JSON representation of the \"studentAssessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_studentAssessment"
}
}
],
"responses": {
"201": {
"$ref": "#/responses/Created"
},
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
},
"/ed-fi/studentAssessments/{id}": {
"get": {
"tags": [
"studentAssessments"
],
"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": "getStudentAssessmentsById",
"produces": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"$ref": "#/parameters/If-None-Match"
}
],
"responses": {
"200": {
"description": "The requested resource was successfully retrieved.",
"schema": {
"$ref": "#/definitions/edFi_studentAssessment"
}
},
"304": {
"$ref": "#/responses/NotModified"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"put": {
"tags": [
"studentAssessments"
],
"summary": "Updates or creates a resource based on the resource identifier.",
"description": "The PUT operation is used to update or create a resource by identifier. If the resource doesn't exist, the resource will be created using that identifier. Additionally, natural key values cannot be changed using this operation, and will not be modified in the database. If the resource \"id\" is provided in the JSON body, it will be ignored as well.",
"operationId": "putStudentAssessment",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the PUT from updating a resource modified by another consumer.",
"type": "string"
},
{
"name": "studentAssessment",
"in": "body",
"description": "The JSON representation of the \"studentAssessment\" resource to be created or updated.",
"required": true,
"schema": {
"$ref": "#/definitions/edFi_studentAssessment"
}
}
],
"responses": {
"204": {
"$ref": "#/responses/Updated"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
},
"delete": {
"tags": [
"studentAssessments"
],
"summary": "Deletes an existing resource using the resource identifier.",
"description": "The DELETE operation is used to delete an existing resource by identifier. If the resource doesn't exist, an error will result (the resource will not be found).",
"operationId": "deleteStudentAssessmentById",
"consumes": [
"application/json"
],
"parameters": [
{
"$ref": "#/parameters/id"
},
{
"name": "If-Match",
"in": "header",
"description": "The ETag header value used to prevent the DELETE from removing a resource modified by another consumer.",
"type": "string"
}
],
"responses": {
"204": {
"$ref": "#/responses/Deleted"
},
"400": {
"$ref": "#/responses/BadRequest"
},
"401": {
"$ref": "#/responses/Unauthorized"
},
"403": {
"$ref": "#/responses/Forbidden"
},
"404": {
"$ref": "#/responses/NotFound"
},
"409": {
"$ref": "#/responses/Conflict"
},
"412": {
"$ref": "#/responses/PreconditionFailed"
},
"500": {
"$ref": "#/responses/Error"
}
}
}
}
},
"definitions": {
"edFi_assessment": {
"required": [
"assessmentIdentifier",
"namespace",
"academicSubjects",
"assessmentTitle",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"academicSubjects": {
"description": "An unordered collection of assessmentAcademicSubjects. The description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language) of an assessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentAcademicSubject"
}
},
"assessmentIdentifier": {
"description": "A unique number or alphanumeric code assigned to an assessment.",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"namespace": {
"description": "Namespace for the Assessment.",
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
"educationOrganizationReference": {
"$ref": "#/definitions/edFi_educationOrganizationReference"
},
"adaptiveAssessment": {
"description": "Indicates that the assessment is adaptive.",
"type": "boolean"
},
"assessedGradeLevels": {
"type": "array",
"description": "An unordered collection of assessmentAssessedGradeLevels. The grade level(s) for which an assessment is designed. The semantics of null is assumed to mean that the assessment is not associated with any grade level.",
"items": {
"$ref": "#/definitions/edFi_assessmentAssessedGradeLevel"
}
},
"assessmentCategoryDescriptor": {
"description": "The category of an assessment based on format and content. For example: Achievement test Advanced placement test Alternate assessment/grade-level standards Attitudinal test Cognitive and perceptual skills test ...",
"type": "string",
"maxLength": 306
},
"assessmentFamily": {
"description": "The AssessmentFamily this Assessment is a member of.",
"type": "string",
"maxLength": 60
},
"assessmentForm": {
"description": "Identifies the form of the assessment, for example a regular versus makeup form, multiple choice versus constructed response, etc.",
"type": "string",
"maxLength": 60
},
"assessmentTitle": {
"description": "The title or name of the Assessment.",
"type": "string",
"maxLength": 100
},
"assessmentVersion": {
"description": "The version identifier for the assessment.",
"type": "integer",
"format": "int32"
},
"contentStandard": {
"$ref": "#/definitions/edFi_assessmentContentStandard"
},
"identificationCodes": {
"description": "An unordered collection of assessmentIdentificationCodes. A unique number or alphanumeric code assigned to an assessment by a school, school system, a state, or other agency or entity.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentIdentificationCode"
}
},
"languages": {
"description": "An unordered collection of assessmentLanguages. An indication of the languages in which the assessment is designed.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentLanguage"
}
},
"maxRawScore": {
"description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum.",
"type": "integer",
"format": "int32"
},
"nomenclature": {
"description": "Reflects the specific nomenclature used for Assessment.",
"type": "string",
"maxLength": 35
},
"performanceLevels": {
"description": "An unordered collection of assessmentPerformanceLevels. Definition of the performance levels and the associated cut scores. Three styles are supported: 1. Specification of performance level by minimum and maximum score. 2. Specification of performance level by cut score, using only minimum score. 3. Specification of performance level without any mapping to scores.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentPerformanceLevel"
}
},
"period": {
"$ref": "#/definitions/edFi_assessmentPeriod"
},
"programs": {
"description": "An unordered collection of assessmentPrograms. The programs associated with the Assessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentProgram"
}
},
"revisionDate": {
"description": "The month, day, and year that the conceptual design for the assessment was most recently revised substantially.",
"type": "string",
"format": "date"
},
"scores": {
"description": "An unordered collection of assessmentScores. Definition of the scores to be expected from this assessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentScore"
}
},
"sections": {
"description": "An unordered collection of assessmentSections. The Section(s) to which the Assessment is associated.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentSection"
}
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_assessmentAcademicSubject": {
"required": [
"academicSubjectDescriptor"
],
"type": "object",
"properties": {
"academicSubjectDescriptor": {
"description": "The description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language) of an assessment.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_assessmentAssessedGradeLevel": {
"required": [
"gradeLevelDescriptor"
],
"type": "object",
"properties": {
"gradeLevelDescriptor": {
"description": "The grade level(s) for which an assessment is designed. The semantics of null is assumed to mean that the assessment is not associated with any grade level.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_assessmentContentStandard": {
"required": [
"title"
],
"type": "object",
"properties": {
"publicationStatusDescriptor": {
"description": "The publication status of the document (i.e., Adopted, Draft, Published, Deprecated, Unknown).",
"type": "string",
"maxLength": 306
},
"beginDate": {
"description": "The beginning of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"endDate": {
"description": "The end of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"publicationDate": {
"description": "The date on which this content was first published.",
"type": "string",
"format": "date"
},
"publicationYear": {
"description": "The year at which this content was first published.",
"type": "integer",
"format": "int32"
},
"title": {
"description": "The name of the content standard, for example Common Core.",
"type": "string",
"maxLength": 75
},
"uri": {
"description": "An unambiguous reference to the standards using a network-resolvable URI.",
"type": "string",
"maxLength": 255
},
"version": {
"description": "The version identifier for the content.",
"type": "string",
"maxLength": 50
},
"mandatingEducationOrganizationReference": {
"$ref": "#/definitions/edFi_educationOrganizationReference"
},
"authors": {
"description": "An unordered collection of assessmentContentStandardAuthors. The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentContentStandardAuthor"
}
}
}
},
"edFi_assessmentContentStandardAuthor": {
"required": [
"author"
],
"type": "object",
"properties": {
"author": {
"description": "The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "string",
"maxLength": 100,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_assessmentIdentificationCode": {
"required": [
"assessmentIdentificationSystemDescriptor",
"identificationCode"
],
"type": "object",
"properties": {
"assessmentIdentificationSystemDescriptor": {
"description": "A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to an assessment.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"assigningOrganizationIdentificationCode": {
"description": "The organization code or name assigning the assessment identification code.",
"type": "string",
"maxLength": 60
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to an assessment by a school, school system, state, or other agency or entity.",
"type": "string",
"maxLength": 60
}
}
},
"edFi_assessmentItem": {
"required": [
"identificationCode",
"assessmentReference",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, state, or other agency or entity.",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"assessmentReference": {
"$ref": "#/definitions/edFi_assessmentReference"
},
"assessmentItemCategoryDescriptor": {
"description": "Category or type of the AssessmentItem. For example: Multiple choice, Analytic, Prose...",
"type": "string",
"maxLength": 306
},
"assessmentItemURI": {
"description": "The URI (typically a URL) pointing to the entry in an assessment item bank, which describes this content item.",
"type": "string",
"maxLength": 255
},
"correctResponse": {
"description": "The correct response for the AssessmentItem.",
"type": "string",
"maxLength": 20
},
"expectedTimeAssessed": {
"description": "The duration of time allotted for the AssessmentItem.",
"type": "string",
"maxLength": 30
},
"learningStandards": {
"description": "An unordered collection of assessmentItemLearningStandards. LearningStandard tested by this item.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_assessmentItemLearningStandard"
}
},
"maxRawScore": {
"description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum.",
"type": "integer",
"format": "int32"
},
"nomenclature": {
"description": "Reflects the specific nomenclature used for AssessmentItem.",
"type": "string",
"maxLength": 35
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_assessmentItemLearningStandard": {
"required": [
"learningStandardReference"
],
"type": "object",
"properties": {
"learningStandardReference": {
"$ref": "#/definitions/edFi_learningStandardReference"
}
}
},
"edFi_assessmentItemReference": {
"required": [
"assessmentIdentifier",
"identificationCode",
"namespace"
],
"type": "object",
"properties": {
"assessmentIdentifier": {
"description": "A unique number or alphanumeric code assigned to an assessment.",
"type": "string",
"maxLength": 60
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, state, or other agency or entity.",
"type": "string",
"maxLength": 60
},
"namespace": {
"description": "Namespace for the Assessment.",
"type": "string",
"maxLength": 255
}
}
},
"edFi_assessmentLanguage": {
"required": [
"languageDescriptor"
],
"type": "object",
"properties": {
"languageDescriptor": {
"description": "An indication of the languages in which the assessment is designed.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_assessmentPerformanceLevel": {
"required": [
"assessmentReportingMethodDescriptor",
"performanceLevelDescriptor"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the instructor of the class uses to report the performance and achievement of all students. It may be a qualitative method such as individualized teacher comments or a quantitative method such as a letter or numerical grade. In some cases, more than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelDescriptor": {
"description": "The performance level(s) defined for the assessment.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"maximumScore": {
"description": "The maximum score to make the indicated level of performance.",
"type": "string",
"maxLength": 35
},
"minimumScore": {
"description": "The minimum score required to make the indicated level of performance.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_assessmentPeriod": {
"required": [
"assessmentPeriodDescriptor"
],
"type": "object",
"properties": {
"assessmentPeriodDescriptor": {
"description": "The period of time in which an assessment is supposed to be administered (e.g., Beginning of Year, Middle of Year, End of Year).",
"type": "string",
"maxLength": 306
},
"beginDate": {
"description": "The first date the assessment is to be administered.",
"type": "string",
"format": "date"
},
"endDate": {
"description": "The last date the assessment is to be administered.",
"type": "string",
"format": "date"
}
}
},
"edFi_assessmentProgram": {
"required": [
"programReference"
],
"type": "object",
"properties": {
"programReference": {
"$ref": "#/definitions/edFi_programReference"
}
}
},
"edFi_assessmentReference": {
"required": [
"assessmentIdentifier",
"namespace"
],
"type": "object",
"properties": {
"assessmentIdentifier": {
"description": "A unique number or alphanumeric code assigned to an assessment.",
"type": "string",
"maxLength": 60
},
"namespace": {
"description": "Namespace for the Assessment.",
"type": "string",
"maxLength": 255
}
}
},
"edFi_assessmentScore": {
"required": [
"assessmentReportingMethodDescriptor"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"maximumScore": {
"description": "The maximum score possible on the assessment.",
"type": "string",
"maxLength": 35
},
"minimumScore": {
"description": "The minimum score possible on the assessment.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_assessmentSection": {
"required": [
"sectionReference"
],
"type": "object",
"properties": {
"sectionReference": {
"$ref": "#/definitions/edFi_sectionReference"
}
}
},
"edFi_educationOrganizationReference": {
"required": [
"educationOrganizationId"
],
"type": "object",
"properties": {
"educationOrganizationId": {
"description": "The identifier assigned to an education organization.",
"type": "integer",
"format": "int32"
}
}
},
"edFi_learningObjective": {
"required": [
"learningObjectiveId",
"namespace",
"objective",
"academicSubjects",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"academicSubjects": {
"description": "An unordered collection of learningObjectiveAcademicSubjects. The description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language) of an assessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningObjectiveAcademicSubject"
}
},
"learningObjectiveId": {
"description": "The identifier for the specific learning objective in the context of a standard (e.g., 111.15.3.1.A).",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"namespace": {
"description": "Namespace for the LearningObjective.",
"type": "string",
"maxLength": 255,
"x-Ed-Fi-isIdentity": true
},
"parentLearningObjectiveReference": {
"$ref": "#/definitions/edFi_learningObjectiveReference"
},
"contentStandard": {
"$ref": "#/definitions/edFi_learningObjectiveContentStandard"
},
"description": {
"description": "The description of the LearningObjective.",
"type": "string",
"maxLength": 1024
},
"gradeLevels": {
"description": "An unordered collection of learningObjectiveGradeLevels. The grade level for which the LearningObjective is targeted. The semantics of null is assumed to mean that the learning objective is not associated with any grade level.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningObjectiveGradeLevel"
}
},
"learningStandards": {
"description": "An unordered collection of learningObjectiveLearningStandards. LearningStandard(s) included in this objective.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningObjectiveLearningStandard"
}
},
"nomenclature": {
"description": "Reflects the specific nomenclature used for the LearningObjective.",
"type": "string",
"maxLength": 35
},
"objective": {
"description": "The designated title of the LearningObjective.",
"type": "string",
"maxLength": 60
},
"successCriteria": {
"description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning objective. This criteria gives clear indications as to the degree to which learning is moving through the Zone or Proximal Development toward independent achievement of the LearningObjective.",
"type": "string",
"maxLength": 150
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_learningObjectiveAcademicSubject": {
"required": [
"academicSubjectDescriptor"
],
"type": "object",
"properties": {
"academicSubjectDescriptor": {
"description": "The description of the content or subject area (e.g., arts, mathematics, reading, stenography, or a foreign language) of an assessment.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningObjectiveContentStandard": {
"required": [
"title"
],
"type": "object",
"properties": {
"publicationStatusDescriptor": {
"description": "The publication status of the document (i.e., Adopted, Draft, Published, Deprecated, Unknown).",
"type": "string",
"maxLength": 306
},
"beginDate": {
"description": "The beginning of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"endDate": {
"description": "The end of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"publicationDate": {
"description": "The date on which this content was first published.",
"type": "string",
"format": "date"
},
"publicationYear": {
"description": "The year at which this content was first published.",
"type": "integer",
"format": "int32"
},
"title": {
"description": "The name of the content standard, for example Common Core.",
"type": "string",
"maxLength": 75
},
"uri": {
"description": "An unambiguous reference to the standards using a network-resolvable URI.",
"type": "string",
"maxLength": 255
},
"version": {
"description": "The version identifier for the content.",
"type": "string",
"maxLength": 50
},
"mandatingEducationOrganizationReference": {
"$ref": "#/definitions/edFi_educationOrganizationReference"
},
"authors": {
"description": "An unordered collection of learningObjectiveContentStandardAuthors. The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningObjectiveContentStandardAuthor"
}
}
}
},
"edFi_learningObjectiveContentStandardAuthor": {
"required": [
"author"
],
"type": "object",
"properties": {
"author": {
"description": "The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "string",
"maxLength": 100,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningObjectiveGradeLevel": {
"required": [
"gradeLevelDescriptor"
],
"type": "object",
"properties": {
"gradeLevelDescriptor": {
"description": "The grade level for which the LearningObjective is targeted. The semantics of null is assumed to mean that the learning objective is not associated with any grade level.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningObjectiveLearningStandard": {
"required": [
"learningStandardReference"
],
"type": "object",
"properties": {
"learningStandardReference": {
"$ref": "#/definitions/edFi_learningStandardReference"
}
}
},
"edFi_learningObjectiveReference": {
"required": [
"learningObjectiveId",
"namespace"
],
"type": "object",
"properties": {
"learningObjectiveId": {
"description": "The identifier for the specific learning objective in the context of a standard (e.g., 111.15.3.1.A).",
"type": "string",
"maxLength": 60
},
"namespace": {
"description": "Namespace for the LearningObjective.",
"type": "string",
"maxLength": 255
}
}
},
"edFi_learningStandard": {
"required": [
"learningStandardId",
"description",
"namespace",
"academicSubjects",
"gradeLevels",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"academicSubjects": {
"description": "An unordered collection of learningStandardAcademicSubjects. Subject area for the LearningStandard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandardAcademicSubject"
}
},
"gradeLevels": {
"description": "An unordered collection of learningStandardGradeLevels. The grade levels for the specific learning standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandardGradeLevel"
}
},
"learningStandardId": {
"description": "The identifier for the specific learning standard (e.g., 111.15.3.1.A).",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"parentLearningStandardReference": {
"$ref": "#/definitions/edFi_learningStandardReference"
},
"contentStandard": {
"$ref": "#/definitions/edFi_learningStandardContentStandard"
},
"courseTitle": {
"description": "The official Course Title with which this learning standard is associated.",
"type": "string",
"maxLength": 60
},
"description": {
"description": "The text of the statement. The textual content that either describes a specific competency such as \"Apply the Pythagorean Theorem to determine unknown side lengths in right triangles in real-world and mathematical problems in two and three dimensions.\" or describes a less granular group of competencies within the taxonomy of the standards document, e.g. \"Understand and apply the Pythagorean Theorem,\" or \"Geometry\".",
"type": "string",
"maxLength": 1024
},
"identificationCodes": {
"description": "An unordered collection of learningStandardIdentificationCodes. A coding scheme that is used for identification and record-keeping purposes by schools, social services, or other agencies to refer to a learning standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandardIdentificationCode"
}
},
"learningStandardCategoryDescriptor": {
"description": "An additional classification of the type of a specific learning standard.",
"type": "string",
"maxLength": 306
},
"learningStandardItemCode": {
"description": "A code designated by the promulgating body to identify the statement, e.g. 1.N.3 (usually not globally unique).",
"type": "string",
"maxLength": 60
},
"namespace": {
"description": "Namespace for the LearningStandard.",
"type": "string",
"maxLength": 255
},
"prerequisiteLearningStandards": {
"description": "An unordered collection of learningStandardPrerequisiteLearningStandards. The unique identifier of a prerequisite learning standard item, a competency needed prior to learning this one. (Some items may have no prerequisites others may have one or more prerequisites. This should only be used to represent the immediate predecessors in a competency-based pathway, i.e. not prerequisites of prerequisites).",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandardPrerequisiteLearningStandard"
}
},
"successCriteria": {
"description": "One or more statements that describes the criteria used by teachers and students to check for attainment of a learning standard. This criteria gives clear indications as to the degree to which learning is moving through the Zone or Proximal Development toward independent achievement of the LearningStandard.",
"type": "string",
"maxLength": 150
},
"uri": {
"description": "An unambiguous reference to the statement using a network-resolvable URI.",
"type": "string",
"maxLength": 255
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_learningStandardAcademicSubject": {
"required": [
"academicSubjectDescriptor"
],
"type": "object",
"properties": {
"academicSubjectDescriptor": {
"description": "Subject area for the LearningStandard.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningStandardContentStandard": {
"required": [
"title"
],
"type": "object",
"properties": {
"publicationStatusDescriptor": {
"description": "The publication status of the document (i.e., Adopted, Draft, Published, Deprecated, Unknown).",
"type": "string",
"maxLength": 306
},
"beginDate": {
"description": "The beginning of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"endDate": {
"description": "The end of the period during which this learning standard document is intended for use.",
"type": "string",
"format": "date"
},
"publicationDate": {
"description": "The date on which this content was first published.",
"type": "string",
"format": "date"
},
"publicationYear": {
"description": "The year at which this content was first published.",
"type": "integer",
"format": "int32"
},
"title": {
"description": "The name of the content standard, for example Common Core.",
"type": "string",
"maxLength": 75
},
"uri": {
"description": "An unambiguous reference to the standards using a network-resolvable URI.",
"type": "string",
"maxLength": 255
},
"version": {
"description": "The version identifier for the content.",
"type": "string",
"maxLength": 50
},
"mandatingEducationOrganizationReference": {
"$ref": "#/definitions/edFi_educationOrganizationReference"
},
"authors": {
"description": "An unordered collection of learningStandardContentStandardAuthors. The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_learningStandardContentStandardAuthor"
}
}
}
},
"edFi_learningStandardContentStandardAuthor": {
"required": [
"author"
],
"type": "object",
"properties": {
"author": {
"description": "The person or organization chiefly responsible for the intellectual content of the standard.",
"type": "string",
"maxLength": 100,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningStandardGradeLevel": {
"required": [
"gradeLevelDescriptor"
],
"type": "object",
"properties": {
"gradeLevelDescriptor": {
"description": "The grade levels for the specific learning standard.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningStandardIdentificationCode": {
"required": [
"contentStandardName",
"identificationCode"
],
"type": "object",
"properties": {
"contentStandardName": {
"description": "The name of the content standard, for example Common Core.",
"type": "string",
"maxLength": 65,
"x-Ed-Fi-isIdentity": true
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a Learning Standard.",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_learningStandardPrerequisiteLearningStandard": {
"required": [
"prerequisiteLearningStandardReference"
],
"type": "object",
"properties": {
"prerequisiteLearningStandardReference": {
"$ref": "#/definitions/edFi_learningStandardReference"
}
}
},
"edFi_learningStandardReference": {
"required": [
"learningStandardId"
],
"type": "object",
"properties": {
"learningStandardId": {
"description": "The identifier for the specific learning standard (e.g., 111.15.3.1.A).",
"type": "string",
"maxLength": 60
}
}
},
"edFi_objectiveAssessment": {
"required": [
"identificationCode",
"assessmentReference",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, a state, or other agency or entity.",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"assessmentReference": {
"$ref": "#/definitions/edFi_assessmentReference"
},
"parentObjectiveAssessmentReference": {
"$ref": "#/definitions/edFi_objectiveAssessmentReference"
},
"assessmentItems": {
"description": "An unordered collection of objectiveAssessmentAssessmentItems. References individual test items, if appropriate.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessmentAssessmentItem"
}
},
"description": {
"description": "The description of the ObjectiveAssessment (e.g., vocabulary, measurement, or geometry).",
"type": "string",
"maxLength": 1024
},
"learningObjectives": {
"description": "An unordered collection of objectiveAssessmentLearningObjectives. References the LearningObjective(s) the ObjectiveAssessment tests.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessmentLearningObjective"
}
},
"learningStandards": {
"description": "An unordered collection of objectiveAssessmentLearningStandards. LearningStandard tested by this ObjectiveAssessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessmentLearningStandard"
}
},
"maxRawScore": {
"description": "The maximum raw score achievable across all assessment items that are correct and scored at the maximum.",
"type": "integer",
"format": "int32"
},
"nomenclature": {
"description": "Reflects the specific nomenclature used for this level of ObjectiveAssessment.",
"type": "string",
"maxLength": 35
},
"percentOfAssessment": {
"description": "The percentage of the Assessment that tests this objective.",
"type": "number",
"format": "double"
},
"performanceLevels": {
"description": "An unordered collection of objectiveAssessmentPerformanceLevels. Definition of the performance levels and the associated cut scores. Three styles are supported: 1. Specification of performance level by minimum and maximum score. 2. Specification of performance level by cut score, using only minimum score. 3. Specification of performance level without any mapping to scores",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessmentPerformanceLevel"
}
},
"scores": {
"description": "An unordered collection of objectiveAssessmentScores. Definition of the scores to be expected from this objective assessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_objectiveAssessmentScore"
}
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_objectiveAssessmentAssessmentItem": {
"required": [
"assessmentItemReference"
],
"type": "object",
"properties": {
"assessmentItemReference": {
"$ref": "#/definitions/edFi_assessmentItemReference"
}
}
},
"edFi_objectiveAssessmentLearningObjective": {
"required": [
"learningObjectiveReference"
],
"type": "object",
"properties": {
"learningObjectiveReference": {
"$ref": "#/definitions/edFi_learningObjectiveReference"
}
}
},
"edFi_objectiveAssessmentLearningStandard": {
"required": [
"learningStandardReference"
],
"type": "object",
"properties": {
"learningStandardReference": {
"$ref": "#/definitions/edFi_learningStandardReference"
}
}
},
"edFi_objectiveAssessmentPerformanceLevel": {
"required": [
"assessmentReportingMethodDescriptor",
"performanceLevelDescriptor"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the instructor of the class uses to report the performance and achievement of all students. It may be a qualitative method such as individualized teacher comments or a quantitative method such as a letter or numerical grade. In some cases, more than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelDescriptor": {
"description": "The performance level(s) defined for the assessment.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"maximumScore": {
"description": "The maximum score to make the indicated level of performance.",
"type": "string",
"maxLength": 35
},
"minimumScore": {
"description": "The minimum score required to make the indicated level of performance.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_objectiveAssessmentReference": {
"required": [
"assessmentIdentifier",
"identificationCode",
"namespace"
],
"type": "object",
"properties": {
"assessmentIdentifier": {
"description": "A unique number or alphanumeric code assigned to an assessment.",
"type": "string",
"maxLength": 60
},
"identificationCode": {
"description": "A unique number or alphanumeric code assigned to a space, room, site, building, individual, organization, program, or institution by a school, school system, a state, or other agency or entity.",
"type": "string",
"maxLength": 60
},
"namespace": {
"description": "Namespace for the Assessment.",
"type": "string",
"maxLength": 255
}
}
},
"edFi_objectiveAssessmentScore": {
"required": [
"assessmentReportingMethodDescriptor"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"maximumScore": {
"description": "The maximum score possible on the assessment.",
"type": "string",
"maxLength": 35
},
"minimumScore": {
"description": "The minimum score possible on the assessment.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_programReference": {
"required": [
"educationOrganizationId",
"programName",
"programTypeDescriptor"
],
"type": "object",
"properties": {
"educationOrganizationId": {
"description": "The identifier assigned to an education organization.",
"type": "integer",
"format": "int32"
},
"programName": {
"description": "The formal name of the Program of instruction, training, services, or benefits available through federal, state, or local agencies.",
"type": "string",
"maxLength": 60
},
"programTypeDescriptor": {
"description": "The type of program.",
"type": "string",
"maxLength": 306
}
}
},
"edFi_schoolYearTypeReference": {
"required": [
"schoolYear"
],
"type": "object",
"properties": {
"schoolYear": {
"description": "Key for School Year",
"type": "integer",
"format": "int32"
}
}
},
"edFi_sectionReference": {
"required": [
"localCourseCode",
"schoolId",
"schoolYear",
"sectionIdentifier",
"sessionName"
],
"type": "object",
"properties": {
"localCourseCode": {
"description": "The local code assigned by the School that identifies the course offering provided for the instruction of students.",
"type": "string",
"maxLength": 60
},
"schoolId": {
"description": "The identifier assigned to a school.",
"type": "integer",
"format": "int32"
},
"schoolYear": {
"description": "The identifier for the school year.",
"type": "integer",
"format": "int32"
},
"sectionIdentifier": {
"description": "The local identifier assigned to a section.",
"type": "string",
"maxLength": 255
},
"sessionName": {
"description": "The identifier for the calendar for the academic session (e.g., 2010/11, 2011 Summer).",
"type": "string",
"maxLength": 60
}
}
},
"edFi_studentAssessment": {
"required": [
"studentAssessmentIdentifier",
"administrationDate",
"assessmentReference",
"studentReference",
"id"
],
"type": "object",
"properties": {
"id": {
"description": "A resource identifier that uniquely identifies the resource.",
"type": "string"
},
"studentAssessmentIdentifier": {
"description": "A unique number or alphanumeric code assigned to an assessment administered to a student.",
"type": "string",
"maxLength": 60,
"x-Ed-Fi-isIdentity": true
},
"assessmentReference": {
"$ref": "#/definitions/edFi_assessmentReference"
},
"schoolYearTypeReference": {
"$ref": "#/definitions/edFi_schoolYearTypeReference"
},
"studentReference": {
"$ref": "#/definitions/edFi_studentReference"
},
"accommodations": {
"description": "An unordered collection of studentAssessmentAccommodations. The specific type of special variation used in how an examination is presented, how it is administered, or how the test taker is allowed to respond. This generally refers to changes that do not substantially alter what the examination measures. The proper use of accommodations does not substantially change academic level or performance criteria. For example: Braille, Enlarged monitor view, Extra time, Large Print, Setting, Oral Administration...",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentAccommodation"
}
},
"administrationDate": {
"description": "The date and time an assessment was completed by the student. The use of ISO-8601 formats with a timezone designator (UTC or time offset) is recommended in order to prevent ambiguity due to time zones.",
"type": "string",
"format": "date-time"
},
"administrationEndDate": {
"description": "The date and time an assessment administration ended.",
"type": "string",
"format": "date-time"
},
"administrationEnvironmentDescriptor": {
"description": "The environment in which the test was administered. For example: Electronic, Classroom, Testing Center...",
"type": "string",
"maxLength": 306
},
"administrationLanguageDescriptor": {
"description": "The language in which an assessment is written and/or administered.",
"type": "string",
"maxLength": 306
},
"eventCircumstanceDescriptor": {
"description": "An unusual event occurred during the administration of the assessment. This could include fire alarm, student became ill, etc.",
"type": "string",
"maxLength": 306
},
"eventDescription": {
"description": "Describes special events that occur before during or after the assessment session that may impact use of results.",
"type": "string",
"maxLength": 1024
},
"items": {
"description": "An unordered collection of studentAssessmentItems. The student's response to an assessment item and the item-level scores such as correct, incorrect, or met standard.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentItem"
}
},
"performanceLevels": {
"description": "An unordered collection of studentAssessmentPerformanceLevels. The performance level(s) achieved for the StudentAssessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentPerformanceLevel"
}
},
"reasonNotTestedDescriptor": {
"description": "The primary reason student is not tested. For example: Absent, Refusal by parent, Refusal by student, Medical waiver, Illness, Disruptive behavior, LEP Exempt...",
"type": "string",
"maxLength": 306
},
"retestIndicatorDescriptor": {
"description": "Indicator if the test was retaken. For example: Primary administration, First retest, Second retest...",
"type": "string",
"maxLength": 306
},
"scoreResults": {
"description": "An unordered collection of studentAssessmentScoreResults. A meaningful score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentScoreResult"
}
},
"serialNumber": {
"description": "The unique number for the assessment form or answer document.",
"type": "string",
"maxLength": 60
},
"studentObjectiveAssessments": {
"description": "An unordered collection of studentAssessmentStudentObjectiveAssessments. The student's score and/or performance levels earned for an ObjectiveAssessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentStudentObjectiveAssessment"
}
},
"whenAssessedGradeLevelDescriptor": {
"description": "The grade level of a student when assessed.",
"type": "string",
"maxLength": 306
},
"_etag": {
"description": "A unique system-generated value that identifies the version of the resource.",
"type": "string"
}
}
},
"edFi_studentAssessmentAccommodation": {
"required": [
"accommodationDescriptor"
],
"type": "object",
"properties": {
"accommodationDescriptor": {
"description": "The specific type of special variation used in how an examination is presented, how it is administered, or how the test taker is allowed to respond. This generally refers to changes that do not substantially alter what the examination measures. The proper use of accommodations does not substantially change academic level or performance criteria. For example: Braille, Enlarged monitor view, Extra time, Large Print, Setting Oral Administration...",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
}
}
},
"edFi_studentAssessmentItem": {
"required": [
"assessmentItemResultDescriptor",
"assessmentItemReference"
],
"type": "object",
"properties": {
"assessmentItemResultDescriptor": {
"description": "The analyzed result of a student's response to an assessment item. For example: Correct, Incorrect, Met standard...",
"type": "string",
"maxLength": 306
},
"responseIndicatorDescriptor": {
"description": "Indicator of the response. For example: Nonscorable response, Ineffective response, Effective response, Partial response...",
"type": "string",
"maxLength": 306
},
"assessmentResponse": {
"description": "A student's response to a stimulus on a test.",
"type": "string",
"maxLength": 60
},
"descriptiveFeedback": {
"description": "The formative descriptive feedback that was given to a learner in response to the results from a scored/evaluated assessment item.",
"type": "string",
"maxLength": 1024
},
"rawScoreResult": {
"description": "A meaningful raw score of the performance of an individual on an assessment item.",
"type": "integer",
"format": "int32"
},
"timeAssessed": {
"description": "The overall time a student actually spent during the AssessmentItem.",
"type": "string",
"maxLength": 30
},
"assessmentItemReference": {
"$ref": "#/definitions/edFi_assessmentItemReference"
}
}
},
"edFi_studentAssessmentPerformanceLevel": {
"required": [
"assessmentReportingMethodDescriptor",
"performanceLevelDescriptor",
"performanceLevelMet"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the instructor of the class uses to report the performance and achievement. It may be a qualitative method such as individualized teacher comments or a quantitative method such as a letter or numerical grade. In some cases, more than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelDescriptor": {
"description": "A specification of which performance level value describes the student proficiency.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelMet": {
"description": "Optional indicator of whether the performance level was met.",
"type": "boolean"
}
}
},
"edFi_studentAssessmentScoreResult": {
"required": [
"assessmentReportingMethodDescriptor",
"resultDatatypeTypeDescriptor",
"result"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"result": {
"description": "The value of a meaningful raw score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_studentAssessmentStudentObjectiveAssessment": {
"required": [
"objectiveAssessmentReference",
"scoreResults"
],
"type": "object",
"properties": {
"objectiveAssessmentReference": {
"$ref": "#/definitions/edFi_objectiveAssessmentReference"
},
"performanceLevels": {
"description": "An unordered collection of studentAssessmentStudentObjectiveAssessmentPerformanceLevels. The PerformanceLevel(s) achieved for the ObjectiveAssessment.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentStudentObjectiveAssessmentPerformanceLevel"
}
},
"scoreResults": {
"description": "An unordered collection of studentAssessmentStudentObjectiveAssessmentScoreResults. A meaningful score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc.",
"type": "array",
"items": {
"$ref": "#/definitions/edFi_studentAssessmentStudentObjectiveAssessmentScoreResult"
}
}
}
},
"edFi_studentAssessmentStudentObjectiveAssessmentPerformanceLevel": {
"required": [
"assessmentReportingMethodDescriptor",
"performanceLevelDescriptor",
"performanceLevelMet"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the instructor of the class uses to report the performance and achievement. It may be a qualitative method such as individualized teacher comments or a quantitative method such as a letter or numerical grade. In some cases, more than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelDescriptor": {
"description": "A specification of which performance level value describes the student proficiency.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"performanceLevelMet": {
"description": "Optional indicator of whether the performance level was met.",
"type": "boolean"
}
}
},
"edFi_studentAssessmentStudentObjectiveAssessmentScoreResult": {
"required": [
"assessmentReportingMethodDescriptor",
"resultDatatypeTypeDescriptor",
"result"
],
"type": "object",
"properties": {
"assessmentReportingMethodDescriptor": {
"description": "The method that the administrator of the assessment uses to report the performance and achievement of all students. It may be a qualitative method such as performance level descriptors or a quantitative method such as a numerical grade or cut score. More than one type of reporting method may be used.",
"type": "string",
"maxLength": 306,
"x-Ed-Fi-isIdentity": true
},
"resultDatatypeTypeDescriptor": {
"description": "The datatype of the result. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 306
},
"result": {
"description": "The value of a meaningful raw score or statistical expression of the performance of an individual. The results can be expressed as a number, percentile, range, level, etc.",
"type": "string",
"maxLength": 35
}
}
},
"edFi_studentReference": {
"required": [
"studentUniqueId"
],
"type": "object",
"properties": {
"studentUniqueId": {
"description": "A unique alphanumeric code assigned to a student.",
"type": "string",
"maxLength": 32
}
}
}
},
"parameters": {
"offset": {
"name": "offset",
"in": "query",
"description": "Indicates how many items should be skipped before returning results.",
"required": false,
"type": "integer",
"format": "int32",
"default": 0
},
"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",
"minItems": 1,
"maxItems": 100,
"default": 25
},
"If-None-Match": {
"name": "If-None-Match",
"in": "header",
"description": "The previously returned ETag header value, used here to prevent the unnecessary data transfer of an unchanged resource.",
"required": false,
"type": "string"
},
"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. An ETag value is available in the ETag header, and the location of the resource is available in the Location header of the response."
},
"Updated": {
"description": "The resource was updated. An updated ETag value is available in the ETag header of the response."
},
"Deleted": {
"description": "The resource was successfully deleted."
},
"NotModified": {
"description": "The resource's current server-side ETag value matched the If-None-Match header value supplied with the request indicating 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's current server-side ETag value does not match the supplied If-Match header value in the request. This indicates the resource has been modified by another consumer."
},
"Error": {
"description": "An unhandled error occurred on the server. See the response body for details."
}
}
}