Confirming Your Simulation

Once you have created a simulation plan and are satisfied with its parameters and estimated cost, the next step is to confirm it. Confirmation is the explicit approval that schedules the simulation for execution on our High-Performance Computing (HPC) infrastructure.

Step 2: Confirming the Plan

To confirm a simulation, you make a POST request to the /v1/weather-simulation/confirm endpoint.

This action is critical: it moves the simulation from a pending state into the execution queue.

For full technical details, see the API Reference.

Request Body

The request body is simple: you only need to provide the simulationRequestId you received when you created the plan. This is the uuid you were instructed to save.

Example Request

Here is an example of how to confirm the simulation plan we created in the previous step.

curl -X POST 'https://api.weatherwise.fr/v1/weather-simulation/confirm' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "simulationRequestId": "6a7b9d0c-1234-4f8a-9b10-2d3e4f5a6b7c"
}'

Understanding the Confirmation Response

If the simulationRequestId is valid and the plan is in a confirmable state, the API will return a 200 OK with the updated simulation object.

The key change to look for is in the runs array: the status of the nested runs will have transitioned from AWAITING_CONFIRMATION to STARTING_SOON.

Example Response (After Confirmation)

{
  "uuid": "6a7b9d0c-1234-4f8a-9b10-2d3e4f5a6b7c",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "resolution": {
    "x": 250,
    "y": 250,
    "unit": "M"
  },
  "gridPoints": "240x240",
  "fromDate": "2025-01-15T12:00:00Z",
  "duration": "PT24H",
  "model": "ECMWF_ERA5",
  "runs": [
    {
      "uuid": "f755904f-f614-4912-97d8-cbfffc53010b",
      "resolution": {
        "x": 5000.0,
        "y": 5000.0,
        "unit": "M"
      },
      "model": "MESONH",
      "status": "STARTING_SOON",
      "error": null,
      "previousRunUuid": null,
      "downloadUrl": null
    },
    {
      "uuid": "1675ba77-0075-4e7c-a568-c530b96311fe",
      "resolution": {
        "x": 1000.0,
        "y": 1000.0,
        "unit": "M"
      },
      "model": "MESONH",
      "status": "STARTING_SOON",
      "error": null,
      "previousRunUuid": "f755904f-f614-4912-97d8-cbfffc53010b",
      "downloadUrl": null
    },
    {
      "uuid": "a29b1b13-7b83-46ec-8051-5163f9686713",
      "resolution": {
        "x": 250.0,
        "y": 250.0,
        "unit": "M"
      },
      "model": "MESONH",
      "status": "STARTING_SOON",
      "error": null,
      "previousRunUuid": "1675ba77-0075-4e7c-a568-c530b96311fe",
      "downloadUrl": null
    }
  ]
}

Your simulation is now officially in the queue. The status will automatically progress from STARTING_SOON to PREPARING, RUNNING, and finally COMPLETED or FAILED.

Next Steps

Now that your simulation is running, you’ll want to monitor its progress.

• Checking on simulation status: Learn how to poll the API to get real-time updates on your simulation’s status.