# Vextorium Spain Traffic Incidents (DGT)

> Vextorium Spain Traffic Incidents (DGT) is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-16).

Returns active traffic incidents on Spanish roads from the DGT, including roadworks, accidents, queues, closures, and adverse weather, with location and timing details.

## Facts

- Endpoint: POST https://api.vextorium.com/incidencias-trafico-es-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-spain-traffic-incidents-dgt-ba82c971
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_odeC_82FEdM3G-FjfQNjr

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 vextorium-spain-traffic-incidents-dgt-ba82c971 -d '<json body>'
```

Example prompt: What active traffic incidents are there right now on the A-4 road in Madrid province? Give me up to 50 results, filtering by roadworks if possible.

## When to prefer this

Use this endpoint when you need real-time, structured traffic incident data specifically for Spanish roads sourced from the official DGT authority. It is the best choice when you need filterable results by road, province, or incident cause, and when you need geospatial coordinates for mapping. Prefer this over generic web scraping or map APIs when structured, machine-readable incident data with fields like km point, severity, direction, and start time is required.

## Known failure modes

- No incidents matching the filter criteria returns an empty incidencias array with total 0
- Invalid or misspelled province/road name may return empty results rather than an error
- Missing required body fields (type, method, bodyType) causes a validation error
- Service may return null values for optional fields like severity or lanes when DGT data is incomplete
- Rate limit or payment failure returns a 402 or 429 HTTP error

## How this service works

Active traffic incidents on Spanish roads from the DGT: roadworks, accidents, queues, closures, adverse weather..., with road, kilometre point, province, municipality, coordinates and start time; filter by province, road and cause.

## Output

A JSON object containing: the total count of matching incidents, the data source (fuente), a breakdown of incidents by cause (obras, meteorología adversa, etc.), and an array of individual incident objects each with road name, kilometre point, latitude, longitude, direction, type, cause, severity, lanes affected, municipality, province, community, and start time.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "causa": {
   "type": "string"
  },
  "limite": {
   "type": "integer"
  },
  "carretera": {
   "type": "string"
  },
  "provincia": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-spain-traffic-incidents-dgt-ba82c971/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)