---
title: "Quote a Scholarship research links call (free)"
method: POST
path: "/v1/tools/scholarship/quote"
---

# Quote a Scholarship research links call (free)

`POST /v1/tools/scholarship/quote`

## Request

- Base URL: `https://api.counselorai.app`
- URL: `https://api.counselorai.app/v1/tools/scholarship/quote`
- Auth: HTTP bearer

Free pre-flight. Validates the input and returns the exact credit hold a real call would take at this account's price, without billing anything. An invalid input is still a 200: the body carries valid:false and the validation errors.

## Request body

- object
  - `studentName` string: The student this is about. Used in the output text.
  - `grade` string: Grade level or transfer status.
  - `gpa` string
  - `major` string: Intended field. Departmental awards are usually the least contested.
  - `state` string: State of residence. State and regional awards have far smaller applicant pools than national ones.
  - `backgrounds` string[]: Eligibility categories that unlock specific award pools.
  - `activities` string: Extracurriculars and leadership.
  - `notes` string: Anything else that should shape the output.

## Response `200`

Quote

- object
  - `tool` string
  - `valid` boolean
  - `validation_errors` unknown[]
    - unknown
  - `estimated_credits` integer
  - `estimated_usd` number
  - `max_credits_held` integer
  - `max_credits_supported` boolean
  - `credit_balance` integer
  - `sufficient` boolean
  - `price_multiplier` number

---

[API](https://skmtc.dev/counselorai/apis/counselorai-api.md) · [All operations](https://skmtc.dev/counselorai/apis/counselorai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/counselorai/apis/counselorai-api/revisions/1d93eed35463?raw)