Use case Integration

Overview

Safety Pool provides users with a structured way to explore, retrieve, and download the simulation files required to run scenario-based tests—whether for virtual validation or real-world replays. This is done through a secured API that allows users to programmatically browse and access the detailed contents of use cases and their scenarios.

The API gives users the ability to:

• Browse available use cases, which are collections of scenarios grouped under specific regulatory or testing standards.
• Drill into those use cases to see individual scenarios that define precise traffic situations.
• Retrieve all the underlying files that power each scenario, such as .xosc (scenario logic) and .xodr (road geometry) files. 

To begin, users authenticate with Safety Pool using a secure access token. Once authenticated, users can query the system to:

• Get a full list of available use cases. [GET /api/usecases/]

• Select a specific use case and retrieve all scenario IDs it contains. [GET /api/usecase/{scenarioId}]

• Explore each scenario to view the list of files it comprises. [GET /api/scenarios/{scenarioId}/filelist]

• Download individual files required to recreate the simulation in their preferred simulation engine. [GET /api/scenarios/{scenrioId}/files/{fileId}]

These files are the core building blocks used to run autonomous vehicle simulations, visual tests, or compliance checks.

If you're building tools or simulations that require integration with Safety Pool’s data, the API makes this easy and structured. The scenario files can then be visualized, validated, or further analyzed, helping users design safer and more robust driving systems.

By offering open access to simulation-ready files, Safety Pool enables developers, engineers, and regulators to move seamlessly from scenario selection to testing execution.