--- updatedAt: 2026-04-21T15:07:44.000Z agentTools: projectIndex: https://dev.clever.com/llms.txt --- # API v3.1 Updates Review the data model changes, student demographic fields, LMS Connect updates, and access requirements introduced in Clever API v3.1. > ❗️ Clever Complete Agreement Required > > This feature is included with a Clever Complete subscription. Sign up [here](https://www.clever.com/developer-signup) or email your Application Success Manager to learn more. # Table of Contents [General](https://dev.clever.com/docs/api-v31#general)\ [Data Model Changes](https://dev.clever.com/docs/api-v31#data-model-changes)\ [LMS Connect](https://dev.clever.com/docs/api-v31#lms-connect)\ [API v3.1 Access](https://dev.clever.com/docs/api-v31#api-v31-access) *** # General Clever's API v3.1 adds a number of fields and values to the student user object to support better sharing of demographics data between districts and applications. API v3.1 will only contain non-breaking changes, so integrations built on API v3.0 can easily be upgraded to use the new fields. API v3.1 adds these student demographic updates: * `roles.student.gifted_status` * `roles.student.section_504_status` * `roles.student.disability.disability_status` * `roles.student.disability.disability_type` * `roles.student.disability.disability_code` * `roles.student.home_language_code` * `roles.student.frl_status` now also supports `"Other"` *** # Data Model Changes ## New fields [block:parameters] { "data": { "h-0": "Field Name", "h-1": "Description", "h-2": "Possible Values", "0-0": "roles.student.gifted_status", "0-1": "From CEDS [element 000122](https://ceds.ed.gov/element/000122): An indication that the student is participating in and served by a Gifted/Talented program", "0-2": "[\"Y\", \"N\", \"\"]", "1-0": "roles.student.section_504_status", "1-1": "From CEDS [element 000249](https://ceds.ed.gov/element/000249): Individuals with disabilities who are being provided with related aids and services under Section 504 of the Rehabilitation Act of 1973, as amended", "1-2": "[\"Y\", \"N\", \"\"]", "2-0": "roles.student.disability.disability_status", "2-1": "From CEDS [element 000577](https://ceds.ed.gov/element/000577): An indication of whether a person is classified as disabled under the American's with Disability Act (ADA)", "2-2": "[\"Y\", \"N\", \"\"]", "3-0": "roles.student.disability.disability_type", "3-1": "From CEDS [element 000218](https://ceds.ed.gov/element/000218): The major or overriding disability condition that best describes a person's impairment", "3-2": "[\"Autism\", \n\"Deaf-blindness\", \n\"Developmental delay\", \n\"Emotional disturbance\", \n\"Hearing impairment\", \n\"Intellectual Disability\", \n\"Multiple disabilities\", \n\"Orthopedic impairment\", \n\"Other health impairment\", \n\"Specific learning disability\", \n\"Speech or language impairment\", \n\"Traumatic brain injury\", \n\"Visual impairment\", \n\"\"]", "4-0": "roles.student.disability.disability_code", "4-1": "Primary disability type code", "4-2": "[\"AUT\", \n\"DB\", \n\"DD\", \n\"EMN\", \n\"HI\", \n\"ID\", \n\"MD\", \n\"OI\", \n\"OHI\", \n\"SLD\", \n\"SLI\", \n\"TBI\", \n\"VI\", \n\"\"]" }, "cols": 3, "rows": 5, "align": [ "left", "left", "left" ] } [/block] ## Home Language The Home Language field will now be aligned with the [ISO 639-3 standard](http://www-01.sil.org/iso639-3/default.asp), containing a subset of the total languages available in that standard. The language name will be provided in the existing "home\_language" field, while a new "home\_language\_code" field will contain the three-letter language code. The Home Language values and codes supported in API v3.1 are: [block:parameters] { "data": { "h-0": "roles.student.home_language values", "h-1": "roles.student.home_language_code values", "0-0": "English \nAfrikaans \nAlbanian \nAmharic \nArabic \nArmenian \nAzerbaijani \nBasque \nBelarusian \nBengali \nBosnian \nBulgarian \nBurmese \nCabo Verdean \nCantonese \nCatalan \nCebuano \nChichewa \nChinese \nCorsican \nCroatian \nCzech \nDanish \nDari \nDutch \nEstonian \nFarsi \nFilipino \nFinnish \nFrench \nFrisian \nGalician \nGeorgian \nGerman \nGreek \nGujarati \nHaitian Creole \nHausa \nHawaiian \nHebrew \nHindi \nHmong \nHungarian \nIlocano \nIcelandic \nIgbo \nIndonesian \nIrish \nItalian \nJapanese \nJavanese \nKannada \nKaren \nKazakh \nKhmer \nKinyarwanda \nKorean \nKurdish (Kurmanji) \nKyrgyz \nLaotian \nLatvian \nLithuanian \nLuxembourgish \nMacedonian \nMalagasy \nMalay \nMalayalam \nMaltese \nMandarin \nMaori \nMarathi \nMarshallese \nMongolian \nNepali \nNorwegian \nOdia \nOromo \nPashto \nPolish \nPortuguese \nPunjabi \nRomanian \nRussian \nSamoan \nScots Gaelic \nSerbian \nSesotho \nShona \nSindhi \nSinhala \nSlovak \nSlovenian \nSomali \nSpanish \nSundanese \nSwahili \nSwedish \nTagalog \nTajik \nTamil \nTatar \nTelugu \nThai \nTigrinya \nTurkish \nTurkmen \nUkrainian \nUrdu \nUyghur \nUzbek \nVietnamese \nWelsh \nXhosa \nYiddish \nYoruba \nZulu", "0-1": "eng \nafr \nsqi \namh \nara \nhye \naze \neus \nbel \nben \nbos \nbul \nmya \ncpp \nyue \ncat \nceb \nnya \nchi \ncos \nhrv \nces \ndan \nprs \nnld \nest \nfas \nfil \nfin \nfra \nfry \nglg \nkat \ndeu \nell \nguj \nhat \nhau \nhaw \nheb \nhin \nhmn \nhun \nilo \nisl \nibo \nind \ngle \nita \njpn \njav \nkan \nkar \nkaz \nkhm \nkin \nkor \nkur \nkir \nlao \nlav \nlit \nltz \nmkd \nmlg \nmsa \nmal \nmlt \ncmn \nmri \nmar \nmah \nmon \nnep \nnob \nori \norm \npus \npol \npor \npan \nron \nrus \nsmo \ngla \nsrp \nsot \nsna \nsnd \nsin \nslk \nslv \nsom \nspa \nsun \nswa \nswe \ntgl \ntgk \ntam \ntat \ntel \ntha \ntir \ntur \ntuk \nukr \nurd \nuig \nuzb \nvie \ncym \nxho \nyid \nyor \nzul" }, "cols": 2, "rows": 1, "align": [ "left", "left" ] } [/block] ## Additional changes | Field Name | v3.0 Values | v3.1 Values | | :------------------------ | :------------------------------- | :-------------------------------------------- | | roles.student.frl\_status | \["Free", "Reduced", "Paid", ""] | \["Free", "Reduced", "Paid", **"Other"**, ""] | *** # LMS Connect With API v3.1 of the Clever API, we introduce the LMS Connect integration. This integration extends our existing rostering capabilities and supports assignment and grade passback from your application, through Clever and into a district LMS. Currently, the LMSs supported are Canvas, Schoology, and Google Classroom. However, we are always looking to expand our offerings! If you have any requests for support of a specific LMS that's not listed above, please reach out to your success manager or .\ More on LMS Connect can be found [here](https://dev.clever.com/docs/lms-connect-overview) *** # API v3.1 Access If you are interested in v3.1 access, please contact your application success manager or contact the Clever Partner Engineering Team at