openapi: 3.0.0 info: description: Serves the Clever Data API title: Data Assignments Resources API version: 3.1.0 servers: - url: https://api.clever.com/v3.1 security: - oauth: [] tags: - name: Resources paths: /resources: get: description: Returns a list of resources operationId: getResources parameters: - in: query name: limit schema: type: integer - in: query name: starting_after schema: type: string - in: query name: ending_before schema: type: string responses: '200': description: OK Response content: application/json: schema: $ref: '#/components/schemas/ResourcesResponse' tags: - Resources /resources/{id}: get: description: Returns a specific resource operationId: getResource parameters: - in: path name: id required: true schema: type: string responses: '200': description: OK Response content: application/json: schema: $ref: '#/components/schemas/ResourceResponse' '404': $ref: '#/components/responses/NotFound' tags: - Resources /resources/{id}/courses: get: description: Returns the courses for a resource operationId: getCoursesForResource parameters: - in: path name: id required: true schema: type: string - in: query name: limit schema: type: integer - in: query name: starting_after schema: type: string - in: query name: ending_before schema: type: string responses: '200': description: OK Response content: application/json: schema: $ref: '#/components/schemas/CoursesResponse' '404': $ref: '#/components/responses/NotFound' tags: - Resources /resources/{id}/sections: get: description: Returns the sections for a resource operationId: getSectionsForResource parameters: - in: path name: id required: true schema: type: string - in: query name: limit schema: type: integer - in: query name: starting_after schema: type: string - in: query name: ending_before schema: type: string responses: '200': description: OK Response content: application/json: schema: $ref: '#/components/schemas/SectionsResponse' '404': $ref: '#/components/responses/NotFound' tags: - Resources /resources/{id}/users: get: description: Returns the student and/or teacher users for a resource operationId: getUsersForResource parameters: - in: path name: id required: true schema: type: string - in: query name: role schema: type: string enum: - student - teacher - in: query name: limit schema: type: integer - in: query name: starting_after schema: type: string - in: query name: ending_before schema: type: string responses: '200': description: OK Response content: application/json: schema: $ref: '#/components/schemas/UsersResponse' '404': $ref: '#/components/responses/NotFound' tags: - Resources components: schemas: Resource: properties: created: format: date-time type: string district: type: string id: type: string resource_id: type: string roles: items: enum: - teacher - student type: string type: array title: type: string updated: format: date-time type: string type: object SectionsResponse: properties: data: items: $ref: '#/components/schemas/SectionResponse' type: array links: items: $ref: '#/components/schemas/Link' type: array type: object Course: properties: district: type: string x-validation: true id: type: string x-validation: true name: type: string nullable: true number: type: string nullable: true type: object Contact: properties: legacy_id: type: string x-validation: true phone: type: string nullable: true phone_type: enum: - Cell - Home - Work - Other - '' type: string x-validation: true nullable: true sis_id: type: string nullable: true student_relationships: items: $ref: '#/components/schemas/StudentRelationship' type: array x-validation: true type: object NotFound: properties: message: type: string type: object Student: properties: created: format: datetime type: string x-validation: true credentials: $ref: '#/components/schemas/Credentials' disability: $ref: '#/components/schemas/Disability' dob: pattern: (?:[0-9]{1,2})/([0-9]{1,2})/([0-9]{4}) type: string x-validation: true nullable: true ell_status: enum: - Y - N - '' type: string x-validation: true nullable: true enrollments: items: $ref: '#/components/schemas/SchoolEnrollment' type: array x-validation: true ext: type: object frl_status: enum: - Free - Reduced - Paid - Other - '' type: string x-validation: true nullable: true gender: enum: - M - F - X - '' type: string x-validation: true nullable: true gifted_status: enum: - Y - N - '' type: string x-validation: true nullable: true grade: enum: - InfantToddler - Preschool - PreKindergarten - TransitionalKindergarten - Kindergarten - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '8' - '9' - '10' - '11' - '12' - '13' - PostGraduate - Ungraded - Other - '' type: string x-validation: true nullable: true graduation_year: type: string x-validation: true nullable: true hispanic_ethnicity: enum: - Y - N - '' type: string x-validation: true nullable: true home_language: enum: - Kannada - Icelandic - Shona - Hmong - Zulu - Malay - Estonian - Quechua - Fijian - Slovenian - Swedish - Inuinnaqtun - Yucatec Maya - Tamil - Nepali - Cantonese - Arabic - Welsh - Gujarati - Tigrinya - Dutch - Queretaro Otomi - Indonesian - Lingala - Kazakh - Somali - Yoruba - Bhojpuri - Javanese - Other - Hawaiian - Portuguese - Twi - Igbo - Tsonga - Upper Sorbian - Belarusian - Thai - Faroese - Lithuanian - Georgian - Sindhi - Albanian - Haitian Creole - Hausa - Azerbaijani - Tongan - Cabo Verdean - Corsican - Uzbek - Russian - Greek - Hungarian - Guarani - Kirundi - Mizo - Divehi - Pashto - Ewe - English - Bengali - Maithili - Irish - Bashkir - Inuktitut - Maori - Tatar - Hebrew - Punjabi - Chinese - Krio - Khmer - Setswana - Oromo - Tagalog - Armenian - Konkani - Urdu - Karen - Mandarin - Marshallese - Turkish - Ilocano - Chuukese - Croatian - Spanish - Scots Gaelic - Mongolian - Serbian - Chichewa - Dari - Korean - Cebuano - Afrikaans - French - Macedonian - Laotian - Malayalam - Samoan - Tibetan - Aymara - Italian - Yiddish - Telugu - Norwegian - Tajik - Lower Sorbian - German - Sundanese - Bosnian - Luxembourgish - Turkmen - Kurdish (Kurmanji) - Amharic - Bambara - Sinhala - Farsi - Finnish - Catalan - Frisian - Odia - Marathi - Vietnamese - Ukrainian - Czech - Luganda - Galician - Basque - Kurdish (Sorani) - Romanian - Uyghur - Tahitian - Bulgarian - Hindi - Japanese - Burmese - Dogri - Xhosa - Latvian - Polish - Manipuri - Danish - Sesotho - Filipino - Northern Sotho - Assamese - Kinyarwanda - Swahili - Malagasy - Maltese - Kyrgyz - Slovak type: string x-validation: true nullable: true home_language_code: enum: - knn - uig - bam - div - msa - sna - swa - ces - kaz - tsn - tam - xho - cos - est - isl - pus - slk - twi - ibo - iku - mlg - sot - tah - mai - mri - orm - slv - swe - tso - bul - tur - ceb - hin - kat - som - bod - kur - snd - tat - yor - fas - heb - lug - hsb - sqi - glg - khm - mlt - spa - gle - gla - bel - bho - nld - ewe - deu - hat - tgl - eus - hau - jav - aym - fil - fry - ita - lav - mni - mon - ron - chk - hrv - uzb - afr - ilo - nso - pol - otq - yid - fra - ckb - sun - other - fin - nep - pan - rus - amh - nya - ell - hun - ikt - mkd - que - tel - bos - ind - tha - eng - prs - jpn - nob - ori - hye - aze - cat - grn - run - kir - lao - lit - mya - yue - dgo - ltz - cmn - mar - mah - lus - ben - zho - hmn - kar - kor - tgk - ton - vie - asm - cpp - kan - tuk - ukr - urd - zul - ara - bak - dan - fao - kin - lin - srp - cym - fij - guj - kri - mal - sin - yua - haw - dsb - por - smo - tir type: string x-validation: true nullable: true iep_status: type: string nullable: true last_modified: format: datetime type: string x-validation: true legacy_id: type: string x-validation: true location: $ref: '#/components/schemas/Location' preferred_name: $ref: '#/components/schemas/PreferredName' race: enum: - Caucasian - Asian - Black or African American - American Indian - Hawaiian or Other Pacific Islander - Two or More Races - Unknown - '' type: string x-validation: true nullable: true school: type: string x-validation: true schools: items: type: string type: array x-validation: true section_504_status: enum: - Y - N - '' type: string x-validation: true nullable: true sis_id: type: string state_id: type: string nullable: true student_number: type: string nullable: true type: object SectionResponse: properties: data: $ref: '#/components/schemas/Section' type: object Credentials: properties: district_username: type: string type: object Teacher: properties: created: format: datetime type: string x-validation: true credentials: $ref: '#/components/schemas/Credentials' district: type: string x-validation: true ext: type: object last_modified: format: datetime type: string x-validation: true legacy_id: type: string x-validation: true name: $ref: '#/components/schemas/Name' school: type: string x-validation: true schools: items: type: string type: array x-validation: true sis_id: type: string state_id: type: string nullable: true teacher_number: type: string nullable: true title: type: string nullable: true type: object Section: properties: course: type: string x-validation: true nullable: true created: format: datetime type: string x-validation: true district: type: string x-validation: true ext: type: object grade: enum: - InfantToddler - Preschool - PreKindergarten - TransitionalKindergarten - Kindergarten - '1' - '2' - '3' - '4' - '5' - '6' - '7' - '8' - '9' - '10' - '11' - '12' - '13' - PostGraduate - Ungraded - Other - '' type: string x-validation: true nullable: true id: type: string x-validation: true last_modified: format: datetime type: string x-validation: true lms_status: $ref: '#/components/schemas/LmsStatus' name: type: string period: type: string nullable: true school: type: string x-validation: true section_number: type: string nullable: true sis_id: type: string students: items: type: string type: array x-validation: true subject: enum: - english/language arts - math - science - social studies - language - homeroom/advisory - interventions/online learning - technology and engineering - PE and health - arts and music - other - '' type: string x-validation: true nullable: true teacher: type: string x-validation: true nullable: true teachers: items: type: string type: array x-validation: true term_id: type: string x-validation: true nullable: true type: object Location: properties: address: type: string nullable: true city: type: string nullable: true lat: type: string nullable: true lon: type: string nullable: true state: type: string nullable: true zip: type: string nullable: true type: object ResourcesResponse: properties: data: items: $ref: '#/components/schemas/ResourceResponse' type: array links: items: $ref: '#/components/schemas/Link' type: array type: object Staff: properties: credentials: $ref: '#/components/schemas/Credentials' department: type: string nullable: true ext: type: object legacy_id: type: string x-validation: true roles: items: type: string type: array x-validation: true schools: items: type: string type: array x-validation: true staff_id: type: string title: type: string nullable: true type: object CourseResponse: properties: data: $ref: '#/components/schemas/Course' type: object StudentRelationship: properties: relationship: enum: - Parent - Grandparent - Self - Aunt/Uncle - Sibling - Other - '' type: string x-validation: true nullable: true student: type: string x-validation: true type: enum: - Parent/Guardian - Emergency - Primary - Secondary - Family - Other - '' type: string x-validation: true nullable: true type: object CoursesResponse: properties: data: items: $ref: '#/components/schemas/CourseResponse' type: array links: items: $ref: '#/components/schemas/Link' type: array type: object DistrictAdmin: properties: legacy_id: type: string x-validation: true title: type: string nullable: true type: object ResourceResponse: properties: data: $ref: '#/components/schemas/Resource' type: object Name: properties: first: type: string nullable: true last: type: string nullable: true middle: type: string nullable: true type: object Roles: properties: contact: $ref: '#/components/schemas/Contact' district_admin: $ref: '#/components/schemas/DistrictAdmin' staff: $ref: '#/components/schemas/Staff' student: $ref: '#/components/schemas/Student' teacher: $ref: '#/components/schemas/Teacher' User: properties: created: format: datetime type: string x-validation: true district: type: string x-validation: true email: type: string nullable: true id: type: string x-validation: true last_modified: format: datetime type: string x-validation: true lms_status: $ref: '#/components/schemas/LmsStatus' name: $ref: '#/components/schemas/Name' roles: $ref: '#/components/schemas/Roles' type: object UserResponse: properties: data: $ref: '#/components/schemas/User' type: object SchoolEnrollment: properties: end_date: format: datetime type: string x-validation: true school: type: string x-validation: true start_date: format: datetime type: string x-validation: true type: object Disability: properties: disability_code: enum: - aut - db - dd - emn - hi - id - md - oi - other - ohi - sld - sli - tbi - vi type: string nullable: true disability_status: enum: - Y - N - '' type: string nullable: true disability_type: enum: - Autism - Deaf-blindness - Developmental delay - Emotional disturbance - Hearing impairment - Intellectual Disability - Multiple disabilities - Orthopedic impairment - Other - Other health impairment - Specific learning disability - Speech or language impairment - Traumatic brain injury - Visual impairment type: string nullable: true type: object LmsStatus: properties: synced_in_lms: type: boolean type: object Link: properties: rel: enum: - next - prev - self type: string uri: type: string type: object PreferredName: properties: first: type: string nullable: true last: type: string nullable: true middle: type: string nullable: true type: object UsersResponse: properties: data: items: $ref: '#/components/schemas/UserResponse' type: array links: items: $ref: '#/components/schemas/Link' type: array type: object responses: NotFound: description: Entity Not Found content: application/json: schema: $ref: '#/components/schemas/NotFound' securitySchemes: oauth: type: oauth2 flows: authorizationCode: authorizationUrl: https://clever.com/oauth/authorize tokenUrl: https://clever.com/oauth/tokens scopes: {} x-samples-languages: - curl - node - ruby - python - php - java - go