# Get simulation (/docs/api-reference/simulation/getSimulation)

> Detailed simulation information.



**GET** `/simulations/{simulation_id}`

Detailed simulation information.

```yaml
operationId: getSimulation
responses:
  '200':
    description: Simulation details.
    content:
      application/json:
        schema:
          type: object
          properties:
            success:
              type: boolean
            simulation:
              type: object
              description: A test simulation for an agent.
              properties:
                id:
                  type: integer
                  example: 772
                name:
                  type: string
                bot_id:
                  type: object
                  description: The agent under test.
                  properties:
                    id:
                      type: integer
                    name:
                      type: string
                status:
                  type: string
                  enum:
                    - Draft
                    - Pending
                    - In Progress
                    - Calculating Summary
                    - Completed
                    - Stopped
                number_of_call_to_make:
                  type: integer
                concurrent_call_count:
                  type: integer
                max_call_duration_in_minutes:
                  type: integer
                scenarios_ids:
                  type: array
                  description: Scenario records attached to this simulation.
                  items:
                    type: object
                    additionalProperties: true
                what_went_wrong:
                  oneOf:
                    - type: string
                    - type: boolean
                suggestions_for_improvement:
                  oneOf:
                    - type: string
                    - type: boolean
                prompt_suggestion:
                  oneOf:
                    - type: string
                    - type: boolean
                is_auto_prompt_suggestions_applied:
                  type: boolean
                how_many_scenario_to_generate:
                  type: integer
                summary:
                  oneOf:
                    - type: string
                    - type: boolean
                analyticsData:
                  type: object
                  properties:
                    Positive:
                      type: integer
                    Negative:
                      type: integer
                    Neutral:
                      type: integer
                total_simulation_remaining_records:
                  type: integer
                total_simulation_in_progress_records:
                  type: integer
                total_simulation_finished_records:
                  type: integer
                total_records:
                  type: integer
                progress:
                  type: array
                  minItems: 1
                  maxItems: 1
                  items:
                    type: integer
                  description: >-
                    Single-element array containing the progress percentage (0-100). Quirky shape
                    preserved for backwards compatibility.
                  example:
                    - 0
                simulation_call_recording:
                  type: array
                  items:
                    type: object
                    additionalProperties: true
                can_stop:
                  type: boolean
                active_calls_count:
                  type: integer
                create_date:
                  type: string
                  example: 05/06/2026 13:31:54
        example:
          success: true
          simulation:
            id: 456
            name: Customer Support Test
            bot_id:
              id: 1234
              name: Customer Support Agent
            scenarios_ids: []
            status: Draft
            number_of_call_to_make: 1
            concurrent_call_count: 3
            max_call_duration_in_minutes: 3
            what_went_wrong: false
            suggestions_for_improvement: false
            prompt_suggestion: false
            is_auto_prompt_suggestions_applied: false
            how_many_scenario_to_generate: 0
            summary: false
            analyticsData:
              Positive: 0
              Negative: 0
              Neutral: 0
            total_simulation_remaining_records: 0
            total_simulation_in_progress_records: 0
            total_simulation_finished_records: 0
            total_records: 0
            progress:
              - 0
            create_date: 05/08/2026 09:10:29
            simulation_call_recording: []
            can_stop: false
            active_calls_count: 0
```

**Python SDK**

```python
from omnidimension import Client
client = Client(api_key)

# Get details of a specific simulation
simulation_id = 456
response = client.simulation.get(simulation_id)
print(response)
```

**curl**

```bash
curl -X GET "https://backend.omnidim.io/api/v1/simulations/{simulation_id}" \
  -H "Authorization: Bearer $OMNIDIM_API_KEY"
```