---
name: data-api
description: "Data API skill. Use when working with Data for contacts, district_admins, districts. Covers 44 endpoints."
version: 1.0.0
generator: lapsh
---

# Data API
API version: 1.2.0

## Auth
OAuth2

## Base URL
https://api.clever.com/v1.2

## Setup
1. Configure auth: OAuth2
2. GET /contacts -- returns a list of student contacts
3. Explore available endpoints below

## Endpoints
44 endpoints across 8 groups. See references/api-spec.lap for full details.

### Contacts
| Method | Path | Description |
|--------|------|-------------|
| GET | /contacts | Returns a list of student contacts |
| GET | /contacts/{id} | Returns a specific student contact |
| GET | /contacts/{id}/district | Returns the district for a student contact |
| GET | /contacts/{id}/student | Returns the student for a student contact |

### District_admins
| Method | Path | Description |
|--------|------|-------------|
| GET | /district_admins | Returns a list of district admins |
| GET | /district_admins/{id} | Returns a specific district admin |

### Districts
| Method | Path | Description |
|--------|------|-------------|
| GET | /districts | Returns a list of districts. In practice this will only return the one district associated with the bearer token |
| GET | /districts/{id} | Returns a specific district |
| GET | /districts/{id}/admins | Returns the admins for a district |
| GET | /districts/{id}/schools | Returns the schools for a district |
| GET | /districts/{id}/sections | Returns the sections for a district |
| GET | /districts/{id}/status | Returns the status of the district |
| GET | /districts/{id}/students | Returns the students for a district |
| GET | /districts/{id}/teachers | Returns the teachers for a district |

### School_admins
| Method | Path | Description |
|--------|------|-------------|
| GET | /school_admins | Returns a list of school admins |
| GET | /school_admins/{id} | Returns a specific school admin |
| GET | /school_admins/{id}/schools | Returns the schools for a school admin |

### Schools
| Method | Path | Description |
|--------|------|-------------|
| GET | /schools | Returns a list of schools |
| GET | /schools/{id} | Returns a specific school |
| GET | /schools/{id}/district | Returns the district for a school |
| GET | /schools/{id}/sections | Returns the sections for a school |
| GET | /schools/{id}/students | Returns the students for a school |
| GET | /schools/{id}/teachers | Returns the teachers for a school |

### Sections
| Method | Path | Description |
|--------|------|-------------|
| GET | /sections | Returns a list of sections |
| GET | /sections/{id} | Returns a specific section |
| GET | /sections/{id}/district | Returns the district for a section |
| GET | /sections/{id}/school | Returns the school for a section |
| GET | /sections/{id}/students | Returns the students for a section |
| GET | /sections/{id}/teacher | Returns the primary teacher for a section |
| GET | /sections/{id}/teachers | Returns the teachers for a section |

### Students
| Method | Path | Description |
|--------|------|-------------|
| GET | /students | Returns a list of students |
| GET | /students/{id} | Returns a specific student |
| GET | /students/{id}/contacts | Returns the contacts for a student |
| GET | /students/{id}/district | Returns the district for a student |
| GET | /students/{id}/school | Returns the primary school for a student |
| GET | /students/{id}/sections | Returns the sections for a student |
| GET | /students/{id}/teachers | Returns the teachers for a student |

### Teachers
| Method | Path | Description |
|--------|------|-------------|
| GET | /teachers | Returns a list of teachers |
| GET | /teachers/{id} | Returns a specific teacher |
| GET | /teachers/{id}/district | Returns the district for a teacher |
| GET | /teachers/{id}/grade_levels | Returns the grade levels for sections a teacher teaches |
| GET | /teachers/{id}/school | Retrieves school info for a teacher. |
| GET | /teachers/{id}/sections | Returns the sections for a teacher |
| GET | /teachers/{id}/students | Returns the students for a teacher |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all contacts?" -> GET /contacts
- "Get contact details?" -> GET /contacts/{id}
- "List all district?" -> GET /contacts/{id}/district
- "List all student?" -> GET /contacts/{id}/student
- "List all district_admins?" -> GET /district_admins
- "Get district_admin details?" -> GET /district_admins/{id}
- "List all districts?" -> GET /districts
- "Get district details?" -> GET /districts/{id}
- "List all admins?" -> GET /districts/{id}/admins
- "List all schools?" -> GET /districts/{id}/schools
- "List all sections?" -> GET /districts/{id}/sections
- "List all status?" -> GET /districts/{id}/status
- "List all students?" -> GET /districts/{id}/students
- "List all teachers?" -> GET /districts/{id}/teachers
- "List all school_admins?" -> GET /school_admins
- "Get school_admin details?" -> GET /school_admins/{id}
- "Get school details?" -> GET /schools/{id}
- "Get section details?" -> GET /sections/{id}
- "List all school?" -> GET /sections/{id}/school
- "List all teacher?" -> GET /sections/{id}/teacher
- "Get student details?" -> GET /students/{id}
- "Get teacher details?" -> GET /teachers/{id}
- "List all grade_levels?" -> GET /teachers/{id}/grade_levels
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)