Which certification is this prose name? Start here for any plain question — a trade, field, job, skill, or company in everyday words. Returns candidates with ids, issuers, and source basis — candidates rather than a single guess when the name is ambiguous; the ids feed the other certification tools.

Parameter	Type	Required	Notes
issuer	string	no	Optional: only certifications from this organization
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	yes	What you are looking for, in everyday words — a trade, field, job, or company

Everything held about one certification: issuer and issuer domain, occupations served, exam and renewal requirements, education-or-experience routes, Credential Engine registry identity where held, and the basis and source URL for the claim.

Parameter	Type	Required	Notes
id	string	yes	A certification id, copied from a search result's id field

What certifications serve this occupation? SOC-keyed lookup (dashed SOC accepted with or without the O*NET .00 suffix).

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer
soc	string	yes	An occupation code (SOC), e.g. 29-1141 for Registered Nurses or 47-2111 for Electricians — don't know it? search by the job name instead

What occupations does this certification serve?

Parameter	Type	Required	Notes
id	string	yes	A certification id, copied from a search result's id field
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer

What else serves the same occupation? Traverses on SOC only — a certification sharing solely an instructional program (CIP) is not related (contract § 4).

Parameter	Type	Required	Notes
id	string	yes	A certification id to find others like it, copied from a search result's id field
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer

Broad academic cross-reference by instructional program (CIP). A deliberately broader, lower-precision question than an occupation lookup — never its peer (contract § 4).

Parameter	Type	Required	Notes
cip	string	yes	A college program code (CIP), e.g. 51.3801 for Registered Nursing or 47.0201 for HVAC technology
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer

The issuing organizations, optionally filtered by a name query.

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional: part of an organization's name

Where does a word place in the KSA model? The KSA Dictionary is the shared vocabulary that defines the terms a learner uses to assert what they know, do, and are — and the terms a learning offering uses to express what it comprises — so both sides resolve to the same identifiers, never spelling matches. Answers from three linked layers (governed lexicon, O*NET content model, WordNet-derived index)

Parameter	Type	Required	Notes
term	string	yes	A word for something a person knows or can do, e.g. carpentry or mathematics

What is this word, upward? Walks the WordNet is-a (hypernym) chain meaning to parent meaning, from the word's KSA-mapped sense toward its broader categories, so every step stays in the sense it started in. Each step carries its definition (gloss) and synonyms.

Parameter	Type	Required	Notes
term	string	yes	A word to see what broader kind of thing it is, e.g. carpentry

What does the KSA Dictionary hold? The words and meanings it places, the governed terms, the O*NET content-model elements, the link words and the CIP-SOC crosswalk, each with its own version and build date where the layer publishes one, and an honest not held where it does not. Read as published at boot, never computed at request time, and never a word lookup: for one word use resolve_term. The wo

No parameter schema on file.

What does this code cross to? Auto-detects the family — dotted CIP (52.0201) or dashed SOC (11-1021, O*NET .00 suffix accepted) — and answers the other family's codes and titles from the federal CIP-SOC crosswalk.

