---
title: "Initialize load"
method: POST
path: "/import/streams/{id}/load"
tags: ["Import Streams"]
---

# Initialize load

`POST /import/streams/{id}/load`

Initialize a new load for a stream with optional record IDs.

## Path parameters

- `id` string, required

## Request body

- InitializeLoadRequest
  - `filter` union
    - object
      - `type` 'last_modified', required
      - `last_modified` LastModifiedFilter, required
        - `start` string, date-time
        - `end` string, date-time
    - object
      - `type` 'extract_timestamp', required
      - `extract_timestamp` ExtractTimestampFilter, required
        - `start` string, date-time
        - `end` string, date-time
    - object
      - `type` 'records', required
      - `records` RecordsFilter, required
        - `record_ids` string[], required

## Response `200`

OK

- object
  - `status` 'success', required
  - `data` InitializeLoadResponse, required
    - `load` LoadResource, required
      - `id` string, required
      - `stream_id` string, required
      - `submitted_at` string, required
      - `started_at` string
      - `ended_at` string
      - `records_processed` integer
      - `records_transformed` integer
      - `records_valid` integer
      - `records_loaded` integer
      - `records_errored` integer
      - `error` ErrorResource
        - `error_code` string, required
        - `title` string, required
        - `blame` string, required
        - `documentation_url` string, required
        - `trace` string, required
        - `message` string, required
      - `record_ids` string[]
      - `actor_id` string, required
      - `actor_type` string, required
  - `message` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/prequel/apis/prequel-data-export.md) · [All operations](https://skmtc.dev/prequel/apis/prequel-data-export/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prequel/prequel-data-export/revisions/09c662a871f8/schema)