# AcqPath Rights Preflight

> AcqPath Rights Preflight is a paid API for AI agents from api.getacqpath.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-15).

Checks whether a given web resource permits a specified AI or search use (e.g. ai-input, ai-train) by returning machine-readable RSL declarations with cryptographically signed evidence and explicit payment terms.

## Facts

- Endpoint: POST https://api.getacqpath.com/v1/rights/preflight/x402?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acqpath-rights-preflight-fbda35b7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qqwer8M2wJW8fyFcU-TlN

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 acqpath-rights-preflight-fbda35b7 -d '<json body>'
```

Example prompt: Before I use https://publisher.example.org/article as training data, check whether it declares AI training permissions — run a fresh rights preflight for commercial use with a budget of 20000 micro-USDC.

## When to prefer this

Use this endpoint when you need a machine-readable, cryptographically attested record of whether a specific web resource has declared permissions for a given AI or search use case. It is especially valuable when legal defensibility matters — the signed evidence and on-chain payment settlement create an audit trail. Prefer it over informal scraping or manual robots.txt checks when you need structured ALLOW/DENY decisions tied to RSL declarations, particularly for commercial AI training or indexing pipelines that require compliance documentation.

## Known failure modes

- Resource URL not on a reviewed origin — rejected with validation error
- max_total_micro below 20000 — budget too low error
- Invalid geo code (not ISO 3166-1 alpha-2) — schema validation failure
- Resource URL contains query string, fragment, credentials, or IP literal — rejected
- Purpose or user_class not matching allowed enum values — validation error
- Network or signing service unavailable — server error with no evidence returned
- Freshness window exceeded before response delivered — stale result or retry required

## How this service works

Machine-readable reports of observed RSL declarations, with signed evidence and explicit payment terms.

## Output

A JSON report containing: the rights decision (ALLOW_DECLARED, DENY_DECLARED, LICENSE_REQUIRED, or UNKNOWN), the number of RSL declarations found, the purpose and resource echoed back, a cryptographically signed evidence payload (Ed25519), a delivery proof, a legal_clearance boolean, and a payment settlement record showing the on-chain transaction for the $0.02 USDC charge.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "resource",
      "purpose",
      "max_total_micro"
     ],
     "properties": {
      "geo": {
       "type": [
        "string",
        "null"
       ],
       "pattern": "^[A-Z]{2}$",
       "description": "Caller-supplied geographical context. This is not independently verified location."
      },
      "tier": {
       "enum": [
        "fresh"
       ],
       "default": "fresh"
      },
      "purpose": {
       "enum": [
        "ai-input",
        "ai-train",
        "ai-index",
        "search"
       ],
       "type": "string"
      },
      "resource": {
       "type": "string",
       "format": "uri",
       "maxLength": 2048,
       "description": "HTTPS resource on an explicitly reviewed origin; no query, fragment, credentials, IP literal, encoded slash or redirect."
      },
      "user_class": {
       "enum": [
        "commercial",
        "non-commercial",
        "education",
        "government",
        "personal"
       ],
       "type": "string",
       "default": "commercial"
      },
      "max_total_micro": {
       "type": "string",
       "pattern": "^(0|[1-9][0-9]{0,10}|100000000000)$",
       "description": "Integer micro-USDC budget; this fixed fresh SKU requires at least 20000 and charges exactly 20000."
      },
      "freshness_seconds": {
       "type": "integer",
       "default": 300,
       "maximum": 3600,
       "minimum": 0
      }
     },
     "additionalProperties": false
    },
    "type": {
     "const": "http"
    },
    "method": {
     "const": "POST"
    },
    "bodyType": {
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "format",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "format": {
     "const": "application/json"
    },
    "example": {
     "type": "object",
     "required": [
      "version",
      "input_sha256",
      "legal_clearance",
      "report",
      "evidence",
      "payment_settlement",
      "delivery_proof"
     ],
     "properties": {
      "sku": {
       "const": "rights.preflight.stock.fresh.v1"
      },
      "report": {
       "type":
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "format": "application/json",
 "example": {
  "sku": "rights.preflight.stock.fresh.v1",
  "report": {
   "purpose": "ai-input",
   "decision": "UNKNOWN",
   "resource": "https://publisher.example.org/article",
   "declaration_count": 1
  },
  "version": "acqpath-stock-rights-v1",
  "evidence": {
   "format": "acqpath-evidence-v1",
   "payload": {
    "illustrative_only": true
   },
   "algorithm": "Ed25519",
   "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
  },
  "input_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
  "delivery_proof": {
   "format": "acqpath-evidence-v1",
   "payload": {
    "illustrative_only": true
   },
   "algorithm": "Ed25519",
   "signature": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
  },
  "legal_clearance": false,
  "request_binding": "ATOMIC_FIRST_VALID_USE_NOT_PRE_SIGNATURE",
  "payment_settlement": {
   "network": "eip155:84532",
   "success": true,
   "transaction": "0x0000000000000000000000000000000000000000000000000000000000000000"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acqpath-rights-preflight-fbda35b7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.getacqpath.com](https://www.zero.xyz/host/api.getacqpath.com/llms.txt)