---
updatedAt: 2026-05-29T13:51:13.000Z
---

# Get a scenario run by ID

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "version": "1.0",
    "title": "Developer Portal API",
    "description": "API for interacting with scenarios"
  },
  "x-readme": {
    "explorer-enabled": false
  },
  "servers": [
    {
      "url": "https://api-sandbox.developers.deliveroo.com/dev-portal/"
    }
  ],
  "paths": {
    "/scenarios/{id}/runs/{run_id}": {
      "get": {
        "tags": [
          "Scenarios"
        ],
        "summary": "Get a scenario run by ID",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "ID of the scenario",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "run_id",
            "in": "path",
            "description": "RunID of the scenario run",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScenarioRunResponse"
                },
                "examples": {
                  "POS ASAP Order Scenario Run": {
                    "$ref": "#/components/examples/scenario_run_response_example"
                  },
                  "Signature Scenario Run": {
                    "$ref": "#/components/examples/signature_scenario_run_response_example"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "TextBox": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "id": {
            "type": "string"
          }
        }
      },
      "ScenarioRunResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "scenario_id": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "finished": {
            "type": "boolean"
          },
          "passed": {
            "type": "boolean"
          },
          "validated": {
            "type": "boolean"
          },
          "parameters": {
            "type": "object",
            "additionalProperties": {
              "type": "object"
            }
          },
          "text_boxes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TextBox"
            }
          },
          "logs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Log"
            }
          },
          "updated_at": {
            "type": "integer",
            "format": "int64"
          }
        }
      },
      "Log": {
        "type": "object",
        "properties": {
          "logged_at": {
            "type": "integer",
            "format": "int64"
          },
          "message": {
            "type": "string"
          }
        }
      }
    },
    "securitySchemes": {
      "OAuth2ClientCredentials": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://auth-sandbox.developers.deliveroo.net/oauth2/token",
            "scopes": {}
          }
        }
      }
    },
    "examples": {
      "scenario_run_response_example": {
        "value": [
          {
            "id": "d17dcc4d-b0f6-4f84-b19e-423ab10c717c",
            "scenario_id": "asap-order",
            "status": "",
            "finished": false,
            "passed": false,
            "validated": false,
            "parameters": {
              "items": [
                {
                  "name": "Chicken Burger",
                  "quantity": 1,
                  "modifiers": [
                    {
                      "name": "Mayo Sauce",
                      "quantity": 1,
                      "modifiers": [],
                      "unit_price": {
                        "fractional": 0,
                        "currency_code": "GBP"
                      },
                      "pos_item_id": "OM17001",
                      "total_price": {
                        "fractional": 0,
                        "currency_code": "GBP"
                      },
                      "discount_amount": {
                        "fractional": 0,
                        "currency_code": "GBP"
                      },
                      "operational_name": "Mayo Sauce"
                    }
                  ],
                  "unit_price": {
                    "fractional": 900,
                    "currency_code": "GBP"
                  },
                  "pos_item_id": "MU11001",
                  "total_price": {
                    "fractional": 900,
                    "currency_code": "GBP"
                  },
                  "discount_amount": {
                    "fractional": 0,
                    "currency_code": "GBP"
                  },
                  "operational_name": "Chicken Burger"
                }
              ],
              "basket_id": "90d3fa44-128e-4cdf-9157-b5ebaa7f2e0b",
              "restaurant_drn": "drn:roo:restaurant:gb:c6f03b5b-b92d-4a90-af0b-bd67cb8d87e4"
            },
            "text_boxes": [],
            "logs": [
              {
                "logged_at": 1694181423,
                "message": "Completed step common.NotifyOrderCreationStep"
              },
              {
                "logged_at": 1694181425,
                "message": "Completed step common.WaitStep"
              },
              {
                "logged_at": 1694181425,
                "message": "Completed step common.OrderStateChangedStep"
              },
              {
                "logged_at": 1694181425,
                "message": "Running validation..."
              },
              {
                "logged_at": 1694181615,
                "message": "Validation failed due to an internal error.",
                "updated_at": 1694181425
              }
            ]
          }
        ]
      },
      "signature_scenario_run_response_example": {
        "value": [
          {
            "id": "285a3a3f-af6e-4cb8-aebd-81e8d34da84c",
            "scenario_id": "simple-create-order-scenario",
            "status": "",
            "finished": false,
            "passed": false,
            "validated": false,
            "parameters": {},
            "text_boxes": [],
            "logs": [],
            "updated_at": 1694182056
          }
        ]
      }
    }
  },
  "security": [
    {
      "OAuth2ClientCredentials": []
    }
  ]
}
```