---
title: "Run a load"
method: PUT
path: "/api/v3/loads/{id}/run"
tags: ["Loads"]
---

# Run a load

`PUT /api/v3/loads/{id}/run`

## Request

- Base URL: `https://embedded.improvado.io`
- URL: `https://embedded.improvado.io/api/v3/loads/{id}/run`
- Auth: none declared
- TypeScript: <https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/docs/api/v3/loads/:id/run/put.ts> (a function with typed inputs; its response is checked against the schema)

Allows to manually run data load into customer’s destination.
Optionally provide `date_from` and `date_to` in the request body to run the load
for a specific date range. Both fields must be provided together.
Date range is ignored for loads by accounts.

## Path parameters

- `id` integer, required

## Request body

- object
  - `date_from` string, date: Start date for the load run (YYYY-MM-DD). Must be used together with date_to.
  - `date_to` string, date: End date for the load run (YYYY-MM-DD). Must be used together with date_from.

## Response `204`

Run a Load

## Other responses

- `400`: Bad Request
- `401`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3.md) - [All operations](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/improvado/apis/improvado-embedded-api-v3/revisions/a881099bd6c4?raw)