# The Learning Mate — Public API > Programmatic access to your courses, exams, students, and grades. - Base URL: `https://thelearningmate.com/api/public/v1` - Authentication: `Authorization: Bearer pk_your_api_key_here`. Keys are issued by our team. ## Documentation - [Full reference](https://thelearningmate.com/api-docs/reference): interactive endpoint contracts and examples. - [OpenAPI specification](https://thelearningmate.com/api/public/v1/openapi.json): machine-readable schemas for API clients and SDK generators. - [Complete plain-text reference](https://thelearningmate.com/llms-full.txt): schemas, examples, errors, and rate limits in a single file. ## Courses Create, list, inspect, update, and delete courses owned by your API key. - [GET /api/public/v1/courses](https://thelearningmate.com/api-docs/reference#operation/listCourses): List your courses - [GET /api/public/v1/subjects](https://thelearningmate.com/api-docs/reference#operation/listSubjects): List subjects - [POST /api/public/v1/courses](https://thelearningmate.com/api-docs/reference#operation/createCourse): Create a course - [GET /api/public/v1/courses/{courseId}](https://thelearningmate.com/api-docs/reference#operation/getCourse): Get a course - [PATCH /api/public/v1/courses/{courseId}](https://thelearningmate.com/api-docs/reference#operation/updateCourse): Update a course - [DELETE /api/public/v1/courses/{courseId}](https://thelearningmate.com/api-docs/reference#operation/deleteCourse): Delete a course ## Exams Create, inspect, update, and delete exams, including visibility and publishing controls. - [GET /api/public/v1/courses/{courseId}/exams](https://thelearningmate.com/api-docs/reference#operation/listCourseExams): List exams in a course - [GET /api/public/v1/exams](https://thelearningmate.com/api-docs/reference#operation/listExams): List exams across your courses - [POST /api/public/v1/courses/{courseId}/exams](https://thelearningmate.com/api-docs/reference#operation/createExam): Create an exam - [GET /api/public/v1/exams/{examId}](https://thelearningmate.com/api-docs/reference#operation/getExam): Get an exam - [PATCH /api/public/v1/exams/{examId}](https://thelearningmate.com/api-docs/reference#operation/updateExam): Update an exam - [DELETE /api/public/v1/exams/{examId}](https://thelearningmate.com/api-docs/reference#operation/deleteExam): Delete an exam - [GET /api/public/v1/exams/{examId}/submissions](https://thelearningmate.com/api-docs/reference#operation/listExamSubmissions): List exam submissions - [PATCH /api/public/v1/exams/{examId}/students/visibility](https://thelearningmate.com/api-docs/reference#operation/updateStudentVisibility): Update exam visibility per student ## Students Create, update, and remove students in your courses. - [POST /api/public/v1/courses/{courseId}/students](https://thelearningmate.com/api-docs/reference#operation/createStudents): Create & enroll students - [GET /api/public/v1/courses/{courseId}/students](https://thelearningmate.com/api-docs/reference#operation/listCourseStudents): List students in a course - [GET /api/public/v1/courses/{courseId}/students/{studentId}](https://thelearningmate.com/api-docs/reference#operation/getCourseStudent): Get a student - [PATCH /api/public/v1/courses/{courseId}/students/{studentId}](https://thelearningmate.com/api-docs/reference#operation/updateStudent): Update a student - [DELETE /api/public/v1/courses/{courseId}/students/{studentId}](https://thelearningmate.com/api-docs/reference#operation/removeStudent): Remove a student from a course ## Corrections Submit student answer papers for AI grading and poll for the results. - [POST /api/public/v1/exams/{examId}/corrections](https://thelearningmate.com/api-docs/reference#operation/createCorrection): Submit an answer paper for grading - [GET /api/public/v1/exams/{examId}/students/{studentId}/correction](https://thelearningmate.com/api-docs/reference#operation/getCorrection): Get a correction result - [GET /api/public/v1/exams/{examId}/students/{studentId}/correction/mistakes-pdf](https://thelearningmate.com/api-docs/reference#operation/getCorrectionMistakesPdf): Get the mistakes-only report - [GET /api/public/v1/exams/{examId}/students/{studentId}/correction/annotated-pdf](https://thelearningmate.com/api-docs/reference#operation/getCorrectionAnnotatedPdf): Get the annotated PDF - [POST /api/public/v1/exams/{examId}/students/{studentId}/correction/annotated-pdf](https://thelearningmate.com/api-docs/reference#operation/generateCorrectionAnnotatedPdf): Generate the annotated PDF ## Grades Look up student grades for an exam. - [POST /api/public/v1/exams/{examId}/grades/query](https://thelearningmate.com/api-docs/reference#operation/queryGrades): Query grades by email ## Analytics Grade statistics, per-question results, and per-student performance. - [GET /api/public/v1/exams/{examId}/analytics](https://thelearningmate.com/api-docs/reference#operation/getExamAnalytics): Get exam grade statistics - [GET /api/public/v1/exams/{examId}/analytics/questions](https://thelearningmate.com/api-docs/reference#operation/getExamQuestionAnalytics): Get per-question statistics - [GET /api/public/v1/courses/{courseId}/students/{studentId}/performance](https://thelearningmate.com/api-docs/reference#operation/getStudentPerformance): Get a student’s performance in a course ## Embedding - [Student iframe](https://thelearningmate.com/embed/iframe/student): embed the full student experience with a single `