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

# Get a source binding

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

Returns a source binding by ID.

## Path parameters

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

## Response `200`

OK

- SourceBindingResponse
  - `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)