# TrustScore Batch Scoring API

> TrustScore Batch Scoring API is a paid API for AI agents from trustscore.dev, paid per call via x402, $0.3/call, status unknown (last checked 2026-09-15).

Batch-scores up to 25 phone numbers, crypto tokens, or property addresses in one call, returning a 0–100 trust score, risk flags, and plain-English summary for each item.

## Facts

- Endpoint: POST https://trustscore.dev/api/batch-score
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trustscore-dev-339ac1ff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ri0lRv0__Bc9gQh_HdC_3

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 trustscore-dev-339ac1ff -d '<json body>'
```

Example prompt: Can you batch-score these 10 items for fraud risk — phone numbers +14155551234 and +19175559876, crypto tokens 0xabc123... and 0xdef456..., and property address 123 Main St, Austin TX — and give me a trust score, risk flags, and summary for each one?

## When to prefer this

Use this endpoint when you need to screen multiple assets (phone numbers, crypto tokens, or property addresses) in a single API call rather than making individual requests. It is ideal for fraud screening pipelines, compliance batch jobs, and agent workflows where efficiency and cost per item matter. Prefer this over the single-item endpoint when processing 2–25 items at once.

## Known failure modes

- Batch exceeds 25 items — returns 400 validation error
- Invalid phone number format — item flagged as unscored or error returned
- Unrecognized crypto token contract address — low confidence score or not-found error
- Ambiguous property address with no geocoding match — item returned with low confidence
- Payment failure (x402) — full request rejected before scoring begins
- Mixed valid/invalid items — valid items scored, invalid items return per-item error objects

## How this service works

Bulk trust scoring: check up to 25 phone numbers, crypto tokens, or property addresses in one call. Returns a 0-100 trust score, risk flags, and summary for each item. Built for fraud screening pipelines, compliance workflows, and agent batch checks covering phone spam, crypto rugpulls, and property fraud.

## Output

For each submitted item, the agent receives a 0–100 trust score, a confidence level, a set of risk flags (e.g. 'spam', 'rugpull', 'deed fraud'), and a plain-English summary explaining why the item is considered risky or trustworthy. Results cover all three asset types in a single response.

## Example request

```json
{
 "input": {
  "body": {
   "items": [
    {
     "type": "phone",
     "input": {
      "number": "+14155551234"
     }
    },
    {
     "type": "phone",
     "input": {
      "number": "+19175559876"
     }
    }
   ]
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "items": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "type",
     "input"
    ],
    "properties": {
     "type": {
      "enum": [
       "phone"
      ],
      "type": "string"
     },
     "input": {
      "type": "object"
     }
    }
   },
   "maxItems": 25
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trustscore-dev-339ac1ff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from trustscore.dev](https://www.zero.xyz/host/trustscore.dev/llms.txt)