# SignalDesk AI ROR Organization Search

> SignalDesk AI ROR Organization Search is a paid API for AI agents from x402-agent.kariguetoazul.workers.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

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

## Facts

- Endpoint: GET https://x402-agent.kariguetoazul.workers.dev/api/research/ror-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signaldesk-ai-ror-organization-search-99bd6c79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0jsMsiy1_bnEl4lDBPRRo

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 signaldesk-ai-ror-organization-search-99bd6c79
```

Example prompt: Can you search the Research Organization Registry for 'University of Lisbon' and return up to 5 matching institutions with their ROR IDs, types, countries, and websites?

## When to prefer this

Use this endpoint when you need to resolve institution names to canonical ROR identifiers, retrieve structured metadata (types, country, website) for academic or research organizations, or enrich datasets with standardized organization records. Prefer this over generic web search when you need machine-readable, CC0-licensed registry data from the authoritative global research organization index.

## Known failure modes

- Empty query string returns validation error (minLength:1 violation)
- Query longer than 200 characters returns validation error
- No matching organizations found returns total:0 with empty results array
- ROR upstream API unavailable causes proxy error
- limit parameter outside 1-20 range returns validation error
- Payment (x402) not provided or insufficient results in 402 response

## How this service works

Evidence-backed autonomous AI jobs and paid data tools. Queue/D1/cron run outside the chat; free quotas and bounded execution apply.

## Output

Returns a JSON object with the total number of matching organizations, source provenance metadata (provider, license, fetch timestamp, source URL), and an array of result objects each containing the ROR ID URI, organization name, types array (e.g. education, funder), country, and website URL.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "maxLength": 200,
       "minLength": 1,
       "description": "Search query."
      },
      "limit": {
       "type": "integer",
       "maximum": 20,
       "minimum": 1,
       "description": "Results, default 5."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 34695,
  "source": {
   "license": "CC0",
   "provider": "ROR",
   "expires_at": "2026-10-03T09:44:50.128Z",
   "fetched_at": "2026-10-02T09:44:50.128Z",
   "source_url": "https://api.ror.org/v2/organizations?query=University%20of%20Lisbon",
   "transformed": true
  },
  "results": [
   {
    "id": "https://ror.org/01c27hj86",
    "name": "University of Lisbon",
    "types": [
     "education",
     "funder"
    ],
    "country": "Portugal",
    "website": "https://www.ulisboa.pt"
   },
   {
    "id": "https://ror.org/04bcdt432",
    "name": "Universidade Europeia",
    "types": [
     "education"
    ],
    "country": "Portugal",
    "website": "https://www.europeia.pt/en"
   },
   {
    "id": "https://ror.org/00zjprf31",
    "name": "Lusíada University of Lisbon",
    "types": [
     "education"
    ],
    "country": "Portugal",
    "website": "http://www.lis.ulusiada.pt/en-gb/home.aspx"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signaldesk-ai-ror-organization-search-99bd6c79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-agent.kariguetoazul.workers.dev](https://www.zero.xyz/host/x402-agent.kariguetoazul.workers.dev/llms.txt)