Parameter	Type	Required	Notes
code	string	yes	A college program code (CIP, e.g. 51.3801) or an occupation code (SOC, e.g. 29-1141)
limit	integer	no	Optional page size (default 20, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer

Compare what a program takes at several institutions: for each IPEDS UNITID, that institution's published checklist for the program (requirement groups, items, published credit strings — the work effort) beside its published tuition and fee policy (the cost). Schedule is stated not held. Nothing is summed or computed by the service; an institution, checklist, or cost the catalogs do not hold is st

Parameter	Type	Required	Notes
detail	string	no	Optional: full (the default: every requirement group and item) or summary (per checklist its program, award, year, credits and group and item counts, with each school's College Scorecard tuition)
institution_offset	integer	no	Optional: the next_institution_offset from a previous answer, for the next 5 institutions
program	string	yes	Program or award words to match, e.g. nursing or Bachelor of Science in Nursing
unitids	array	yes	1 to 10 IPEDS UNITIDs, e.g. ["100663", "127060"]; answered 5 institutions per call, up to 3 checklists each

Which institution is this? A name fragment or an IPEDS UNITID answers with the institution's identity, sector, identifiers with their sources, and how many programs, checklists, and learning units its published catalog holds here. A state lists that state's institutions by name; with no name and no state, the answer is the states that hold institutions, each with its count. Each row names its curr

Parameter	Type	Required	Notes
city	string	no	Optional city, one of a state answer's cities, e.g. Denison
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Name fragment or IPEDS UNITID, e.g. Denver or 127060
state	string	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

What programs does this institution publish? Award, credential class, CIP, the published credit figure verbatim, catalog edition, the captured page each came from, and the checklist ids to pass to get_checklist. 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 ho

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 100, at most 200)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional program or award words to filter by
unitid	string	yes	The institution's IPEDS UNITID

What does this award require? One checklist: its requirement groups (every header and full item count), each group's items with published credit strings, alternatives, and — where an item resolved to a course — that course's own code, title, and published credits, attributed to the course. Items come in pages across the groups; the answer states items_total and next_item_offset. Every row names th

Parameter	Type	Required	Notes
checklist_id	string	yes	A checklist id from programs_for_institution or compare_program_checklists
item_limit	integer	no	Optional items per page (default 60, at most 150)
item_offset	integer	no	Optional: the next_item_offset from a previous answer

What courses does this institution publish? Filter by subject abbreviation, course code (spaces and case ignored), or title words; each course carries its published credit string verbatim (ranges stay ranges), edition, and the captured page. 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 who

Parameter	Type	Required	Notes
code	string	no	Optional course code, e.g. BIO 201
limit	integer	no	Optional page size (default 50, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional title words
subject	string	no	Optional subject abbreviation, e.g. BIO
unit_type	string	no	Optional learning-unit type, one of the answer's unit_types, e.g. course
unitid	string	yes	The institution's IPEDS UNITID

Everything held about one institution: its identity row, identifiers, addresses, websites, accreditations, relationships, identity history, published costs and calendar dates, each table under its own name, with counts of its programs, courses, checklists, catalogs, policies and agreements and the service that lists each. Contacts name people and are not served. Each row names its current FORM's w

Parameter	Type	Required	Notes
organization_id	string	no	The institution's organization id from find_institution, e.g. ORG_225070
unitid	string	no	Or its IPEDS UNITID instead, e.g. 225070

Which published catalog editions are held for this institution? Each catalog's edition year, format and source. Answers none held when the build holds none. 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 car

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
unitid	string	yes	The institution's IPEDS UNITID, e.g. 225070

One catalog edition: its row, the institutions that use it (and whom it is shared from), and how many programs it holds. 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, fi

Parameter	Type	Required	Notes
catalog_id	string	yes	A catalog id from find_catalogs

Which programs match these words, across institutions? Program or award words (optionally one institution's UNITID) answer with each program's award, CIP, published credit figure verbatim, edition, source page and institution. 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

Parameter	Type	Required	Notes
city	string	no	Optional city: programs at that city's institutions
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	yes	Program or award words, e.g. welding or nursing
state	string	no	Optional two-letter state: programs at that state's institutions
unitid	string	no	Optional: one institution's IPEDS UNITID

One program whole: its row, identifiers, offerings (campus resolved), its institution, and the checklists that lead to its award — pass one to get_checklist. 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 ca

Parameter	Type	Required	Notes
program_id	string	yes	A program id from programs_for_institution or find_programs

One course whole: its row, prerequisites and corequisites, aliases, terms offered, articulation statements and comparable members — each linked course resolved or stated unresolved, never guessed — plus the transfer frameworks it maps to. 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

Parameter	Type	Required	Notes
learning_unit_id	string	yes	A learning unit id from learning_units or get_checklist

Which academic policies does this institution publish (transfer credit, prior learning, tuition and fees …)? Optional words narrow them. Answers none held when the build holds none. 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

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional policy words, e.g. transfer
unitid	string	yes	The institution's IPEDS UNITID, e.g. 225070

One published academic policy: its section, verbatim text, page, edition and source. 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_se

Parameter	Type	Required	Notes
policy_id	string	yes	A policy id from find_policies

Which checklists — the generic itinerary of requirements for an award — does this institution publish? Optional award words or a program id narrow them; pass one to get_checklist. 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 t

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
program_id	string	no	Optional: one program's id
query	string	no	Optional award words, e.g. welding
unitid	string	yes	The institution's IPEDS UNITID

Which articulation or transfer agreements are held? Optional title words, or an institution's UNITID as a party. Answers none held when the build holds none. 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 ca

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional agreement title words
unitid	string	no	Optional: an institution party's IPEDS UNITID

One agreement: its row, its parties (organizations resolved), and the pathways, comparability bundles and checklists that cite it. Signatories name people and are not served. 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 o

Parameter	Type	Required	Notes
agreement_id	string	yes	An agreement id from find_agreements

Which pathways are held? Optional title words, an agreement id, or a checklist id. Answers none held when the build holds none. 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_co

Parameter	Type	Required	Notes
agreement_id	string	no	Optional: the agreement a pathway rests on
checklist_id	string	no	Optional: the checklist a pathway follows
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional pathway title words

One pathway: its row and the checklist and agreement it links. Contacts name people and are not served. 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

Parameter	Type	Required	Notes
pathway_id	string	yes	A pathway id from find_pathways

Which comparability bundles (published transfer rules) are held? Optional receiving institution UNITID, agreement id, or a learning unit that appears as a source or substitute. Answers none held when the build holds none. 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

Parameter	Type	Required	Notes
agreement_id	string	no	Optional: the agreement that states it
learning_unit_id	string	no	Optional: a course named in it
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
unitid	string	no	Optional: the receiving institution's IPEDS UNITID

One comparability bundle: its row (credits awarded published beside any parse), the receiving institution, and its source and substitute courses, each resolved or stated unresolved. 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

Parameter	Type	Required	Notes
comparability_id	string	yes	A comparability id from find_comparability

Which statewide or compact transfer frameworks are held? Optional name or jurisdiction words. Answers none held when the build holds none. 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

Parameter	Type	Required	Notes
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer
query	string	no	Optional framework name or jurisdiction words

One transfer framework: its row, authority, codes with their meanings, and the courses mapped to it (resolved). 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_editi

Parameter	Type	Required	Notes
framework_id	string	yes	A framework id from find_transfer_frameworks

Which checklists require this course? Each requirement item that resolved to it, with its checklist id, award and group heading. Items that did not resolve to a course are never guessed into this list. 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 t

Parameter	Type	Required	Notes
learning_unit_id	string	yes	A learning unit id from learning_units or get_learning_unit
limit	integer	no	Optional page size (default 20, at most 100)
offset	integer	no	Optional: the next_offset from a previous answer

Which programs or courses match, and where? Words, a subject (CIP family, or unknown), a course subject prefix, a credential class, an award as published, and a school's state, city, type or UNITID answer with product cards (name, award, length and college when held, school and city, subject, checklist size, and what the program leads to through the CIP-SOC crosswalk) and the counts to refine by.

Parameter	Type	Required	Notes
award	string	no	Optional award exactly as published, one of the answer's awards
cip		no	Optional: programs with this six-digit CIP code (e.g. 48.0508), a comma-separated list, or an array of codes
city	string	no	Optional city, one of a state answer's cities
code	string	no	Optional, courses only: a course code as printed, e.g. ZOO 2015; lists that code at every school, or within the state, city or school given
credential	string	no	Optional, programs only: a credential class, one of the answer's credential values (e.g. ceterms:AssociateDegree), or none
limit	integer	no	Optional page size (default 10, at most 50)
offset	integer	no	Optional: the next_offset from a previous answer
place	string	no	Optional: a place the question names, read as a state (name or code), a city, or a school, e.g. Wyoming or Casper
query	string	no	Words: a program's name or award, or a course's title
sector	string	no	Optional school type as IPEDS labels it, e.g. public 2-year
state	string	no	Optional two-letter state
subject	string	no	Optional CIP family (two digits, e.g. 51) or unknown
subject_code	string	no	Optional: a course subject prefix, e.g. NURS, one of the answer's subject codes. A course's own prefix as printed, or a prefix a program's checklist requires
type	string	no	program (the default) or learning_unit
unitid	string	no	Optional: one school's IPEDS UNITID

What does CourseShelf hold? From the records published with the build, read as published and never computed: per catalog area, how many institutions have loaded content and how many records were loaded; every table's row count; organizations by sector; the census of the whole index with its verdicts; and per-state counts and per-school verdicts where the build publishes them. Anything not publishe

No parameter schema on file.

Where does this course land at other schools, and what lands on it (exams included)? The published transfer rules for one course: the rules CourseShelf holds first (a school's own catalog, CourseAtlas), then CourseAtlas's direct rules read live. Each rule names its source authority, source_url and band; comparable, never equivalent. What lands on a course is answered from the held rules only. Each

Parameter	Type	Required	Notes
code	string	no	The course code as printed, e.g. HIST 201
direction	string	no	lands_as: where it lands; lands_on: what lands on it; both (default)
learning_unit_id	string	no	The course, by its learning unit id
limit	integer	no	Optional page size per list (default 10, at most 50)
offset	integer	no	Optional: the offset of the next page
school	string	no	Or: the course's school, by name (with code or title)
target_unitid	string	no	Optional: narrow where it lands to one receiving school (IPEDS UNITID)
title	string	no	Or: the course title, matched exactly
unitid	string	no	Or: the course's school, by IPEDS UNITID (with code or title)

Where can this occupation lead? For a SOC code: destination occupations, each with its typed roads (published by O*NET or by a credential serving both; mapped through the CIP-SOC crosswalk), each road with its source, basis and its class's karat; the bridges (credentials with their exam, education and experience conditions, and programs with checklists nearest the state given); and demand as O*NET

Parameter	Type	Required	Notes
class	string	no	Optional: only destinations with a road of this class (published, mapped)
from	string	no	Or the job in everyday words, e.g. welder; several matching occupations answer candidates to pick from
from_soc	string	no	The occupation's SOC code, e.g. 51-4121 (an O*NET .00 code is accepted)
limit	integer	no	Optional page size (default 10, at most 25)
offset	integer	no	Optional: the next_offset from a previous answer
prefer	string	no	Optional preference such as less physical; answered not held when O*NET work context is not held
state	string	no	Optional two-letter state for the program bridges

Line up 2 to 6 destination occupations side by side from one occupation: the bridge size (credential only, or the program bridges' awards as published), O*NET demand (median wage, outlook, bright outlook) and the evidence classes of the roads. Each cell is copied or counted, never scored.

Parameter	Type	Required	Notes
from_soc	string	yes	The occupation compared from, e.g. 51-4121
to_socs	array	yes	2 to 6 destination SOC codes, e.g. from find_transitions

Will my prior credits apply as credit at my target school? For each thing a person holds (an AP, CLEP or IB exam and its score, or a course taken at a school) the target school's own published transfer rules (CourseAtlas) and CollegeBoard's reported AP policy, in three states: covered (a rule carries it to a course at the target), missing (the target's own rule needs a higher score), unknown (no r

Parameter	Type	Required	Notes
checklist_id	string	no	Optional: the target program's checklist id; the answer then names the lines each covered item addresses
held	array	yes	1 to 20 things held: an exam { program: AP\|CLEP\|IB, exam: its code (e.g. AP 3700) or title (e.g. United States History), score }, or a course { unitid or school, code as printed (e.g. HIS 110) }
target_unitid	string	yes	The target school's IPEDS UNITID, e.g. 216038

Read a person's transcripts into their evidence package: each file's text and status, its courses and exams as rows, and the items will_my_credits_transfer takes (courses as { unitid or school, code }; AP, CLEP and IB exams with a score). Ask the person for each transcript and the school it came from. Several transcripts are read side by side. A school several schools' names fit is answered with t

Parameter	Type	Required	Notes
files	array	yes	1 or more transcripts
package	object	no	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.

Read a person's resume, LinkedIn export, certificates, military records and apprenticeship records into their evidence package: each file's text and status, and the credential signals the certificate, military and apprenticeship documents carry. Ask the person for each file. This assembles; the Selfie is my_selfie_ksa_view. Nothing is stored: the answer returns the package for the agent to keep.

Parameter	Type	Required	Notes
files	array	yes	1 or more files
linkedin_url	string	no	Optional: the person's LinkedIn profile address
package	object	no	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.

Record what a person says they have done outside school and work (family, clubs, sports, faith, travel, self-taught projects, challenges) in their evidence package, each placed in a Selfie dimension by the KSA classifier or left unresolved, never defaulted. These are the person's own statements, kept apart from formal education. Nothing is stored: the answer returns the package for the agent to ke

Parameter	Type	Required	Notes
entries	array	yes	1 to 20 life experiences
package	object	no	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.

The person's Selfie from their evidence package: the seven dimensions (skills, knowledge, abilities and more) as the evidence shows them, each item citing the file, the occupation O*NET describes, or the life experience it came from, plus what could not be placed. It mirrors, for the person to confirm, refine or reject; it is never a grade or a credit decision. The person's placements and dismissa

Parameter	Type	Required	Notes
aspiration	string	no	Optional: what the person is aiming for
language	string	no	—
package	object	yes	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.

Draft the credit claims a person's evidence supports, from their package (after my_selfie_ksa_view): each claim quotes the document it rests on. They are drafts for the person to keep, affirm or decline (set each claim's confidence to ratified, affirmed or declined in the package); the AI never affirms a claim. Give the school they are thinking of as school so its catalog is made ready for sugge

Parameter	Type	Required	Notes
aspiration	string	no	Optional: what the person is aiming for
language	string	no	—
package	object	yes	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.
school	string	no	Optional: the school they are thinking of, a name or IPEDS UNITID; its catalog is made ready for the suggestions

Where is a person in the program they are aiming for, and what may their learning meet? Name the program with checklist_id (find it with find_programs at that school) and the answer is that program's checklist line by line: the lines their claims may meet, each with the claim, how well it is corroborated and every link cited; the lines a transfer answer in their package already covers; and the l

Parameter	Type	Required	Notes
aspiration	string	no	Optional: what the person is aiming for
checklist_id	string	no	The program the person is aiming for, from find_programs or find_checklists at that school. Its lines are the only courses considered; without it no course is suggested.
language	string	no	—
package	object	yes	The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.
target_unitid	string	yes	The school's IPEDS UNITID, e.g. 240620

What should I study? For a person's own words — an interest, a subject or a job — or a job code (SOC), the majors that answer. Each major carries its plain definition (NCES verbatim), the award levels it is conferred at (IPEDS AWLEVEL, each completers flag in its own field and never summed), how many schools offer it nationally, the jobs it leads to through the federal CIP-SOC crosswalk, and its r

Parameter	Type	Required	Notes
level	string	no	Optional award level to narrow to, e.g. certificate, associate or bachelor's
limit	integer	no	Optional page size (default 10, at most 25)
offset	integer	no	Optional: the offset of the next page
soc	string	no	Or a job code (SOC), e.g. 29-1141 for Registered Nurses; every major the federal crosswalk ties to it answers
state	string	no	Optional two-letter state, for the school counts
words	string	no	The person's own words: an interest, a subject, or a job, e.g. I like fixing things

How do these majors differ? Two to five majors at one level, side by side: definition, the schools offering it, the jobs and their outlook from O*NET, and earnings at 1 and 5 years with debt — given as the LOWEST-TO-HIGHEST RANGE across the schools that publish them, with the number of schools stated. A range of school figures, never a median computed from them. A six-digit major's earnings come f

Parameter	Type	Required	Notes
level	string	yes	The credential level to compare at, e.g. certificate
majors	array	yes	2 to 5 majors, each a major_minor_id (e.g. CIP:51.3801) or a CIP code
state	string	no	Optional two-letter state, for the school counts

Where can I study this? A match-up, not a dump: for a major and a level, the schools that award it, ranked by how many of the person's own criteria each one meets, with met, not met and not testable kept as three different results — a school that does not publish a fact is not testable on it, never failed. Each criterion names the source that decided it, each school carries its own program, award,

Parameter	Type	Required	Notes
also_offers	array	no	Optional other subjects or majors the school should also offer
award	string	no	Optional award title or credential class
city	string	no	Optional city
cost_max	number	no	Optional: the most the person will pay. A school that publishes no cost is not removed by it — it is ranked below and marked not testable on cost
delivery	string	no	Optional: in person, hybrid or online
exclude_untestable	boolean	no	Optional strict exclusion, off by default: remove schools that do not publish one of the criteria. The answer then says how many were removed and by which criterion
level	string	yes	The credential level, e.g. certificate, associate or bachelor's
limit	integer	no	Optional page size (default 10, at most 25)
major	string	yes	The major: a major_minor_id (e.g. CIP:51.3801) or a CIP code
near	string	no	Optional: a place and a distance, e.g. Casper WY within 50 miles
offset	integer	no	Optional: the offset of the next page
sector	string	no	Optional school type as IPEDS labels it, e.g. public 2-year
state	string	no	Optional two-letter state. With no state, city or place the answer is national and says so
with_checklist	boolean	no	Optional: only schools whose requirements CourseShelf holds

Which of these schools is better for me? Two to five schools, one major and a level, side by side: program and award, credits required verbatim, requirements compared line by line, and — when the person offers their courses and exam scores — what each school's own published rules would count them for, with GoldCheck's states and reasons carried through unchanged. Credits left is reduced only by it

Parameter	Type	Required	Notes
held	array	no	Optional: the same shape will_my_credits_transfer takes — an exam { program, exam, score } or a course { unitid or school, code }
level	string	yes	The credential level
major	string	yes	The major: a major_minor_id or a CIP code
package	object	no	Optional: the agent-held GoldRibbon package. GoldSeam stores no copy of it
unitids	array	yes	2 to 5 schools, by IPEDS UNITID

What's my best way there? For a goal — a major or a job — and what the person brings (courses, exams, their Competency Selfie, work and life experience), the paths to it, each saying WHY it ranks where it does and naming the figures that moved it. The steps appear only where an agreement or pathway document states them, never assembled from award levels alone. Every item the person brought is mark

Parameter	Type	Required	Notes
goal	string	yes	A major (a major_minor_id or CIP) or a job (a SOC code)
held	array	no	Optional: courses and exams, the shape will_my_credits_transfer takes
level	string	yes	The level the person wants
limit	integer	no	Optional page size (default 10, at most 25)
package	object	no	Optional: the agent-held GoldRibbon package, read by suggest_credit_for_my_learning. GoldSeam stores no copy
state	string	no	Optional two-letter state: where they are

Where are you running it?

Tool surface

Release history

Goldseam MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also