---
title: "List source bindings"
method: GET
path: "/v1/contexts/{contextId}/sources/{sourceId}/bindings"
tags: ["Configuration"]
---

# List source bindings

`GET /v1/contexts/{contextId}/sources/{sourceId}/bindings`

Returns every source binding under a source's context, enabled and disabled, so a disabled binding stays visible instead of silently vanishing.

## Path parameters

- `contextId` string, uuid, required — Context ID
- `sourceId` string, uuid, required — Source ID

## Response `200`

OK

- ListSourceBindingsResponse
  - `items` SourceBindingResponse[], nullable, required
    - `connectionId` string — Query-rail engine connection reference (UUID). Omitted for file-rail bindings.
    - `contextId` string, required — Identifier of the context this binding belongs to.
    - `createdAt` string, required — Creation timestamp in RFC 3339 format.
    - `enabled` boolean, required — Whether the binding runs.
    - `format` string, required — Declared format the binding produces, as a region/family-namespaced descriptor key.
    - `id` string, required — Unique identifier of the binding.
    - `kind` 'file' | 'query', required — Rail the source is pulled on. file fetches files via a transport; query pulls rows through a discovery-engine connection.
    - `scheduleSpec` string, required — Interval schedule spec the binding scheduler reads (cron or @every duration).
    - `sourceId` string, required — Identifier of the source this binding belongs to.
    - `transportConfig` SourceBindingTransportConfigResponse
      - `connectOptions` object — Non-secret transport tuning options (adapter-specific).
      - `credentialRef` string — Reference to a stored credential resolved at fetch time. This is a reference, never the secret material itself.
      - `glob` string — Optional glob filter applied within the path.
      - `host` string, required — Remote endpoint hostname or IP.
      - `kind` 'sftp' | 'https' | 's3' | 'imap', required — Transport adapter kind. sftp pulls over SFTP; https over HTTP(S); s3 from an S3 bucket; imap from an email mailbox.
      - `path` string — Remote directory to list and fetch from.
      - `port` integer — Remote endpoint port.
    - `updatedAt` string, required — Last update timestamp in RFC 3339 format.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)