Lookup CIP Code
scorecard_lookup_cipRead-onlyIdempotent
Search the Classification of Instructional Programs (CIP) taxonomy by keyword or partial name. Returns matching CIP codes with standard titles. Use this before passing cip_code filters to scorecard_search_programs or scorecard_get_programs when you know a program by name but not its code. Served entirely from embedded static data — no API call, no rate limit impact.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Requested limit; serving cap 50, hard ceiling 1,000. | |
| query | Yes | Search term — program name keyword (e.g. "computer science", "nursing", "business"). Matches against CIP titles and family names. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit that was applied. | |
| error | No | Present when the call failed. Absent on success. | |
| query | No | The search query used. | |
| shown | No | Number of CIP codes returned. | |
| notice | No | No-match guidance. | |
| results | No | Matching CIP entries ranked by relevance. | |
| guidance | No | Concrete narrowing guidance when matches remain. | |
| truncated | No | True when results were capped at the limit. | |
| queryContext | No | Effective selectors. | |
| totalMatches | No | Number of matches found. |