For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
  • Getting started
    • Introduction
    • Obtaining API keys
    • Quickstart
    • Native clients
    • Concepts
    • Embedding authentication
    • Versioning
    • Idempotent requests
    • Events
  • Configuring your connections
    • CDC streaming from databases
  • Code examples
    • Bulk sync (ELT) from HubSpot to PostgreSQL
    • Bulk sync (ELT) from Salesforce to S3
    • Bulk sync (ELT) from Salesforce to Snowflake
    • Model sync (Reverse ETL) from MongoDB to Salesforce
  • API Reference
      • GETGet Bulk Destination
      • GETGet Bulk Source
      • GETGet Bulk Source Schema
      • GETGet Bulk Source Status
      • GETList Bulk Syncs
      • POSTCreate Bulk Sync
      • GETGet Bulk Sync
      • DELDelete Bulk Sync
      • PATCHUpdate Bulk Sync
      • POSTActivate Bulk Sync
      • POSTCancel Bulk Sync
      • POSTStart Bulk Sync Execution
      • GETGet Bulk Sync Status
Logo
Log inBook a demo
API ReferenceBulk Sync

Get Bulk Source

GET
https://app.polytomic.com/api/bulk/source/:connection_id
GET
/api/bulk/source/:connection_id
$curl https://app.polytomic.com/api/bulk/source/248df4b7-aa70-47b8-a036-33ac447e668d \
> -H "X-Polytomic-Version: X-Polytomic-Version" \
> -H "Content-Type: application/json" \
> -u "<username>:<password>"
1{
2 "data": {
3 "capabilities": {
4 "supports_tracking_fields": true
5 },
6 "schemas": [
7 {
8 "fields": [
9 {
10 "association": {
11 "id": "assoc_01",
12 "name": "Contact to Account",
13 "reference_to": [
14 "account"
15 ],
16 "referenced_field": "account_id"
17 },
18 "id": "email",
19 "is_primary_key": true,
20 "name": "Email",
21 "path": "$.email",
22 "remote_type": "varchar(255)",
23 "type": "string",
24 "user_managed": true,
25 "values": [
26 {
27 "label": "Work Email",
28 "value": "work"
29 },
30 {
31 "label": "Personal Email",
32 "value": "personal"
33 }
34 ]
35 }
36 ],
37 "id": "contact",
38 "name": "Contact"
39 }
40 ]
41 }
42}
Lists the schemas available on a connection for use as a bulk sync source.
Was this page helpful?
Previous

Get Bulk Source Schema

Next

Authentication

AuthorizationBasic

This is the Polytomic deployment key (on-premises only)

OR
AuthorizationBearer
This is the Polytomic API key

Path parameters

connection_idstringRequiredformat: "uuid"
Unique identifier of the connection.

Headers

X-Polytomic-VersionstringRequired

Query parameters

refresh_schemasbooleanOptionalDefaults to false
When true, refresh cached schemas synchronously before returning the response. The connection must be healthy.
include_fieldsbooleanOptionalDefaults to true

When true, include per-schema field lists in the response. Set to false for a smaller payload when field details are not needed.

Response

OK
dataobject

Errors

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