# 2s Research Organization Registry (ROR) Lookup

> 2s Research Organization Registry (ROR) Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.0012/call, status unknown (last checked 2026-09-13).

Looks up or searches research organizations by ROR ID or free-text name, returning verified organization metadata including type, location, and canonical IDs.

## Facts

- Endpoint: GET https://2s.io/api/research/org
- Price: $0.0012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-research-organization-registry-ror-lookup-10c35ab4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WZDnPWYbKHsPmMnP7LU_D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-research-organization-registry-ror-lookup-10c35ab4
```

Example prompt: Can you look up 'Stanford University' in the Research Organization Registry and tell me its official ROR ID, type, and location?

## When to prefer this

Use this endpoint when you need to resolve a research institution, university, company, hospital, or government body to its canonical ROR identifier, or when you need verified metadata (type, location) about a known organization. Prefer this over general web search when you need structured, authoritative, deduplicated organizational identity data from the open scholarly infrastructure.

## Known failure modes

- No matching organization found for the given name — returns empty organizations array with total=0
- Invalid ROR ID format — may return no results or an error
- Name query too broad — may return up to 'limit' results but many may be irrelevant
- Rate or payment failure — 402 response if payment not provided
- Network timeout for slow upstream ROR queries

## How this service works

Resolve a research organization via the Research Organization Registry (ROR). Pass id (a ROR id like 056y0v115 or its full URL) to fetch one org, or name to search by free text. Returns the canonical ROR id and name, organization type, status, founding year, location (city, country, GeoNames coordinates), website, Wikipedia link, external identifiers (GRID, ISNI, Wikidata, Crossref Funder), parent/child relationships, and aliases/acronyms. Data: ROR, free and CC0. The canonical institution key in scholarly metadata — pair with /api/papers/search and /api/paper/doi-lookup (author affiliations) and /api/research/author (ORCID). Use to disambiguate an institution name to a stable id before joining datasets.

## Output

Returns a list of matching organizations with their canonical ROR IDs, display names, organization types (e.g. company, education, government), and location details (city and country code), plus the total count of matches and the data source (ROR).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "name": "Stanford University",
   "limit": 5
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "id": {
       "type": "string",
       "description": "ROR id, e.g. 056y0v115 or https://ror.org/056y0v115."
      },
      "name": {
       "type": "string",
       "description": "Free-text organization name to search."
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "maximum": 20,
       "minimum": 1,
       "description": "Max results in name-search mode."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-research-organization-registry-ror-lookup-10c35ab4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)