# Illinoisreportcard — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and analyze comprehensive performance data for Illinois public schools, districts, and the state, including academic achievements in ELA, math, and science, student demographics, teacher and administrator information, school finances, and environmental conditions. Compare schools side-by-side, track growth metrics, and access accountability ratings and school highlights to make informed decisions about education quality.

**Category:** Education | **Website:** [illinoisreportcard.com/](https://illinoisreportcard.com/) | **Docs:** [parse.bot/marketplace/7e110fc7-2746-4cc0-b445-e6fd73bd728e/illinoisreportcard-com-api](https://parse.bot/marketplace/7e110fc7-2746-4cc0-b445-e6fd73bd728e/illinoisreportcard-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_accountability

Get accountability and designation data for a school, including ESSA designation and school improvement status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_accountability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_administrators

Get administrator data for a school, including number of admins, salaries, and pupil-admin ratios. Fields may return -999 indicating data is unavailable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_administrators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_district_profile

Get district profile data including demographics, enrollment, contact info, and aggregate statistics. Returns year-by-year data for the district.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `district_id` | string | Yes | District ID from search_schools results (e.g. '51084186025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_district_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"district_id":"<string>"}'
```

### get_eighth_grade_algebra

Get 8th grade algebra passing data for a school. The eighthgradealgebra field returns -999 for schools that do not serve 8th grade students.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_eighth_grade_algebra \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_ela_achievement_profiles

Get ELA achievement profile data for a school. Returns comprehensive entity data including ELA-specific fields like satelaaveragescore and iarsgpela.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_ela_achievement_profiles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_ela_growth

Get ELA student growth data for a school. Growth fields include iarsgpela and hssgpela which may return -999 when data is unavailable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_ela_growth \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_math_achievement_profiles

Get Math achievement profile data for a school. Returns comprehensive entity data including math-specific fields like satmathaveragescore and iarsgpmath.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_math_achievement_profiles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_math_growth

Get Math student growth data for a school. Growth fields include iarsgpmath and hssgpmath which may return -999 when data is unavailable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_math_growth \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_school_environment

Get school environment data including attendance rates, class size, truancy, chronic absenteeism, and discipline metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_school_environment \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_school_finances

Get school financial data including per-pupil expenditure, revenue sources, and evidence-based funding amounts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_school_finances \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_school_highlights

Get school highlights data including designation status, awards counts, and notable metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_school_highlights \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_school_profile

Get comprehensive school profile data including demographics, enrollment, contact info, achievement scores, attendance, and financial data. Returns year-by-year data. Use IDs obtained from search_schools results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results (e.g. '510841860250002'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_school_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_science_achievement_profiles

Get Science achievement profile data for a school. Returns comprehensive entity data including science-specific fields like averagescorescience.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_science_achievement_profiles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_state_snapshot

Get statewide summary statistics for Illinois. Returns year-by-year aggregate data across all schools and districts.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_state_snapshot \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_students_demographics

Get detailed student demographic data for a school, including race/ethnicity breakdowns in the demographic array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_students_demographics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### get_teachers

Get teacher workforce data for a school, including number of teachers, salaries, retention, and qualifications. Fields may return -999 indicating data is unavailable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `school_id` | string | Yes | Alphanumeric school ID from search_schools results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/get_teachers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"school_id":"<string>"}'
```

### search_schools

Search for schools, districts, or cities by name. Returns matching results with IDs that can be used with other endpoints. Searches across school, district, and city types simultaneously.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term (school, district, city, or county name) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-illinoisreportcard-com-api-7e110fc7/search_schools \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```