List syncs
curl --request GET \
--url https://api.sequin.io/v1/syncs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sequin.io/v1/syncs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sequin.io/v1/syncs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sequin.io/v1/syncs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sequin.io/v1/syncs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sequin.io/v1/syncs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sequin.io/v1/syncs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "c906b4a4-0cda-4f46-bd80-255f570c195d",
"provider": "stripe",
"stream_id": "f0f70b52-5243-489c-879b-a1ae3f02abfd",
"name": "Choam Corp - HubSpot Production",
"status": "active",
"org_id": "75958cea-c981-4116-9a0d-c1e99e826688",
"health": {
"status": "healthy",
"sync_id": "c906b4a4-0cda-4f46-bd80-255f570c195d"
},
"collection_ids": ["hubspot:contact", "hubspot:company"],
"rate_limit": {
"allowed_requests": 1000,
"interval": 60,
"max_concurrent_requests": 0
},
"credential_id": "27879937-bd5d-490b-a943-edf486b04300",
"credential": {
"id": "27879937-bd5d-490b-a943-edf486b04300",
"provider": "stripe",
"properties": {
"kind": "stripe_key",
"name": "TEST ACCOUNT",
"secret": "***********",
"test": true
},
"oauth_app_id": null,
"oauth_app": {
"kind": "sequin"
},
"metadata": { "custom_credential_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
"max_age_days": 365,
"sync_frequency": "continuous",
"initial_backfill_completed_at": "2023-12-15 01:29:29",
"metadata": { "custom_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
{ ... },
{ ... }
]
}
Syncs
List syncs
This endpoint lists all the syncs in your account.
GET
/
v1
/
syncs
List syncs
curl --request GET \
--url https://api.sequin.io/v1/syncs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.sequin.io/v1/syncs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.sequin.io/v1/syncs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sequin.io/v1/syncs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sequin.io/v1/syncs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sequin.io/v1/syncs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sequin.io/v1/syncs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "c906b4a4-0cda-4f46-bd80-255f570c195d",
"provider": "stripe",
"stream_id": "f0f70b52-5243-489c-879b-a1ae3f02abfd",
"name": "Choam Corp - HubSpot Production",
"status": "active",
"org_id": "75958cea-c981-4116-9a0d-c1e99e826688",
"health": {
"status": "healthy",
"sync_id": "c906b4a4-0cda-4f46-bd80-255f570c195d"
},
"collection_ids": ["hubspot:contact", "hubspot:company"],
"rate_limit": {
"allowed_requests": 1000,
"interval": 60,
"max_concurrent_requests": 0
},
"credential_id": "27879937-bd5d-490b-a943-edf486b04300",
"credential": {
"id": "27879937-bd5d-490b-a943-edf486b04300",
"provider": "stripe",
"properties": {
"kind": "stripe_key",
"name": "TEST ACCOUNT",
"secret": "***********",
"test": true
},
"oauth_app_id": null,
"oauth_app": {
"kind": "sequin"
},
"metadata": { "custom_credential_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
"max_age_days": 365,
"sync_frequency": "continuous",
"initial_backfill_completed_at": "2023-12-15 01:29:29",
"metadata": { "custom_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
{ ... },
{ ... }
]
}
Request parameters
Filter for syncs matching the properties supplied in this map. For example,
{"custom_property": 42} will return all syncs with a custom_property of 42.Response fields
{
"data": [
{
"id": "c906b4a4-0cda-4f46-bd80-255f570c195d",
"provider": "stripe",
"stream_id": "f0f70b52-5243-489c-879b-a1ae3f02abfd",
"name": "Choam Corp - HubSpot Production",
"status": "active",
"org_id": "75958cea-c981-4116-9a0d-c1e99e826688",
"health": {
"status": "healthy",
"sync_id": "c906b4a4-0cda-4f46-bd80-255f570c195d"
},
"collection_ids": ["hubspot:contact", "hubspot:company"],
"rate_limit": {
"allowed_requests": 1000,
"interval": 60,
"max_concurrent_requests": 0
},
"credential_id": "27879937-bd5d-490b-a943-edf486b04300",
"credential": {
"id": "27879937-bd5d-490b-a943-edf486b04300",
"provider": "stripe",
"properties": {
"kind": "stripe_key",
"name": "TEST ACCOUNT",
"secret": "***********",
"test": true
},
"oauth_app_id": null,
"oauth_app": {
"kind": "sequin"
},
"metadata": { "custom_credential_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
"max_age_days": 365,
"sync_frequency": "continuous",
"initial_backfill_completed_at": "2023-12-15 01:29:29",
"metadata": { "custom_property": 42 },
"created_at": "2023-12-15 01:29:29",
"updated_at": "2023-12-15 01:29:29"
},
{ ... },
{ ... }
]
}
Provider of the sync (e.g.
github, stripe, etc). See the list of possible values.Health of the sync. Learn more about the health object.
IDs of the collections that are synced by this sync.
Rate limit of the sync. Learn more about the rate limit object.
Credential for the sync. This will usually consist of an access token and a refresh token Sequin uses to make requests. This object is polymorphic, see the list of possible shapes.
By default, Sequin syncs all data from the API regardless of age. When you set
max_age_days, Sequin will only sync and retain records that have been created or updated in the last max_age_days days.Defaults to null, which means no age limit.One of
continuous or 4h. If continuous, Sequin will run a continuous sync to sync data as fast as possible from the API. If 4h, Sequin will sync data every 4 hours.Timestamp of when the initial backfill was completed, in ISO 8601 format. Is
null if the initial backfill has not yet completed.Metadata for the sync. This is a JSON object that you can use to store any additional information you want to associate with the sync.

