# RelayShield Bulk Identity Risk

> RelayShield Bulk Identity Risk is a paid API for AI agents from api.relayshield.net, paid per call via x402, $2/call, status unknown (last checked 2026-09-14).

Scores and grades multiple domains for identity/agent risk in a single bulk API call, returning agent counts, domain grades, and risk severity counts

## Facts

- Endpoint: POST https://api.relayshield.net/v1/payg/bulk-identity-risk
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/relayshield-bulk-identity-risk-657f8a6e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RGJfStFKFq4Iq8Ptbw4Kw

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 relayshield-bulk-identity-risk-657f8a6e -d '<json body>'
```

Example prompt: Can you run a bulk identity risk check on these domains — acme.com, rivercorp.io, and shadysender.net — and tell me which ones have a high or critical risk grade?

## When to prefer this

Choose this endpoint when you need to evaluate identity or agent-communication risk for multiple domains in a single call rather than one at a time. It is especially suited for agent fleet security checks, email sender screening, and vendor onboarding workflows where you have a batch of domains and want aggregate risk counts (high/critical) alongside per-domain grades and scores, all in one round trip.

## Known failure modes

- Invalid or malformed domain names in the input list may cause individual results to be skipped or error
- Payment failure via x402 protocol will block the request
- Empty domain list or missing required body fields returns a 400-level error
- Rate limiting or quota exhaustion may return a 429 response
- Unknown or very new domains may return low-confidence scores

## How this service works

RelayShield Landing Site

## Output

Returns a JSON object with the total number of queried domains, per-domain results including domain name, agent count, a letter grade (e.g. 'A'), and a numeric score, plus aggregate counts of high-risk and critical-risk domains across the batch.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "targets": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "domain"
    ],
    "properties": {
     "agents": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "domain": {
      "type": "string"
     }
    }
   },
   "description": "Up to 10 domains, each with up to 5 agent emails"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "queried": 1,
   "results": [
    {
     "domain": "acme.com",
     "agent_count": 1,
     "domain_grade": "A",
     "domain_score": 10
    }
   ],
   "high_count": 0,
   "critical_count": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/relayshield-bulk-identity-risk-657f8a6e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.relayshield.net](https://www.zero.xyz/host/api.relayshield.net/llms.txt)