Find Institution
find_institutionWhich institution is this? A name or an IPEDS UNITID answers with the institution's identity, sector, identifiers with their sources, how many programs, checklists, and learning units its published catalog holds here, and what else CourseShelf stores about it: transfer agreements and pathways, prior learning policies and rules, the exam programs it grants credit for, on-campus housing, in-state tuition, veterans services and transfer credit policies. A name is read whole, never as a fragment: case, punctuation, a leading "The", "&" for "and", "St." for "Saint" and "X at Y" for "X-Y" are set aside, and a name equal to one school's, or to an IPEDS alias reviewed to name that school, is that school. Several fits, or a read only by initials, by an alias that does not name one school, or by words of a name, are candidates and none is chosen. Every answer says how it matched (matched_by) and whether it is one school (resolved). A state lists that state's institutions by name; a school type, or a filter on what CourseShelf stores, lists across the country without a state, with the sectors of the schools listed and their counts; with none of these, the answer is the states that hold institutions, each with its count. A web address answers the institution that publishes it, so a school named by its own site is identified without an IPEDS number in hand. Each row names its current FORM's wording source: source_url, capture_file, catalog_year and source_catalog_name are that one source's, never the record's whole span. A row whose record holds more than one form or more than one source also carries version_count, source_count, first_edition_seen and last_edition_seen, and one sentence saying so in words; a record with one form and one source carries none of them and reads exactly as it always has. The forms themselves, each with its own content and its own sources, come from the one-record get, never from a list. A record last seen in an older edition says so, because the Union keeps a record no current catalog prints.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_institution"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Optional city, one of a state answer's cities, e.g. Denison | |
| limit | No | Optional page size (default 20, at most 100) | |
| query | No | A school's name, its web address, or its IPEDS UNITID, e.g. University of Tennessee at Chattanooga, utc.edu or 221740; words of a name give candidates | |
| state | No | Optional two-letter state, e.g. TX: that state's institutions, those with a catalog held first; the answer lists the state's cities | |
| domain | No | Optional: the institution's own web address, matched against the addresses it publishes, e.g. uindy.edu | |
| locale | No | Optional, where the publish holds the College Scorecard's characteristics: only schools in this setting (NCES locale) | |
| offset | No | Optional: the next_offset from a previous answer | |
| sector | No | Optional school type as IPEDS labels it, e.g. public 2-year; without a state, that type's institutions across the country, those with a catalog held first | |
| exam_credit | No | Optional: only schools with a published rule granting credit for this exam program | |
| online_only | No | Optional, where the publish holds the College Scorecard's characteristics: only schools whose programs are all offered online | |
| residential | No | Optional, where the publish holds the College Scorecard's characteristics: only primarily or highly residential four-year schools (Carnegie size and setting) | |
| with_pathways | No | Optional: only schools taking part in at least one pathway held | |
| tuition_in_max | No | Optional: only schools whose in-state tuition and fees (College Scorecard) is at or under this many dollars a year | |
| with_agreements | No | Optional: only schools with at least one transfer agreement held | |
| on_campus_housing | No | Optional: only schools that publish an on-campus room and board cost (College Scorecard) | |
| with_prior_learning | No | Optional: only schools with a published prior learning policy or a published rule for credit for prior learning they receive | |
| with_transfer_policy | No | Optional: only schools with a published transfer credit policy | |
| with_veteran_services | No | Optional: only schools with veterans and military services held |