MCP 服务器

goldseam

com.ksaworks/goldseam
教育 知识与文档 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Provides education and credential data covering institutions, programs, courses, certifications, transfer pathways, policies, and academic checklists.

assemble_my_formal_education
Assemble My Formal Education
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 the candidates, and nothing is read. Nothing is stored: the answer returns the package for the agent to keep.
只读
输入模式
{'type': 'object', 'required': ['files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'object', 'required': ['slot', 'filename', 'content_base64'], 'properties': {'slot': {'enum': ['transcript'], 'type': 'string'}, 'school': {'type': 'string', 'description': 'The school the transcript came from, a name or initials (e.g. CNM); ask the person'}, 'unitid': {'type': 'string', 'description': "Or the school's IPEDS UNITID, e.g. 187532"}, 'filename': {'type': 'string'}, 'content_base64': {'type': 'string', 'description': "The file's bytes, base64. A call's files total at most about 1.5 MB; send more over several calls with the same package."}}}, 'description': '1 or more transcripts'}, 'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'files': {'type': 'array', 'description': 'Each file read, with its extraction_status'}, 'counts': {'type': 'object', 'description': 'files, readable, courses, exams'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'candidates': {'type': 'array', 'description': "When several schools fit a name: each file's candidates"}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
assemble_my_work_and_credentials
Assemble My Work and Credentials
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.
只读
输入模式
{'type': 'object', 'required': ['files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'object', 'required': ['slot', 'filename', 'content_base64'], 'properties': {'slot': {'enum': ['resume', 'linkedin_file', 'certs', 'military', 'apprentice'], 'type': 'string'}, 'filename': {'type': 'string'}, 'content_base64': {'type': 'string', 'description': "The file's bytes, base64. A call's files total at most about 1.5 MB; send more over several calls with the same package."}}}, 'description': '1 or more files'}, 'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}, 'linkedin_url': {'type': 'string', 'description': "Optional: the person's LinkedIn profile address"}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'files': {'type': 'array', 'description': 'Each file read, with its extraction_status'}, 'counts': {'type': 'object', 'description': 'files, readable, per_slot, credential_signals'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
assert_my_life_experiences
Assert My Life Experiences
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 keep.
只读
输入模式
{'type': 'object', 'required': ['entries'], 'properties': {'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'activity'], 'properties': {'weight': {'enum': ['occasional', 'regular', 'central'], 'type': 'string'}, 'activity': {'type': 'string', 'description': 'What the person did, in their words'}, 'category': {'enum': ['passions', 'sports', 'clubs', 'faith', 'family', 'selftaught', 'travel', 'challenges', 'other'], 'type': 'string'}, 'difficulty': {'enum': ['remember', 'understand', 'apply', 'analyze', 'evaluate', 'create'], 'type': 'string'}, 'elaboration': {'type': 'string'}, 'life_period': {'enum': ['childhood', 'adolescence', 'emerging_adult', 'early_adult', 'midlife', 'experienced', 'later_life'], 'type': 'string'}}}, 'description': '1 to 20 life experiences'}, 'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'counts': {'type': 'object', 'description': 'entries, added, unresolved'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'entries': {'type': 'array', 'description': 'Each entry with its dimension, placement, facets and placed_by'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
certifications_for_occupation
Certifications for Occupation
What certifications serve this occupation? SOC-keyed lookup (dashed SOC accepted with or without the O*NET .00 suffix).
只读
输入模式
{'type': 'object', 'required': ['soc'], 'properties': {'soc': {'type': 'string', 'examples': ['29-1141', '47-2111'], 'description': "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"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
certifications_for_program
Certifications for Program
Broad academic cross-reference by instructional program (CIP). A deliberately broader, lower-precision question than an occupation lookup — never its peer (contract § 4).
只读
输入模式
{'type': 'object', 'required': ['cip'], 'properties': {'cip': {'type': 'string', 'examples': ['51.3801', '47.0201'], 'description': 'A college program code (CIP), e.g. 51.3801 for Registered Nursing or 47.0201 for HVAC technology'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
checklists_requiring_learning_unit
Checklists Requiring Learning Unit
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 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.
只读
输入模式
{'type': 'object', 'required': ['learning_unit_id'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'learning_unit_id': {'type': 'string', 'examples': ['LU_course_225070_ENGL1301_20262027'], 'description': 'A learning unit id from learning_units or get_learning_unit'}}}
comparability_for_learning_unit
Comparability for a Course
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 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.
只读
输入模式
{'type': 'object', 'properties': {'code': {'type': 'string', 'description': 'The course code as printed, e.g. HIST 201'}, 'limit': {'type': 'integer', 'description': 'Optional page size per list (default 10, at most 50)'}, 'title': {'type': 'string', 'description': 'Or: the course title, matched exactly'}, 'offset': {'type': 'integer', 'description': 'Optional: the offset of the next page'}, 'school': {'type': 'string', 'description': "Or: the course's school, by name (with code or title)"}, 'unitid': {'type': 'string', 'description': "Or: the course's school, by IPEDS UNITID (with code or title)"}, 'direction': {'enum': ['lands_as', 'lands_on', 'both'], 'type': 'string', 'description': 'lands_as: where it lands; lands_on: what lands on it; both (default)'}, 'target_unitid': {'type': 'string', 'description': 'Optional: narrow where it lands to one receiving school (IPEDS UNITID)'}, 'learning_unit_id': {'type': 'string', 'description': 'The course, by its learning unit id'}}}
compare_destinations
Compare Destinations
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.
只读
输入模式
{'type': 'object', 'required': ['from_soc', 'to_socs'], 'properties': {'to_socs': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['51-4122', '17-3029']], 'description': '2 to 6 destination SOC codes, e.g. from find_transitions'}, 'from_soc': {'type': 'string', 'examples': ['51-4121'], 'description': 'The occupation compared from, e.g. 51-4121'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'values': {'type': 'array'}}}}, 'columns': {'type': 'array'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}}}
compare_my_major
Compare My Major
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 from its four-digit series and every such figure is labelled series-level. Every column is complete, or it says which figure is not published.
只读
输入模式
{'type': 'object', 'required': ['majors', 'level'], 'properties': {'level': {'type': 'string', 'examples': ['certificate'], 'description': 'The credential level to compare at, e.g. certificate'}, 'state': {'type': 'string', 'description': 'Optional two-letter state, for the school counts'}, 'majors': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['CIP:51.3901', 'CIP:51.3902']], 'description': '2 to 5 majors, each a major_minor_id (e.g. CIP:51.3801) or a CIP code'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'columns': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One column per major, aligned so a gap is never read as a low number'}, 'contract': {'type': 'string'}, 'not_held': {'type': 'array', 'items': {'type': 'object'}}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'comparison_rule': {'type': 'string'}}}
compare_my_school
Compare My School
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 items a school's own rules cover; an unknown item, or an inference, never reduces it. Cost, earnings, debt with its 10-year monthly payment beside it, and payback in months where both inputs are published; where either is missing, payback is not computed and the missing input is named. The comparison never ranks: no score is invented to decide for the person.
只读
输入模式
{'type': 'object', 'required': ['unitids', 'major', 'level'], 'properties': {'held': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Optional: the same shape will_my_credits_transfer takes — an exam { program, exam, score } or a course { unitid or school, code }'}, 'level': {'type': 'string', 'description': 'The credential level'}, 'major': {'type': 'string', 'description': 'The major: a major_minor_id or a CIP code'}, 'package': {'type': 'object', 'description': 'Optional: the agent-held GoldRibbon package. GoldSeam stores no copy of it'}, 'unitids': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['240505', '240628']], 'description': '2 to 5 schools, by IPEDS UNITID'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'columns': {'type': 'array', 'items': {'type': 'object'}, 'description': "One column per school: what the person's credits are worth there, credits left, cost, and payback or the input it is missing"}, 'contract': {'type': 'string'}, 'not_held': {'type': 'array', 'items': {'type': 'object'}}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'comparison_rule': {'type': 'string'}, 'requirements_side_by_side': {'type': 'object', 'description': "compare_program_checklists' own answer, called and not re-implemented"}}}
compare_program_checklists
Compare Program Checklists
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 stated as such. 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.
只读
输入模式
{'type': 'object', 'required': ['unitids', 'program'], 'properties': {'detail': {'type': 'string', 'examples': ['summary'], 'description': "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)"}, 'program': {'type': 'string', 'examples': ['Welding'], 'description': 'Program or award words to match, e.g. nursing or Bachelor of Science in Nursing'}, 'unitids': {'type': 'array', 'items': {'type': 'string'}, 'examples': [['225070']], 'description': '1 to 10 IPEDS UNITIDs, e.g. ["100663", "127060"]; answered 5 institutions per call, up to 3 checklists each'}, 'institution_offset': {'type': 'integer', 'description': 'Optional: the next_institution_offset from a previous answer, for the next 5 institutions'}}}
crosswalk_code
Crosswalk Code
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.
只读
输入模式
{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'examples': ['51.3801', '29-1141'], 'description': 'A college program code (CIP, e.g. 51.3801) or an occupation code (SOC, e.g. 29-1141)'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
draft_my_claims
Draft My Claims
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 suggest_credit_for_my_learning. Nothing is stored: the answer returns the package for the agent to keep.
只读
输入模式
{'type': 'object', 'required': ['package'], 'properties': {'school': {'type': 'string', 'description': 'Optional: the school they are thinking of, a name or IPEDS UNITID; its catalog is made ready for the suggestions'}, 'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'claims': {'type': 'array', 'description': 'The claims drafted by this call, each with summary, source_fragment, kind, evidence_tier, confidence (drafted) and recommendation_mode'}, 'counts': {'type': 'object', 'description': 'drafted, answered_kept'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
expand_term
Expand Term
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.
只读
输入模式
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'examples': ['carpentry', 'nursing'], 'description': 'A word to see what broader kind of thing it is, e.g. carpentry'}}}
find_agreements
Find Agreements
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 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.
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional agreement title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: an institution party's IPEDS UNITID"}}}
find_catalogs
Find Catalogs
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 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.
只读
输入模式
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "The institution's IPEDS UNITID, e.g. 225070"}}}
find_checklists
Find Checklists
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 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.
只读
输入模式
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional award words, e.g. welding'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}, 'program_id': {'type': 'string', 'description': "Optional: one program's id"}}}
find_comparability
Find Comparability
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 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.
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: the receiving institution's IPEDS UNITID"}, 'agreement_id': {'type': 'string', 'description': 'Optional: the agreement that states it'}, 'learning_unit_id': {'type': 'string', 'description': 'Optional: a course named in it'}}}
find_institution
Find Institution
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 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.
只读
输入模式
{'type': 'object', 'properties': {'city': {'type': 'string', 'examples': ['Denison'], 'description': "Optional city, one of a state answer's cities, e.g. Denison"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'examples': ['Grayson', '225070'], 'description': 'Name fragment or IPEDS UNITID, e.g. Denver or 127060'}, 'state': {'type': 'string', 'examples': ['TX'], 'description': "Optional two-letter state, e.g. TX: that state's institutions, those with a catalog held first; the answer lists the state's cities"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
find_my_best_pathway
Find My Best Pathway
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 marked counted, not counted or needs review and appears in the answer: nothing is dropped silently. A path missing an input is ranked with that gap named rather than penalised invisibly.
只读
输入模式
{'type': 'object', 'required': ['goal', 'level'], 'properties': {'goal': {'type': 'string', 'examples': ['29-1141'], 'description': 'A major (a major_minor_id or CIP) or a job (a SOC code)'}, 'held': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Optional: courses and exams, the shape will_my_credits_transfer takes'}, 'level': {'type': 'string', 'description': 'The level the person wants'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 25)'}, 'state': {'type': 'string', 'description': 'Optional two-letter state: where they are'}, 'package': {'type': 'object', 'description': 'Optional: the agent-held GoldRibbon package, read by suggest_credit_for_my_learning. GoldSeam stores no copy'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'paths': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One per path: school, program, checklist, steps, credits left, cost, payback, and why it ranks where it does'}, 'steps': {'type': 'object', 'description': 'Shown only where an agreement or pathway document states them'}, 'contract': {'type': 'string'}, 'not_held': {'type': 'array', 'items': {'type': 'object'}}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'ranking_rule': {'type': 'string'}, 'what_you_brought': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Every item, marked counted, not counted or needs review, each with its reason'}}}
find_my_major
Find My Major
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 related majors — same series, same family, or sharing a named occupation. Words resolve through the KSA Dictionary, never by spelling match; words that match nothing are told so with the closest words the Dictionary holds. The count for a person's own state is stated not held: the per-school IPEDS rows are not in this publish.
只读
输入模式
{'type': 'object', 'anyOf': [{'required': ['words']}, {'required': ['soc']}], 'properties': {'soc': {'type': 'string', 'examples': ['29-1141'], 'description': 'Or a job code (SOC), e.g. 29-1141 for Registered Nurses; every major the federal crosswalk ties to it answers'}, 'level': {'type': 'string', 'description': "Optional award level to narrow to, e.g. certificate, associate or bachelor's"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 25)'}, 'state': {'type': 'string', 'description': 'Optional two-letter state, for the school counts'}, 'words': {'type': 'string', 'examples': ['carpentry'], 'description': "The person's own words: an interest, a subject, or a job, e.g. I like fixing things"}, 'offset': {'type': 'integer', 'description': 'Optional: the offset of the next page'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'majors': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One card per major: definition, levels, schools_offering_it, jobs, related_majors — each saying which part is not held'}, 'contract': {'type': 'string'}, 'not_held': {'type': 'array', 'items': {'type': 'object'}, 'description': 'The reference tables this publish does not carry, by name'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'words_read': {'type': 'object', 'description': "How the person's words resolved: the layer each placement came from, and the closest words when nothing matched"}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'total_matching': {'type': 'integer'}}}
find_my_school
Find My School
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, credits required, cost, earnings, debt and whether it can be done online, and a filter only ever excludes on a fact we hold. The answer states its ranking rule and never recommends a school. TODAY the candidate set is the schools CourseShelf has captured a program for, not yet every school IPEDS lists, and every answer opens by saying so.
只读
输入模式
{'type': 'object', 'required': ['major', 'level'], 'properties': {'city': {'type': 'string', 'description': 'Optional city'}, 'near': {'type': 'string', 'description': 'Optional: a place and a distance, e.g. Casper WY within 50 miles'}, 'award': {'type': 'string', 'description': 'Optional award title or credential class'}, 'level': {'type': 'string', 'examples': ['associate'], 'description': "The credential level, e.g. certificate, associate or bachelor's"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 25)'}, 'major': {'type': 'string', 'examples': ['CIP:51.3801'], 'description': 'The major: a major_minor_id (e.g. CIP:51.3801) or a CIP code'}, 'state': {'type': 'string', 'description': 'Optional two-letter state. With no state, city or place the answer is national and says so'}, 'offset': {'type': 'integer', 'description': 'Optional: the offset of the next page'}, 'sector': {'type': 'string', 'description': 'Optional school type as IPEDS labels it, e.g. public 2-year'}, 'cost_max': {'type': 'number', 'description': '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': {'type': 'string', 'description': 'Optional: in person, hybrid or online'}, 'also_offers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional other subjects or majors the school should also offer'}, 'with_checklist': {'type': 'boolean', 'description': 'Optional: only schools whose requirements CourseShelf holds'}, 'exclude_untestable': {'type': 'boolean', 'description': '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'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'scope': {'type': 'string', 'description': 'Said when the answer is national because no place was given'}, 'schools': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One row per school: its program with the route that joined it to the major, cost, earnings and debt, its programs that could not be joined, and its standing — every criterion with its verdict and source'}, 'contract': {'type': 'string'}, 'not_held': {'type': 'array', 'items': {'type': 'object'}}, 'statement': {'type': 'string', 'description': 'What the candidate set is, as the first thing the person reads'}, 'understood': {'type': 'object'}, 'ranking_rule': {'type': 'string'}, 'candidate_set': {'type': 'object', 'description': "Where the schools came from and why it is not yet IPEDS's list"}, 'measure_not_met': {'type': 'string', 'description': 'The measure this build does not yet meet, named in the answer'}, 'strict_exclusion': {'type': 'object', 'description': 'Present only when exclude_untestable was asked for: how many schools were removed, by which criterion'}}}
find_pathways
Find Pathways
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_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.
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional pathway title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'agreement_id': {'type': 'string', 'description': 'Optional: the agreement a pathway rests on'}, 'checklist_id': {'type': 'string', 'description': 'Optional: the checklist a pathway follows'}}}
find_policies
Find Policies
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 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.
只读
输入模式
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional policy words, e.g. transfer'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "The institution's IPEDS UNITID, e.g. 225070"}}}
find_programs
Find Programs
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 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.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'city': {'type': 'string', 'description': "Optional city: programs at that city's institutions"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'examples': ['Welding'], 'description': 'Program or award words, e.g. welding or nursing'}, 'state': {'type': 'string', 'description': "Optional two-letter state: programs at that state's institutions"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'description': "Optional: one institution's IPEDS UNITID"}}}
find_transfer_frameworks
Find Transfer Frameworks
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, 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.
只读
输入模式
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional framework name or jurisdiction words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
find_transitions
Find Transitions
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 publishes it. Roads only, no person data.
只读
输入模式
{'type': 'object', 'anyOf': [{'required': ['from_soc']}, {'required': ['from']}], 'properties': {'from': {'type': 'string', 'description': 'Or the job in everyday words, e.g. welder; several matching occupations answer candidates to pick from'}, 'class': {'type': 'string', 'description': 'Optional: only destinations with a road of this class (published, mapped)'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 25)'}, 'state': {'type': 'string', 'description': 'Optional two-letter state for the program bridges'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'prefer': {'type': 'string', 'description': 'Optional preference such as less physical; answered not held when O*NET work context is not held'}, 'from_soc': {'type': 'string', 'examples': ['51-4121'], 'description': "The occupation's SOC code, e.g. 51-4121 (an O*NET .00 code is accepted)"}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'facets': {'type': 'object'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'edges': {'type': 'array', 'items': {'type': 'object', 'properties': {'basis': {'type': 'string'}, 'class': {'type': 'string'}, 'karat': {'type': 'string'}, 'source': {'type': 'string'}}}}, 'title': {'type': 'string'}, 'demand': {'type': 'object'}, 'to_soc': {'type': 'string'}, 'bridges': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}, 'description': 'The destination cards'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'total_matching': {'type': 'integer'}}}
get_agreement
Get Agreement
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 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.
只读
输入模式
{'type': 'object', 'required': ['agreement_id'], 'properties': {'agreement_id': {'type': 'string', 'description': 'An agreement id from find_agreements'}}}
get_catalog
Get Catalog
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, 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.
只读
输入模式
{'type': 'object', 'required': ['catalog_id'], 'properties': {'catalog_id': {'type': 'string', 'description': 'A catalog id from find_catalogs'}}}
get_certification
Get Certification
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.
只读
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_13108200_8F3480AC7A'], 'description': "A certification id, copied from a search result's id field"}}}
get_checklist
Get Checklist
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 the captured page it came from. 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.
只读
输入模式
{'type': 'object', 'required': ['checklist_id'], 'properties': {'item_limit': {'type': 'integer', 'description': 'Optional items per page (default 60, at most 150)'}, 'item_offset': {'type': 'integer', 'description': 'Optional: the next_item_offset from a previous answer'}, 'checklist_id': {'type': 'string', 'examples': ['CK_225070_05e6e123'], 'description': 'A checklist id from programs_for_institution or compare_program_checklists'}}}
get_comparability
Get Comparability
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 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.
只读
输入模式
{'type': 'object', 'required': ['comparability_id'], 'properties': {'comparability_id': {'type': 'string', 'description': 'A comparability id from find_comparability'}}}
get_courseshelf_summary
CourseShelf Holdings Summary
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 published for this build is said so. 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.
只读
输入模式
{'type': 'object', 'properties': {}}
get_dictionary_summary
Get Dictionary Summary
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 words it holds are those it places; it is not all of WordNet, and the answer says so.
只读
输入模式
{'type': 'object', 'properties': {}}
get_institution
Get Institution
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 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.
只读
输入模式
{'type': 'object', 'anyOf': [{'required': ['organization_id']}, {'required': ['unitid']}], 'properties': {'unitid': {'type': 'string', 'description': 'Or its IPEDS UNITID instead, e.g. 225070'}, 'organization_id': {'type': 'string', 'examples': ['ORG_225070'], 'description': "The institution's organization id from find_institution, e.g. ORG_225070"}}}
get_learning_unit
Get Learning Unit
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 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.
只读
输入模式
{'type': 'object', 'required': ['learning_unit_id'], 'properties': {'learning_unit_id': {'type': 'string', 'examples': ['LU_course_225070_ENGL1301_20262027'], 'description': 'A learning unit id from learning_units or get_checklist'}}}
get_pathway
Get Pathway
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 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.
只读
输入模式
{'type': 'object', 'required': ['pathway_id'], 'properties': {'pathway_id': {'type': 'string', 'description': 'A pathway id from find_pathways'}}}
get_policy
Get Policy
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_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.
只读
输入模式
{'type': 'object', 'required': ['policy_id'], 'properties': {'policy_id': {'type': 'string', 'description': 'A policy id from find_policies'}}}
get_program
Get Program
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 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.
只读
输入模式
{'type': 'object', 'required': ['program_id'], 'properties': {'program_id': {'type': 'string', 'examples': ['PG_225070_8c96bb26'], 'description': 'A program id from programs_for_institution or find_programs'}}}
get_transfer_framework
Get Transfer Framework
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_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.
只读
输入模式
{'type': 'object', 'required': ['framework_id'], 'properties': {'framework_id': {'type': 'string', 'description': 'A framework id from find_transfer_frameworks'}}}
learning_units
Learning Units
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 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.
只读
输入模式
{'type': 'object', 'required': ['unitid'], 'properties': {'code': {'type': 'string', 'description': 'Optional course code, e.g. BIO 201'}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 50, at most 100)'}, 'query': {'type': 'string', 'description': 'Optional title words'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}, 'subject': {'type': 'string', 'examples': ['RNSG'], 'description': 'Optional subject abbreviation, e.g. BIO'}, 'unit_type': {'type': 'string', 'description': "Optional learning-unit type, one of the answer's unit_types, e.g. course"}}}
list_issuers
List Issuers
The issuing organizations, optionally filtered by a name query.
只读
输入模式
{'type': 'object', 'required': [], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'query': {'type': 'string', 'examples': ['IBM', 'nursing'], 'description': "Optional: part of an organization's name"}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
my_selfie_ksa_view
My Selfie (KSA View)
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 dismissals in the package's selfie.learner_decisions are honored. Nothing is stored: the answer returns the package with the Selfie for the agent to keep.
只读
输入模式
{'type': 'object', 'required': ['package'], 'properties': {'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'selfie': {'type': 'object', 'description': 'The seven dimensions in canon order, and learner_decisions'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'unresolved_items': {'type': 'array'}, 'evidence_by_source': {'type': 'array', 'description': "Each dimension's items grouped by the file, occupation or life experience they came from"}, 'evidence_truncated': {'type': 'array'}}}
occupations_for_certification
Occupations for Certification
What occupations does this certification serve?
只读
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_13108200_8F3480AC7A'], 'description': "A certification id, copied from a search result's id field"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
programs_for_institution
Programs for Institution
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 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.
只读
输入模式
{'type': 'object', 'required': ['unitid'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 100, at most 200)'}, 'query': {'type': 'string', 'description': 'Optional program or award words to filter by'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'unitid': {'type': 'string', 'examples': ['225070'], 'description': "The institution's IPEDS UNITID"}}}
related_certifications
Related Certifications
What else serves the same occupation? Traverses on SOC only — a certification sharing solely an instructional program (CIP) is not related (contract § 4).
只读
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'examples': ['LU_CERT_ONET_29114100_50CD2891D4'], 'description': "A certification id to find others like it, copied from a search result's id field"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
resolve_term
Resolve Term
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), each placement attributed to its layer with provenance; the WordNet placement carries the word's definition (gloss) and synonyms.
只读
输入模式
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string', 'examples': ['carpentry', 'mathematics', 'welding'], 'description': 'A word for something a person knows or can do, e.g. carpentry or mathematics'}}}
search_certifications
Search Certifications
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.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'description': 'Optional page size (default 20, at most 50)'}, 'query': {'type': 'string', 'examples': ['nursing', 'HVAC', 'welding', 'IBM', 'project management'], 'description': 'What you are looking for, in everyday words — a trade, field, job, or company'}, 'issuer': {'type': 'string', 'description': 'Optional: only certifications from this organization'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}}}
输出模式
{'type': 'object', 'required': ['contract'], 'properties': {'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'portal_url': {'type': 'string', 'description': 'The same search on the portal'}, 'understood': {'type': 'object', 'description': 'What was read: words, issuer, and match (step, matched_terms, statement)'}, 'next_offset': {'type': 'integer'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'certifications': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}, 'description': 'The certification cards'}, 'total_matching': {'type': 'integer'}}}
search_programs_and_learning_units
Search Programs and Learning Units
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. Courses across every school need words of 3 or more characters; words held by very many courses need a state, city or school. 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.
只读
输入模式
{'type': 'object', 'properties': {'cip': {'description': 'Optional: programs with this six-digit CIP code (e.g. 48.0508), a comma-separated list, or an array of codes'}, 'city': {'type': 'string', 'description': "Optional city, one of a state answer's cities"}, 'code': {'type': 'string', 'description': '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'}, 'type': {'type': 'string', 'examples': ['program'], 'description': 'program (the default) or learning_unit'}, 'award': {'type': 'string', 'examples': ['Certificate'], 'description': "Optional award exactly as published, one of the answer's awards"}, 'limit': {'type': 'integer', 'description': 'Optional page size (default 10, at most 50)'}, 'place': {'type': 'string', 'description': 'Optional: a place the question names, read as a state (name or code), a city, or a school, e.g. Wyoming or Casper'}, 'query': {'type': 'string', 'examples': ['nursing'], 'description': "Words: a program's name or award, or a course's title"}, 'state': {'type': 'string', 'examples': ['TX'], 'description': 'Optional two-letter state'}, 'offset': {'type': 'integer', 'description': 'Optional: the next_offset from a previous answer'}, 'sector': {'type': 'string', 'description': 'Optional school type as IPEDS labels it, e.g. public 2-year'}, 'unitid': {'type': 'string', 'description': "Optional: one school's IPEDS UNITID"}, 'subject': {'type': 'string', 'description': 'Optional CIP family (two digits, e.g. 51) or unknown'}, 'credential': {'type': 'string', 'description': "Optional, programs only: a credential class, one of the answer's credential values (e.g. ceterms:AssociateDegree), or none"}, 'subject_code': {'type': 'string', 'description': "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': 'object', 'required': ['contract', 'build_version', 'census_cleared', 'statement'], 'properties': {'facets': {'type': 'object', 'description': "The refinements: each facet's values with their counts of held rows"}, 'publish': {'type': 'integer', 'description': "The data road's publish number"}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string', 'description': 'program or learning_unit'}, 'award': {'description': 'The award as published, or null'}, 'school': {'type': 'object', 'description': 'name, city, state, sector, ipeds_unit_id'}, 'college': {'type': 'string', 'description': 'The college within the school that offers the program, when held'}, 'subject': {'type': 'object', 'description': 'cip_code, family, family_title, cip_source; absent when the program holds no CIP'}, 'leads_to': {'type': 'object', 'description': 'occupations through the CIP-SOC crosswalk; absent when none is held'}, 'checklist': {'description': 'checklist_id, requirements, credits_computed; or null'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'source_count': {'type': 'integer', 'description': 'How many sources print the record; absent for a record with one form and one source'}, 'normal_length': {'type': 'string', 'description': "A program's normal length as published, when held"}, 'version_count': {'type': 'integer', 'description': 'How many FORMS the record holds; absent for a record with one form and one source'}, 'form_statement': {'type': 'string', 'description': "One sentence about the record's forms and sources, and whether it was last seen in an older edition"}, 'credits_published': {'type': 'string', 'description': "A course's credits as printed, when held"}, 'last_edition_seen': {'type': 'string', 'description': 'The latest academic year a source prints it in; absent for a record with one form and one source'}, 'first_edition_seen': {'type': 'string', 'description': 'The earliest academic year a source prints it in; absent for a record with one form and one source'}, 'description_excerpt': {'type': 'string', 'description': "A course description's first 200 characters, with an ellipsis when longer; the full text is on get_learning_unit"}}}, 'description': 'The product cards'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'portal_url': {'type': 'string', 'description': 'The same view on the portal'}, 'understood': {'type': 'object', 'description': 'What was read: words, place (with candidates when several schools fit), the filters in force, question (frame, department, not_held words), lead (the product a page shows first), and match (step, words_used, stems, statement)'}, 'next_offset': {'type': 'integer'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}, 'build_version': {'type': 'integer', 'description': 'Deprecated: the same value as publish'}, 'census_cleared': {'type': 'boolean'}, 'total_matching': {'type': 'integer'}, 'union_statement': {'type': 'string', 'description': 'Said once when any card carries forms or sources: the full source list is in the structured data'}, 'schools_matching': {'type': 'integer', 'description': 'How many schools hold the matching set'}}}
suggest_credit_for_my_learning
Suggest Credit For My Learning
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 lines still needed. Learning no line matches stands as block credit. Without a program, no course is suggested and the claims stand as block credit. Each suggestion is a case to put to the school's prior learning review, never a promise: say may, never will. Nothing is stored: the answer returns the package with the suggestions for the agent to keep.
只读
输入模式
{'type': 'object', 'required': ['package', 'target_unitid'], 'properties': {'package': {'type': 'object', 'description': 'The goldribbon_package_v1 object an earlier GoldRibbon answer returned. Keep it for the person and send it back whole; GoldSeam keeps no copy.'}, 'language': {'enum': ['en', 'es', 'fr'], 'type': 'string'}, 'aspiration': {'type': 'string', 'description': 'Optional: what the person is aiming for'}, 'checklist_id': {'type': 'string', 'examples': ['CK_225070_05e6e123'], 'description': '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.'}, 'target_unitid': {'type': 'string', 'examples': ['240620'], 'description': "The school's IPEDS UNITID, e.g. 240620"}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'counts': {'type': 'object', 'description': 'claims, comparable_courses, block_credits, checklist_lines, may_be_met, already_covered, still_needed'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'package': {'type': 'object', 'description': "The person's package, with this service's part filled"}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'suggestions': {'type': 'object', 'description': 'unitid, school, checklist_id, program, checklist (every line in its own order, each may_be_met with the claim, band and cited chain, already_covered, or still_needed), comparable_courses, block_credits, affirmed_not_pursued'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
will_my_credits_transfer
Will My Credits Transfer
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 rule held; never a guess). Each covered item names the course it lands as, every rule with its minimum score and dates, how many rules agree, and the target's programs whose checklists require that course. A case to argue, not a verdict; recognition is the school's act. 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.
只读
输入模式
{'type': 'object', 'required': ['held', 'target_unitid'], 'properties': {'held': {'type': 'array', 'items': {'type': 'object'}, 'examples': [[{'exam': 'United States History', 'score': 3, 'program': 'AP'}]], 'description': '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) }'}, 'checklist_id': {'type': 'string', 'description': "Optional: the target program's checklist id; the answer then names the lines each covered item addresses"}, 'target_unitid': {'type': 'string', 'examples': ['216038'], 'description': "The target school's IPEDS UNITID, e.g. 216038"}}}
输出模式
{'type': 'object', 'required': ['contract', 'statement'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One per held item: held, read_as, state (covered|missing|unknown), reason, lands_as (course, learning_unit_id, rules, corroboration, band, satisfies), statement'}, 'counts': {'type': 'object', 'description': 'covered, missing, unknown'}, 'limits': {'type': 'array', 'description': 'What this answer could not do, each { code, statement }'}, 'target': {'type': 'object'}, 'contract': {'type': 'string'}, 'statement': {'type': 'string'}, 'understood': {'type': 'object'}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'tool', 'arguments'], 'properties': {'tool': {'type': 'string', 'description': 'A GoldSeam service'}, 'label': {'type': 'string'}, 'arguments': {'type': 'object'}}}}}}
已添加
find_my_best_pathway
2026年10月3日 03:01
已添加
compare_my_school
2026年10月3日 03:01
已添加
find_my_school
2026年10月3日 03:01
已添加
compare_my_major
2026年10月3日 03:01
已添加
find_my_major
2026年10月3日 03:01
已更改
will_my_credits_transfer
2026年10月3日 03:01
已更改
comparability_for_learning_unit
2026年10月3日 03:01
已更改
get_courseshelf_summary
2026年10月3日 03:01
已更改
search_programs_and_learning_units
2026年10月3日 03:01
已更改
checklists_requiring_learning_unit
2026年10月3日 03:01
已更改
get_transfer_framework
2026年10月3日 03:01
已更改
find_transfer_frameworks
2026年10月3日 03:01
已更改
get_comparability
2026年10月3日 03:01
已更改
find_comparability
2026年10月3日 03:01
已更改
get_pathway
2026年10月3日 03:01
已更改
find_pathways
2026年10月3日 03:01
已更改
get_agreement
2026年10月3日 03:01
已更改
find_agreements
2026年10月3日 03:01
已更改
find_checklists
2026年10月3日 03:01
已更改
get_policy
2026年10月3日 03:01
已更改
find_policies
2026年10月3日 03:01
已更改
get_learning_unit
2026年10月3日 03:01
已更改
get_program
2026年10月3日 03:01
已更改
find_programs
2026年10月3日 03:01
已更改
get_catalog
2026年10月3日 03:01
已更改
find_catalogs
2026年10月3日 03:01
已更改
get_institution
2026年10月3日 03:01
已更改
learning_units
2026年10月3日 03:01
已更改
get_checklist
2026年10月3日 03:01
已更改
programs_for_institution
2026年10月3日 03:01