DART Alerts API v1.0.0

Interactive Documentation

Live Demo

API Reference

Complete API documentation for the DART Alerts platform.

Service Alerts

GET /api/v1/alerts

List all service alerts.

search string

Search in title or description.

status string

Filter by status (active, scheduled, expired).

severityLevelId integer

Filter by severity level ID.

alertTypeId integer

Filter by alert type ID.

pageNumber integer

Page number (default 1).

pageSize integer

Items per page (default 5).

GET /api/v1/alerts/{id}

Get a specific alert by ID.

id integer required

Alert ID.

POST /api/v1/alerts

Create a new service alert.

No query parameters. Edit the request body before trying.

POST /api/v1/alerts/{id}

Update an existing alert.

id integer required

Alert ID to update.

POST /api/v1/alerts/{id}/delete

Delete an alert (soft delete).

id integer required

Alert ID to delete.

GTFS Data

GET /api/v1/routes

List all routes.

No query parameters for this endpoint.

GET /api/v1/stops

List all stops.

No query parameters for this endpoint.

GET /api/v1/agency

Get agency details.

No parameters required

Alert Types

GET /api/v1/alert-types

List all alert types.

No parameters required

Response Codes

200 Success Request completed successfully.
400 Bad Request Invalid parameters or request body.
401 Unauthorized Invalid or missing API key.
404 Not Found Resource does not exist.
429 Rate Limit Exceeded Too many requests.
500 Server Error Internal server error.

Rate Limiting

The API enforces rate limits to ensure fair usage and system stability.

Free tier: 100 requests/minute
Standard tier: 500 requests/minute
Premium tier: 2,000 requests/minute