# Scholarships — 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 browse the Scholarships.com directory by category — including academic major, residence state, ethnicity, gender, school year, and deadline. Retrieve scholarship listings within any category and subcategory, and fetch full details for individual scholarships including award amounts, eligibility criteria, application deadlines, and application links.

**Category:** Education | **Website:** [scholarships.com/](https://scholarships.com/) | **Docs:** [parse.bot/marketplace/9dccd551-0b32-432f-ac0c-c070031ba36d/scholarships-com-api](https://parse.bot/marketplace/9dccd551-0b32-432f-ac0c-c070031ba36d/scholarships-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-scholarships-com-api-9dccd551/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_scholarship_detail

Returns full details for a specific scholarship including description, amount, deadline, number of awards available, eligibility criteria, and application URL when available. Uses the scholarship slug from list_scholarships_in_category results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `scholarship_slug` | string | Yes | Slug identifier for the scholarship, as returned in list_scholarships_in_category results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholarships-com-api-9dccd551/get_scholarship_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scholarship_slug":"<string>"}'
```

### get_scholarship_directory_categories

Returns all top-level scholarship directory category types (Academic Major, Residence State, Ethnicity, Race, Gender, etc.) available for filtering scholarships. No parameters required. Each category has a slug usable with list_subcategories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholarships-com-api-9dccd551/get_scholarship_directory_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_all_states

Convenience endpoint that returns all US states and territories available for filtering scholarships by residence state. Equivalent to calling list_subcategories with category_slug 'residence-state'. Each state has a slug usable with list_scholarships_in_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholarships-com-api-9dccd551/list_all_states \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_scholarships_in_category

Returns a list of scholarships within a specific category and subcategory combination. Each scholarship includes name, slug, and URL. Uses slugs from get_scholarship_directory_categories and list_subcategories. Results are not paginated; all scholarships for the subcategory are returned in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Slug of the top-level category (e.g. residence-state, academic-major, ethnicity) |
| `subcategory_slug` | string | Yes | Slug of the subcategory (e.g. california, accounting, afghan). Obtained from list_subcategories results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholarships-com-api-9dccd551/list_scholarships_in_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","subcategory_slug":"<string>"}'
```

### list_subcategories

Lists subcategories for a given top-level category. For example, returns all academic majors for category 'academic-major', all states for 'residence-state', or all ethnicities for 'ethnicity'. Each subcategory has a slug usable with list_scholarships_in_category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Slug of the top-level category from get_scholarship_directory_categories (e.g. academic-major, residence-state, ethnicity, race, gender, school-year, deadline, special-attributes, physical-disabilities, scholarship-amount, act-score, age, artistic-ability, athletic-ability, employer, financial-need, grade-point-average, honors-organization, military-affiliation, number-of-scholarships-available, religion, sat-score, school-attendance-state, student-organization) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholarships-com-api-9dccd551/list_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```