# M1_ACADEMIC_RECORD --- title: M1_ACADEMIC_RECORD description: A standardized academic transcript format based on the EDI (Electronic Data Interchange) 130 standard. This schema represents a comprehensive student academic record/transcript that includes course information, grades, academic achievements, and other educational data exchanged between academic institutions. --- A standardized academic transcript format based on the EDI (Electronic Data Interchange) 130 standard. This schema represents a comprehensive student academic record/transcript that includes course information, grades, academic achievements, and other educational data exchanged between academic institutions. The format supports both high school and college/university transcripts. {% json-schema schema={ "summary": "M1_TRANSCRIPT SCHEMA", "description": "Represents an academic record of an Individual. In other words, M1_ACADEMIC_RECORD is an equivalent of a transcript comprising one or more degrees from the same educational institution. You can use the `items/get_by_id` endpoint to parse a transcript", "tags": [ "M1_TRANSCRIPT" ], "type": "object", "properties": { "transcript_date": { "type": "string", "format": "MM/DD/YYYY", "description": "Date on which the transcript was issued. `transcript_date` should not be a future date" }, "student_id": { "type": "string", "description": "Unique, school-provided Student ID" }, "other_attributes": { "type": "object", "description": "Any other Attributes which are not defined in M1 TRANSCRIPT" }, "student": { "type": "object", "description": "Object with information about the Individual, as provided on the transcript", "properties": { "first_name": { "type": "string", "description": "First name of the student" }, "last_name": { "type": "string", "description": "Last name of the student" }, "middle_name": { "type": "string", "description": "Middle name of the student" }, "prefix": { "type": "string", "description": "Prefix to the name" }, "suffix": { "type": "string", "description": "Suffix to the name" }, "full_name": { "type": "string", "description": "Full name of the student" }, "former_first_name": { "type": "string", "description": "Former first name" }, "former_middle_name": { "type": "string", "description": "Former middle name" }, "former_last_name": { "type": "string", "description": "Former last name" }, "former_full_name": { "type": "string", "description": "Former full name" }, "former_suffix": { "type": "string", "description": "Suffix to the former name" }, "former_prefix": { "type": "string", "description": "Prefix to the former name" }, "date_of_birth": { "type": "string", "description": "Birthdate of the student" }, "ssn": { "type": "string", "description": "SSN of the student" }, "email": { "type": "string", "description": "Email address of the student, as provided on the transcript" }, "address": { "type": "object", "description": "Student's Address information as provided on the transcript", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "description": "Country information", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } } } }, "pgc": { "type": "array", "description": "List of parent/guardian/counselor information on the transcript", "items": { "properties": { "individual_type": { "type": "string", "description": "Type of Individual. Enum `PARENT_GUARDIAN`, `COUNSELOR`" }, "first_name": { "type": "string", "description": "First name of the Individual" }, "last_name": { "type": "string", "description": "Last name of the Individual" }, "middle_name": { "type": "string", "description": "Middle name of the Individual" }, "prefix": { "type": "string", "description": "Prefix to the name" }, "suffix": { "type": "string", "description": "Suffix to the name" }, "full_name": { "type": "string", "description": "Full name of the Individual" }, "former_first_name": { "type": "string", "description": "Former first name" }, "former_middle_name": { "type": "string", "description": "Former middle name" }, "former_last_name": { "type": "string", "description": "Former last name" }, "former_full_name": { "type": "string", "description": "Former full name" }, "former_suffix": { "type": "string", "description": "Suffix to the former name" }, "former_prefix": { "type": "string", "description": "Prefix to the former name" }, "date_of_birth": { "type": "string", "description": "Birthdate of the Individual" }, "ssn": { "type": "string", "description": "SSN of the Individual" }, "email": { "type": "string", "description": "Email address of the Individual, as provided on the transcript" }, "address": { "type": "object", "description": "Individual's Address information as provided on the transcript", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "description": "Country information", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } } } } }, "immunizations": { "type": "array", "description": "List of immunization provided on the transcript", "items": { "properties": { "code": { "type": "string", "description": "Code identifying the type of immunization" }, "name": { "type": "string", "description": "Name of the immunization" }, "date": { "type": "string", "description": "Immunization date" }, "status_code": { "type": "string", "description": "Code identifying the status of immunization conducted on student" }, "report_type_code": { "type": "string", "description": "Code identifying the record used to verify immunization of student" } } } }, "test_records": { "type": "array", "description": "List of national, regional, state, or local test records provided on the transcript", "items": { "properties": { "name": { "type": "string", "description": "Name of the test" }, "date": { "type": "string", "description": "Test date" }, "code": { "type": "string", "description": "Code identifying the type of test" }, "subsets": { "type": "array", "description": "List of subsets provided on the transcript", "items": { "properties": { "name": { "type": "string", "description": "Name of the subset" }, "score": { "type": "string", "description": "Test score" }, "score_qualifier": { "type": "string", "description": "Code indicating the manner in which the test score result is reported" } } } } } } }, "previous_academic_record": { "type": "array", "description": "List of previous academic records provided on the transcript", "items": { "properties": { "name": { "type": "string", "description": "Name of the institution" }, "id_type": { "type": "string", "description": "ID Type of the institutionEnum `IPEDS`, `CEEB`" }, "id": { "type": "string", "description": "Unique identifier of the institution" }, "start_date": { "type": "string", "description": "Start date of the program" }, "end_date": { "type": "string", "description": "End date of the program" }, "address": { "type": "object", "description": "Student's Address information as provided for previous academic record", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "description": "Country information", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } }, "degrees": { "type": "array", "description": "List of degrees found in this academic record", "items": { "properties": { "type": { "type": "string", "description": "Level of the degree. Enum `HIGH-SCHOOL-DIPLOMA`, `ASSOCIATE`, `BACHELORS`, `MASTERS`, `MASTERS-RESEARCH`, `DOCTORAL`, `CERTIFICATE`, `DIPLOMA`, `NON-DEGREE`, `PROFESSIONAL`, `UNDERGRADUATE`, `UNKNOWN`" }, "description": { "type": "string", "description": "Name of the degree" }, "status": { "type": "string", "description": "Status of the degree. Enum `AWARDED`, `ENROLLED`, `WITHDRAWN`, `TERMINATED`, `UNKNOWN`" }, "awarded_date": { "type": "string", "description": "Degree awarded date (applicable to graduates only)" }, "years_of_study": { "type": "number", "description": "Number of years of study for the given degree" }, "other_attributes": { "type": "object" }, "academic_summary": { "type": "array", "description": "Summary information about the degree", "items": { "properties": { "credit_type": { "type": "string", "description": "Type of credit used. Enum `SEMESTER`, `QUARTER`, `UNITS`, `CLOCK_HOURS`, `CARNEGIE_UNITS`, `CONTINUING_EDUCATION_UNIT`, `HIGHSCHOOL_CREDIT`, `OTHER`" }, "level": { "type": "string", "description": "The level of the academic summary. Enum `INSTITUTION`, `TRANSFER`, `TOTAL`" }, "cumulative": { "type": "boolean", "description": "Boolean indicating whether the summary is cumulative" }, "gpa_credits": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "attempted": { "type": "number", "description": "Credits attempted. Should be a non negative number, if available" }, "earned": { "type": "number", "description": "Credits earned. Should be a non negative number, if available" }, "gpa_range": { "type": "object", "description": "GPA range for School/University", "properties": { "minimum": { "type": "number", "description": "minimum value for GPA" }, "maximum": { "type": "number", "description": "maximum value for GPA" } } }, "gpa": { "type": "number", "description": "Grade Point Average. Should be a non negative number, if available" }, "quality_points": { "type": "number", "description": "Quality points for grade, used in GPA calculation. Should be a non negative number, if available" }, "student_rank": { "type": "number", "description": "Student rank" }, "class_size": { "type": "number", "description": "Number of students in the class" }, "rank_date": { "type": "string", "description": "Class rank date" }, "days_attended": { "type": "string", "description": "Days student attended class" }, "days_absent": { "type": "string", "description": "Days student absent in class" } } } }, "field_of_study": { "type": "array", "description": "List of objects with information about the field of study", "items": { "properties": { "type": { "type": "string", "description": "Type of study. Enum `MAJOR`,`MINOR`,`CONCENTRATION`" }, "description": { "type": "string", "description": "Name of the field of study" }, "code_type": { "type": "string", "description": "Type of the code used for identifying the field of study E.g. CIP, HEGIS, OTHER" }, "code": { "type": "number", "description": "Specifies the code for the field of study associated with the academic record." } } } } } } } } } }, "transcript_institution": { "deprecated": true, "type": "object", "description": "Object with information about the institution for which the transcript was issued", "properties": { "name": { "type": "string", "description": "Name of the institution" }, "id_type": { "type": "string", "description": "Type of ID used to identify given institution Enum `IPEDS`,`CEEB`" }, "id": { "type": "string", "description": "Unique identifier of the institute" }, "address": { "type": "object", "description": "Student's Address information as provided for previous academic record", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "description": "Country information", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } }, "other_attributes": { "type": "object" } } }, "teaching_institution": { "type": "object", "description": "Object with information about the teaching institution for which the transcript was issued", "properties": { "name": { "type": "string", "description": "Name of the institution" }, "id": { "type": "string", "description": "Unique identifier of the institute" }, "id_type": { "type": "string", "description": "Type of ID used to identify given institution Enum `IPEDS`,`CEEB`" }, "address": { "type": "object", "description": "Student's Address information as provided for previous academic record", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } } } }, "degree_awarding_institution": { "type": "object", "description": "Object with information about the degree awarding institution for which the transcript was issued", "properties": { "name": { "type": "string", "description": "Name of the institution" }, "id": { "type": "string", "description": "Unique identifier of the institute" }, "id_type": { "type": "string", "description": "Type of ID used to identify given institution Enum `IPEDS`,`CEEB`" }, "address": { "type": "object", "description": "Student's Address information as provided for previous academic record", "properties": { "addr1": { "type": "string", "description": "Address line 1" }, "addr2": { "type": "string", "description": "Address line 2. Should be populated only if `addr1` is populated" }, "city": { "type": "string", "description": "City" }, "state": { "type": "string", "description": "State" }, "zipcode": { "type": "string", "description": "Zipcode for the address" }, "country": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the country" }, "a2_code": { "type": "string", "description": "Alpha-2 code for the country from ISO 3166" } } } } } } }, "academic_summary": { "type": "array", "description": "Summary information about the degree", "items": { "properties": { "credit_type": { "type": "string", "description": "Type of credit used. Enum `SEMESTER`, `QUARTER`, `UNITS`, `CLOCK_HOURS`, `CARNEGIE_UNITS`, `CONTINUING_EDUCATION_UNIT`, `HIGHSCHOOL_CREDIT`, `OTHER`" }, "level": { "type": "string", "description": "The level of the academic summary. Enum `INSTITUTION`, `TRANSFER`, `TOTAL`" }, "cumulative": { "type": "boolean", "description": "Boolean indicating whether the summary is cumulative" }, "gpa_credits": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "attempted": { "type": "number", "description": "Credits attempted. Should be a non negative number, if available" }, "earned": { "type": "number", "description": "Credits earned. Should be a non negative number, if available" }, "gpa_range": { "type": "object", "description": "GPA scale for School/University", "properties": { "minimum": { "type": "number", "description": "minimum range for GPA" }, "maximum": { "type": "number", "description": "maximum range for GPA" } } }, "gpa": { "type": "number", "description": "Grade Point Average. Should be a non negative number, if available" }, "quality_points": { "type": "number", "description": "Quality points for grade, used in GPA calculation. Should be a non negative number, if available" }, "student_rank": { "type": "number", "description": "Student rank" }, "class_size": { "type": "number", "description": "Number of students in the class" }, "rank_date": { "type": "string", "description": "Class rank date" }, "days_attended": { "type": "string", "description": "Days student attended class" }, "days_absent": { "type": "string", "description": "Days student absent in class" } } } }, "academic_sessions": { "type": "array", "description": "List of academic sessions provided on the transcript", "items": { "properties": { "type": { "type": "string", "description": "Type of session E.g. SEMESTER, TRIMESTER, QUARTER, FULL_YEAR, MINI_TERM, SUMMER_SESSION, UNKNOWN" }, "name": { "type": "string", "description": "Name of the session E.g. Fall 2012" }, "start_date": { "type": "string", "description": "Start Date of the session" }, "end_date": { "type": "string", "description": "End Date of the session" }, "in_progress": { "type": "boolean", "description": "Boolean indicating whether the session is in-progress at the time of transcript_date" }, "level": { "type": "string", "description": "Grade Level or Academic Level of the Individual for the session" }, "honors": { "type": "array", "description": "Academic honors or awards for the session E.g. Cum Laude, Summa Cum Laude, Magna Cum Laude", "items": { "type": "string" } }, "curriculum_code_type": { "type": "string", "description": "Type of the code used for identifying curriculum E.g. CIP, HEGIS, OTHER" }, "curriculum_code": { "type": "string", "description": "Code identifying the program in which the Individual is enrolled for this session" }, "curriculum_name": { "type": "string", "description": "Name of the program in which the Individual is enrolled for this session" }, "academic_summary": { "type": "array", "description": "Summary information about the degree", "items": { "properties": { "credit_type": { "type": "string", "description": "Type of credit used. Enum `SEMESTER`, `QUARTER`, `UNITS`, `CLOCK_HOURS`, `CARNEGIE_UNITS`, `CONTINUING_EDUCATION_UNIT`, `HIGHSCHOOL_CREDIT`, `OTHER`" }, "level": { "type": "string", "description": "The level of the academic summary. Enum `INSTITUTION`, `TRANSFER`, `TOTAL`" }, "cumulative": { "type": "boolean", "description": "Boolean indicating whether the summary is cumulative" }, "gpa_credits": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "attempted": { "type": "number", "description": "Credits attempted. Should be a non negative number, if available" }, "earned": { "type": "number", "description": "Credits earned. Should be a non negative number, if available" }, "gpa_range": { "type": "object", "description": "GPA range for School/University", "properties": { "minimum": { "type": "number", "description": "minimum value for GPA" }, "maximum": { "type": "number", "description": "maximum value for GPA" } } }, "gpa": { "type": "number", "description": "Grade Point Average. Should be a non negative number, if available" }, "quality_points": { "type": "number", "description": "Quality points for grade, used in GPA calculation. Should be a non negative number, if available" }, "student_rank": { "type": "number", "description": "Student rank" }, "class_size": { "type": "number", "description": "Number of students in the class" }, "rank_date": { "type": "string", "description": "Class rank date" }, "days_attended": { "type": "string", "description": "Days student attended class" }, "days_absent": { "type": "string", "description": "Days student absent in class" } } } }, "courses": { "type": "array", "description": "List of courses taken in this academic session. At least one of the academic sessions should have courses object", "items": { "properties": { "credit_basis": { "type": "string", "description": "Indicates the method of credits earned for the course. Enum `REGULAR_ENROLLMENT` `TRANSFER` `ADVANCED_PLACEMENT`" }, "honors_course": { "type": "boolean", "description": "Indicates if it is honors course or not" }, "repeated": { "type": "boolean", "description": "If the course was repeated by the Individual" }, "count_in_gpa": { "type": "boolean", "description": "If the course performance is counted in gpa calculation or not" }, "code_type": { "type": "string", "description": "Code designating the system/method of code structure used for Identification Code used to describe the content of the course. Enum `CIP`, `HEGIS`, `OTHER`, `UNKNOWN`" }, "code": { "type": "string", "description": "Course code information as presented on the transcript" }, "id": { "type": "string", "description": "Course ID as presented on the transcript" }, "name": { "type": "string", "description": "Free-form name to describe the content of the course" }, "instructional_setting": { "type": "string", "description": "Type of instructional setting in which a program is provided" }, "start_date": { "type": "string", "description": "Course start date" }, "end_date": { "type": "string", "description": "Course end date" }, "other_attributes": { "type": "object" }, "credits": { "type": "object", "description": "Object with information related to credits for the course", "properties": { "credit_type": { "type": "string", "description": "Type of credit used. Enum `SEMESTER`, `QUARTER`, `UNITS`, `CLOCK_HOURS`, `CARNEGIE_UNITS`, `CONTINUING_EDUCATION_UNIT`, `HIGHSCHOOL_CREDIT`, `OTHER`. For a valid credits object, credit_type is mandatory" }, "gpa_credits": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "attempted": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "earned": { "type": "number", "description": "Credits earned. Should be a non negative number, if available" }, "quality_points": { "type": "number", "description": "Quality points for grade, used in GPA calculation. Should be a non negative number, if available" }, "grade_qualifier": { "type": "string", "description": "The grading scale used by an academic institution for the course." }, "grade": { "type": "string", "description": "Indicates the grade that an Individual received for participation in the course." } } }, "marks_awarded": { "type": "array", "description": "Indicates the series of marks that an Individual received for participation in the course.", "items": { "properties": { "grade": { "type": "string", "description": "Indicates the grade that an Individual received for participation in the course." }, "grade_qualifier": { "type": "string", "description": "The grading scale used by an academic institution for the course." }, "period": { "type": "string", "description": "Indicates the period for which mark awarded" } } } } } } }, "degrees": { "type": "array", "description": "List of degrees found in this academic record", "items": { "properties": { "description": { "type": "string", "description": "Name of the degree" }, "type": { "type": "string", "description": "Level of the degree. Enum `HIGH-SCHOOL-DIPLOMA`, `ASSOCIATE`, `BACHELORS`, `MASTERS`, `MASTERS-RESEARCH`, `DOCTORAL`, `CERTIFICATE`, `DIPLOMA`, `NON-DEGREE`, `PROFESSIONAL`, `UNDERGRADUATE`, `UNKNOWN`" }, "status": { "type": "string", "description": "Status of the degree. Enum `AWARDED`, `ENROLLED`, `WITHDRAWN`, `TERMINATED`, `UNKNOWN`" }, "awarded_date": { "type": "string", "description": "Degree awarded date (applicable to graduates only)" }, "years_of_study": { "type": "number", "description": "Number of years of study for the given degree" }, "other_attributes": { "type": "object" }, "academic_summary": { "type": "array", "description": "Summary information about the degree", "items": { "properties": { "credit_type": { "type": "string", "description": "Type of credit used. Enum `SEMESTER`, `QUARTER`, `UNITS`, `CLOCK_HOURS`, `CARNEGIE_UNITS`, `CONTINUING_EDUCATION_UNIT`, `HIGHSCHOOL_CREDIT`, `OTHER`" }, "level": { "type": "string", "description": "The level of the academic summary. Enum `INSTITUTION`, `TRANSFER`, `TOTAL`" }, "cumulative": { "type": "boolean", "description": "Boolean indicating whether the summary is cumulative" }, "gpa_credits": { "type": "number", "description": "Credits attempted on courses that are included in the GPA calculation. Should be a non negative number, if available" }, "attempted": { "type": "number", "description": "Credits attempted. Should be a non negative number, if available" }, "earned": { "type": "number", "description": "Credits earned. Should be a non negative number, if available" }, "gpa_range": { "type": "object", "description": "GPA range for School/University", "properties": { "minimum": { "type": "number", "description": "minimum value for GPA" }, "maximum": { "type": "number", "description": "maximum value for GPA" } } }, "gpa": { "type": "number", "description": "Grade Point Average. Should be a non negative number, if available" }, "quality_points": { "type": "number", "description": "Quality points for grade, used in GPA calculation. Should be a non negative number, if available" }, "student_rank": { "type": "number", "description": "Student rank" }, "class_size": { "type": "number", "description": "Number of students in the class" }, "rank_date": { "type": "string", "description": "Class rank date" }, "days_attended": { "type": "string", "description": "Days student attended class" }, "days_absent": { "type": "string", "description": "Days student absent in class" } } } }, "field_of_study": { "type": "array", "description": "List of objects with information about the field of study", "items": { "properties": { "type": { "type": "string", "description": "Type of study. Enum `MAJOR`,`MINOR`,`CONCENTRATION`" }, "description": { "type": "string", "description": "Name of the field of study" }, "code_type": { "type": "string", "description": "Type of the code used for identifying the field of study E.g. CIP, HEGIS, OTHER" }, "code": { "type": "string", "description": "Specifies the code for the field of study associated with the academic record." } } } } } } }, "other_attributes": { "type": "object" } } } } } } /%}