---
title: "Batch Replay Endpoint"
method: POST
path: "/api/v1/replay/batch"
tags: ["Event Replay as a Service"]
---

# Batch Replay Endpoint

`POST /api/v1/replay/batch`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/replay/batch`
- Auth: none declared

Replay multiple events for portfolio analysis.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

Request body:
- events (list, required): Array of event specs, each with either:
    - usgs_event_id (str), or
    - lat (float) + lon (float) + event_date (str)
  Optional per event: event_type (str)
- max_events (int, optional): Maximum events to process (default 50)

Returns array of replays + portfolio impact summary.
Max 50 events per batch.

## Query parameters

- `x_api_key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)