Skip to main content
GET
/
projects
/
{project_id}
/
simulations
curl --location 'https://api.withblast.com/projects/1fa8eb04-bf99-48bd-a238-5260fef06563/simulations?status=completed&limit=2' \
--header 'Authorization: Bearer YOUR_JWT_TOKEN'

{
  "simulations": [
    {
      "simulation_id": "1d7423e1-c646-4691-8958-b1db28249b3c",
      "simulator": "product_category",
      "parameters": {
        "persona": "newlywed couple looking to buy a home",
        "max_turns": 3,
        "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
        "initial_query_topic": "lawn care"
      },
      "status": "completed",
      "evaluation_status": "completed",
      "aggregated_scores": {
        "response_style": true,
        "product_relevance": false,
        "language_detection": true,
        "search_term_relevance": false,
        "follow_up_refusal_detector": true,
        "product_specs_contradiction": false
      },
      "metadata": null,
      "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
      "created_at": "2025-05-30T08:22:21.330884Z",
      "started_at": "2025-05-30T08:22:21.330884Z",
      "finished_at": "2025-05-30T08:22:49.252736Z"
    },
    {
      "simulation_id": "e266d8e0-b4ae-43f1-a27c-1ad0eac5a85a",
      "simulator": "safety",
      "parameters": {
        "max_turns": 6,
        "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563"
      },
      "status": "completed",
      "evaluation_status": "completed",
      "aggregated_scores": {
        "response_style": true,
        "product_relevance": true,
        "language_detection": true,
        "search_term_relevance": true,
        "follow_up_refusal_detector": true,
        "product_specs_contradiction": false
      },
      "metadata": null,
      "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
      "created_at": "2025-05-30T08:19:52.620263Z",
      "started_at": "2025-05-30T08:19:52.620263Z",
      "finished_at": "2025-05-30T08:21:07.540252Z"
    },
  ],
  "total": 45
}

​
Authentication

​
Authorization
string
required
Bearer token

​
Path Parameters

​
project_id
string
required
The unique identifier of the project (UUID format)

​
Query Parameters

​
offset
integer
default:"0"
Number of items to skip for pagination
​
limit
integer
default:"20"
Number of items to return (1-100)
​
status
array
Filter by simulation status. Can be one or more of:
  • pending: Not yet started
  • running: Currently executing
  • completed: Successfully finished
  • failed: Execution failed
​
simulator
array
Filter by simulator type (e.g., follow_up, safety, persona)
​
tag
array
Filter by tag names

​
Response

​
simulations
array
required
Array of simulation objects
​
total
integer
required
Total number of simulations matching the filters
curl --location 'https://api.withblast.com/projects/1fa8eb04-bf99-48bd-a238-5260fef06563/simulations?status=completed&limit=2' \
--header 'Authorization: Bearer YOUR_JWT_TOKEN'

{
  "simulations": [
    {
      "simulation_id": "1d7423e1-c646-4691-8958-b1db28249b3c",
      "simulator": "product_category",
      "parameters": {
        "persona": "newlywed couple looking to buy a home",
        "max_turns": 3,
        "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
        "initial_query_topic": "lawn care"
      },
      "status": "completed",
      "evaluation_status": "completed",
      "aggregated_scores": {
        "response_style": true,
        "product_relevance": false,
        "language_detection": true,
        "search_term_relevance": false,
        "follow_up_refusal_detector": true,
        "product_specs_contradiction": false
      },
      "metadata": null,
      "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
      "created_at": "2025-05-30T08:22:21.330884Z",
      "started_at": "2025-05-30T08:22:21.330884Z",
      "finished_at": "2025-05-30T08:22:49.252736Z"
    },
    {
      "simulation_id": "e266d8e0-b4ae-43f1-a27c-1ad0eac5a85a",
      "simulator": "safety",
      "parameters": {
        "max_turns": 6,
        "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563"
      },
      "status": "completed",
      "evaluation_status": "completed",
      "aggregated_scores": {
        "response_style": true,
        "product_relevance": true,
        "language_detection": true,
        "search_term_relevance": true,
        "follow_up_refusal_detector": true,
        "product_specs_contradiction": false
      },
      "metadata": null,
      "project_id": "1fa8eb04-bf99-48bd-a238-5260fef06563",
      "created_at": "2025-05-30T08:19:52.620263Z",
      "started_at": "2025-05-30T08:19:52.620263Z",
      "finished_at": "2025-05-30T08:21:07.540252Z"
    },
  ],
  "total": 45
}