Skip to main content

Teach 'n Go API endpoints

Teach ’n Go API endpoints for retrieving school data

Abdullah Al-Hussein avatar
Written by Abdullah Al-Hussein
Updated yesterday

You can use Teach ’n Go’s API to gather data about your school — including students, classes, lessons, attendance, and payments.

This guide lists all available API endpoints and explains how to authenticate and make requests using your school’s unique API key.

How to Create Your API Key

  1. Before making any API requests, you’ll need to create an API key for your school.

    1. Go to your School Settings page.

    2. Click on the Developers tab.

    3. Click Create an API Key.

    This key will authenticate your requests and allow secure communication between your system and Teach ’n Go.

Using the API key

You can use your API key in one of two ways:

Option 1: Include it in the header

X-API-KEY: your_api_key_here

Example:

curl -X POST "https://app.teachngo.com/api/student" \
-H "X-API-KEY: your_api_key_here"

Option 2: Add it as a query parameter

https://app.teachngo.com/api/student?apikey=your_api_key_here

This method is helpful for quick testing or when integrating with tools that don’t support custom headers.

Request method and body

  • Method: POST

  • Body type: JSON

You can also control the number of records returned per page using the per_page parameter (default is 20).

{
"per_page: 200
}

API endpoints

Below is a list of available endpoints for retrieving school data.

Use your API key for authentication with each request.


🧑‍🎓 Student list

Returns: All students in your school and their related information.

Endpoint:

https://app.teachngo.com/globalApis/student_list


🧑‍💼 Prospect list

Returns: All prospective students and their information.

Endpoint:

https://app.teachngo.com/globalApis/prospect_list


📚 Course list

Returns: All courses in your school and related details.

Endpoint:

https://app.teachngo.com/globalApis/course_list


🗓 Lesson list

Returns: All lessons for a specific course.

Endpoint format:

https://app.teachngo.com/globalApis/lesson_list/[course_id]

Replace [course_id] with the actual course ID from your course list.

Each record includes lesson details, schedule, and assigned teachers.


🏫 Student attendance

Returns: Complete attendance information for all students.

Endpoint:

https://app.teachngo.com/globalApis/students_attendance

Use this to analyze attendance rates or build custom attendance reports.


💬 Student behaviours

Returns all information regarding student behaviour.

https://app.teachngo.com/globalApis/student_behaviours


🧾 Receipts

Returns: Receipt information for your school.

Endpoint:

https://app.teachngo.com/api/v1/receipts

You can specify a date range to retrieve receipts issued between two dates.

Example body:

{
"from_date: YYYY-MM-DD",
"to_date: YYYY-MM-DD"
}


💰 Payments

Returns: Details about all payments and their current status.

Endpoint:

https://app.teachngo.com/api/v1/payments


Example workflow

Here’s a typical use case for combining these endpoints:

  1. Retrieve your course list → /globalApis/course_list

  2. Choose a course ID → e.g., 57645

  3. Retrieve lessons for that course → /globalApis/lesson_list/57645

  4. Retrieve enrolled students → /globalApis/student_list

  5. Cross-reference attendance → /globalApis/students_attendance

This approach lets you create your own dashboards or custom reports outside Teach ’n Go — all powered by live data from your school.


Best practices

  • Keep your API key secure — treat it like a password.

  • Use the per_page parameter to manage data loads efficiently.

  • Store only the data you need to comply with privacy regulations.

  • If integrating with external systems, refresh your data periodically to ensure accuracy.


FAQs

1. Can I use the same API key for multiple integrations?

Yes, but it’s best practice to create separate keys for each integration to track usage and revoke access easily if needed.

2. How often is the data updated?

Data is retrieved in real time from your Teach ’n Go account.

3. Can I filter data (e.g., by date or course)?

Currently, most endpoints return full datasets. You can apply filters in your own system after retrieval.

4. What’s the default page size for results?

By default, 20 records are returned per page. You can increase this using "per_page": 200.

5. Do I need admin rights to use the API?

Yes, only users with admin permissions can create or use API keys.


Conclusion

With these endpoints, you can easily integrate Teach ’n Go data into your own systems — from dashboards and CRMs to reporting and automation tools.

Start by generating your API key, test a few endpoints, and build the integrations that make your school run smarter and faster.

Did this answer your question?