GET
/
v1
/
records
curl --request GET \
  --url https://api.sequin.io/v1/records \
  --header 'Authorization: Bearer <token>'
  {
    "records": [
      {
        "sync_id": "70a313f8-7c94-43d4-8d0c-5659a52de5c4",
        "collection_id" : "salesforce:task",
        "upstream_id": "0018b000021BldZAAS",
        "upstream_updated_at": "2024-11-10T18:39:00.070453Z",
        "data": {
          "activity_date": "2023-09-12",
          "description" : "task description [ … ] ",
          // …
        },
        "deleted": false,
        "created_at": "2024-11-10T18:39:00.070453Z"
      },
      {
        "sync_id": "e6bd2ca5-36aa-4fce-9730-5543509a7747",
        "collection_id" : "stripe:subscription",
        "upstream_id": "sub_8237dhjxy1",
        "upstream_updated_at": "2024-11-10T18:40:00.099999Z",
        "data": {
          "id": "sub_8237dhjxy1",
          "object": "subscription",
          "billing": "charge_automatically",
          // …
        },
        "deleted": false,
        "created_at": "2024-11-10T18:40:00.099999Z"
      }
    ],
    "cursor": "NjA3"
  }

Request parameters

By default, this endpoint returns all records across all syncs and collections in your account. To filter the records returned, you can send along one or all of the following request parameters:

sync_id
string

Filter for records for this particular sync.

Defaults to all syncs.

provider
string

Filter for records from this provider. Value is the provider’s slug, e.g. stripe. See the list of possible values.

Defaults to all providers.

collection
string

Filter for records for this collection (e.g. Stripe’s stripe:subscription or Salesforce’s salesforce:contact).

Defaults to all collections.

after_cursor
string

Filter for records with a cursor greater than this value. Used to paginate the stream (see Pagination).

Defaults to null, which means the first page of records is returned (the earliest records in the stream).

limit
number

The maximum number of records to return. Can request up to 500 records at a time.

Defaults to 100.

Response fields

The response is an object that contains an array of record objects:

records
record[]

An array of record objects.

cursor
string

The cursor you can use to fetch the next page of records.

The cursor will always be returned, even if there are currently no more records to fetch. See Pagination below for more details.

The records in the response are ordered by upstream_updated_at in ascending order (oldest first).

Pagination

The response will always contain a cursor field, even if there are no more records to fetch. Simply send back the cursor from the last response to fetch the next page of records.

If you send a cursor and there are no more records to return, the response will contain an empty records array and the same cursor value you sent.