---
title: "List semantic connector bindings"
method: GET
path: "/semantic/bindings"
tags: ["SemanticBindings"]
---

# List semantic connector bindings

`GET /semantic/bindings`

Lists semantic bindings for connector resources and fields. These bindings let the platform
understand that an external field represents an employee email, SSN, customer id, supplier
relationship, policy classification, or other semantic concept.

## Query parameters

- `connectorType` string — Extensible connector family identifier. This names the connector implementation or adapter family, not the transport, resource kind, or representation.
- `resourceKind` 'OBJECT' | 'TABULAR' | 'DOCUMENT' | 'CLAIM_SET' | 'GRAPH' | 'EVENT_STREAM' | 'FILE' | 'SECRET' | 'CONFIGURATION' | 'CREDENTIAL' | 'PRESENTATION' | 'CUSTOM' — Logical kind of resource being accessed, independent of transport and serialization. For example, a CSV file with rows is ResourceKind TABULAR and RepresentationKind CSV.
- `page` integer
- `size` integer

## Response `200`

Paged semantic connector bindings.

- SemanticConnectorBindingPage — Page of semantic connector bindings.
  - `data` SemanticConnectorBinding[], required
    - `connectorInstanceId` string, uuid — Stable platform identifier for a configured connector instance.
    - `resourceDescriptorId` string, uuid, required — Stable identifier for a described external or internal resource shape.
    - `fieldDescriptorId` string, uuid — Stable identifier for a field within a resource descriptor.
    - `bindingKind` string, required — Binding type, for example ATTRIBUTE, ATTRIBUTE_PROFILE, PARTY_ROLE, RELATIONSHIP_TYPE, POLICY_CLASSIFICATION, or VOCABULARY_TERM.
    - `semanticReference` SemanticReference — Reference to a semantic catalog, profile, attribute, relationship type, policy classification, or vocabulary term.
      - `referenceType` string, required — Semantic model reference type.
      - `referenceId` string, required — Stable semantic reference id.
      - `iri` string — Optional IRI for RDF/JSON-LD and vocabulary alignment.
      - `version` string — Optional semantic reference version.
    - `validationMode` 'NONE' | 'WARN' | 'ENFORCE' — Whether semantic validation is advisory, enforced, or disabled for this binding.
    - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `semanticBindingId` string, uuid, required — Stable identifier for a semantic binding between resource data and VDX semantics.
    - `createdAt` string, date-time, required — Creation timestamp.
    - `updatedAt` string, date-time, required — Last update timestamp.
  - `pagination` Page, required — Pagination metadata emitted with each paged response under the `pagination` property.
    - `limit` integer, required — Maximum number of records requested for this page.
    - `offset` integer, required — Zero-based offset of the first record in this page.
    - `page` integer, required — Zero-based page index derived from offset and limit.
    - `size` integer, required — Effective page size.
    - `total` integer, required — Total number of matching records.
    - `totalPages` integer, required — Total number of available pages.
    - `hasMore` boolean, required — Whether another page is available after this page.

## Other responses

- `400` — Validation error.
- `401` — Authentication is required.

---

[API](https://skmtc.net/sphereon-opensource/apis/connector-integration-profile-api.md) · [All operations](https://skmtc.net/sphereon-opensource/apis/connector-integration-profile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sphereon-opensource/connector-integration-profile-api/revisions/60cb8c70871b/schema)