# Illinoisreportcard — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```