---
title: "Read records from source"
method: POST
path: "/pipeline_read"
tags: ["Stateless Sync API"]
---

# Read records from source

`POST /pipeline_read`

Streams NDJSON messages (records, state, catalog). Optional NDJSON body provides live events as input.

## Query parameters

- `state_limit` integer — Stop streaming after N state messages.
- `time_limit` number — Stop streaming after N seconds.

## Response `200`

NDJSON stream of sync messages

## Other responses

- `400` — Invalid params

## Changes

- **2026-04-05** `1ea267682268` — 1 breaking, 52 warning, 1 info
  - the `api_version` response property const value `2026-03-25.dahlia` was removed for the status `200`
  - deleted the `header` request parameter `x-state`
  - added the new `2017-08-15` enum value to the `oneOf[#/components/schemas/ControlMessage]/control/oneOf[subschema #1]/source_config/api_version` response property for the response status `200`
  - added the new `2017-12-14` enum value to the `oneOf[#/components/schemas/ControlMessage]/control/oneOf[subschema #1]/source_config/api_version` response property for the response status `200`
  - …50 more
- **2026-04-05** `db172f650b83` — 7 breaking, 2 warning, 7 info
  - added the new required request property `source_input`
  - added the new required request property `type`
  - removed `subschema #1` from the request body `oneOf` list
  - added `#/components/schemas/SourceStateMessage` to the response body `oneOf` list for the response status `200`
  - …12 more
- …earlier changes not shown

[Full history](https://skmtc.dev/stripe/apis/stripe-sync-engine/changes/pipeline_read/post.md)

---

[API](https://skmtc.dev/stripe/apis/stripe-sync-engine.md) · [All operations](https://skmtc.dev/stripe/apis/stripe-sync-engine/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stripe/stripe-sync-engine/revisions/8aee5636331b/schema)