# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/illinoisreportcard/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/illinoisreportcard/get-accountability \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-administrators \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-district-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-eighth-grade-algebra \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-ela-achievement-profiles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-ela-growth \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-math-achievement-profiles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-math-growth \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-school-environment \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-school-finances \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-school-highlights \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-school-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-science-achievement-profiles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-state-snapshot \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-students-demographics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/get-teachers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/illinoisreportcard/search-schools \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.