# ROR Research Organization Search

> ROR Research Organization Search is a paid API for AI agents from x402-v2-mint-ror-org-search.vercel.app, paid per call via x402, $0.020102/call, status unknown (last checked 2026-11-20).

Search the Research Organization Registry (ROR) for academic and research institutions by name or keyword, returning structured organization metadata.

## Facts

- Endpoint: POST https://x402-v2-mint-ror-org-search.vercel.app/v1/ror-organization-search?utm_source=zero.xyz
- Price: $0.020102/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ror-research-organization-search-a5729663
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4CprxNtlbMWCZH8jXFicb

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 ror-research-organization-search-a5729663 -d '<json body>'
```

Example prompt: Can you look up 'Stanford University' in the Research Organization Registry and find its ROR ID and official metadata?

## When to prefer this

Use this endpoint when you need to resolve, identify, or retrieve metadata for academic or research institutions using the Research Organization Registry — especially when you need persistent ROR identifiers for scholarly workflows, grant systems, or manuscript submission. Prefer this over free-text search when you need a globally unique, citable institutional identifier (ROR ID) compatible with OpenAlex, Crossref, and other scholarly infrastructure. It is keyless (no API key setup required beyond x402 payment).

## Known failure modes

- Empty or missing query (q/query field) returns HTTP 400 and is not charged
- Query with no matching organizations returns empty results list
- Page parameter out of range (>20 or <1) returns validation error
- Network or upstream ROR API outage may cause 503 or timeout
- Ambiguous short queries may return many loosely-matched results

## How this service works

listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.

## Output

Returns a JSON object confirming the search was processed, with a list of matching research organizations including their ROR IDs, canonical names, country, and related metadata sourced from ROR (with OpenAlex and Crossref adjacency). Includes an 'ok' boolean and 'charged' flag indicating a successful paid query.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 200
  },
  "page": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 200
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": "ror-organization-search",
  "charged": true,
  "summary": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ror-research-organization-search-a5729663/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-ror-org-search.vercel.app](https://www.zero.xyz/host/x402-v2-mint-ror-org-search.vercel.app/llms.txt)
