Match Affiliation String to Organizations
ror.organizations.affiliationIntelligently match a free-text affiliation string (as found in academic paper bylines or grant records) to research organizations in the ROR registry. Pass the raw affiliation text exactly as it appears — e.g. "Dept. of Physics, Univ. of California, Berkeley, CA, USA" or "Max-Planck-Institut für Astronomie, Heidelberg". ROR's affiliation matching algorithm performs substring detection, name-variant lookup, and scoring to identify candidate organizations. Returns each candidate with: confidence score (0–1), a "chosen" boolean (the best single match), matching_type (e.g. SINGLE SEARCH, COMMON TERMS), and the organization's ROR ID, canonical name, type, and country. Ideal for metadata curation, ORCID affiliation disambiguation, funder acknowledgment normalization, and building organization-level research analytics from unstructured text.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| affiliation | Yes | Free-text affiliation string to match against the ROR registry, as it appears in an academic paper or grant record (e.g. "Dept. of Physics, Univ. of California, Berkeley, CA, USA"). ROR uses intelligent substring matching to identify the best candidate organizations. Returns each candidate with a confidence score (0–1) and a "chosen" flag. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when the call failed. Includes error code, message, request_id, and any provider-specific extras. | |
| result | No | Tool response payload. Shape varies per tool — consult the tool description and inputSchema. May be an object, array, string, or number depending on the upstream provider response. |