# DataNexusAI PTP Road Accidents by Region

> DataNexusAI PTP Road Accidents by Region is a paid API for AI agents from api.datanexusai.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-03).

Returns PTP (Bulgarian road accident) statistics aggregated by administrative region/oblast, with optional time window and row limit filters.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/ptp/getPtpPerRegion?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datanexusai-ptp-road-accidents-by-region-0ac4510a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_40owwqGABS4IQ9Y-VP4pS

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 datanexusai-ptp-road-accidents-by-region-0ac4510a
```

Example prompt: Pull the PTP road accident data for Sofia region for the year 2024 — I want to see how many accidents were recorded there.

## When to prefer this

Use this endpoint when you need Bulgarian road accident (PTP) statistics scoped to a specific administrative region or oblast, optionally filtered by year or date range. Prefer this over national-level endpoints when regional granularity is required. Ideal for road safety research, government analytics, or journalism involving Bulgarian traffic data.

## Known failure modes

- Missing required 'region' parameter returns a 400 validation error
- Invalid or misspelled region/oblast name may return empty results or an error
- Payment failure (insufficient USDC balance or x402 rejection) returns HTTP 402
- Requesting a year or date range with no data returns an empty result set
- Exceeding API rate limits may return HTTP 429

## How this service works

Public data API for SEBRA payments, PTP road accidents, Hearthstone cards, EU agri-food prices, and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). Docs and discovery endpoints are free.

Machine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.

Human docs: `/docs` and `/api/`.

## Output

Returns structured road accident records from the Bulgarian PTP dataset, filtered to the specified region and optional time window, including accident counts and related metrics per row up to the specified limit.

## 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": [
      "region"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Window end."
      },
      "from": {
       "type": "string",
       "description": "Window start."
      },
      "year": {
       "type": "integer",
       "example": 2025,
       "description": "Calendar year."
      },
      "limit": {
       "type": "integer",
       "description": "Max rows."
      },
      "region": {
       "type": "string",
       "example": "Sofia",
       "description": "Region/oblast name."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-ptp-road-accidents-by-region-0ac4510a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.datanexusai.org](https://www.zero.xyz/host/api.datanexusai.org/llms.txt)