---
title: "List connector data product descriptors"
method: GET
path: "/data/products"
tags: ["ConnectorDataProducts"]
---

# List connector data product descriptors

`GET /data/products`

Lists connector data product descriptors. These registry records connect a logical binding
and physical connector instance to dataset resource descriptors, selected field scopes,
transfer types, provider and consumer Party references, governance scope, and catalog offer
references. This is the Phase 5 dataspace/data-use-contract readiness surface; it does not
implement DSP/DCAT runtime behavior by itself.

## Query parameters

- `logicalConnectionBindingId` string — Stable identifier of a tenant, OU, brand, legal-entity, or channel usage binding for a physical connector instance.
- `physicalConnectorInstanceId` string, uuid — Stable platform identifier for a configured connector instance.
- `page` integer
- `size` integer

## Response `200`

Paged connector data product descriptors.

- ConnectorDataProductDescriptorPage — Page of connector data product descriptors.
  - `data` ConnectorDataProductDescriptor[], required
    - `dataProductId` string, required — Stable identifier of a connector data product descriptor.
    - `providerParty` PartyRef, required — Neutral Party reference carried by EDK connector envelopes without importing the VDX Party repository.
      - `partyId` string
      - `externalId` string
      - `partyType` string
      - `displayName` string
      - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `consumerParty` PartyRef — Neutral Party reference carried by EDK connector envelopes without importing the VDX Party repository.
      - `partyId` string
      - `externalId` string
      - `partyType` string
      - `displayName` string
      - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `physicalConnectorInstanceId` string, uuid, required — Stable platform identifier for a configured connector instance.
    - `logicalConnectionBindingId` string, required — Stable identifier of a tenant, OU, brand, legal-entity, or channel usage binding for a physical connector instance.
    - `datasetResourceIds` ResourceDescriptorId[], required
    - `title` string, required
    - `description` string
    - `version` string
    - `canonicalFieldScopes` string[]
    - `schemaRefs` string[]
    - `freshness` string
    - `quality` string
    - `distributionTransferTypes` string[], required
    - `residency` string
    - `classification` string
    - `governanceScope` string
    - `catalogOfferRefs` ConnectorCatalogOfferRef[], required
      - `offerId` string, required — Stable catalog offer identifier associated with a connector data product.
      - `policy` ConnectorOdrlPolicyRef, required — ODRL policy reference associated with a data product catalog offer.
        - `profileId` string, required
        - `policyType` 'SET' | 'OFFER' | 'AGREEMENT', required — ODRL policy reference type.
        - `policyUid` string, required
        - `targetRefs` string[]
        - `assigner` PartyRef — Neutral Party reference carried by EDK connector envelopes without importing the VDX Party repository.
          - `partyId` string
          - `externalId` string
          - `partyType` string
          - `displayName` string
          - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
        - `assignee` PartyRef — Neutral Party reference carried by EDK connector envelopes without importing the VDX Party repository.
          - `partyId` string
          - `externalId` string
          - `partyType` string
          - `displayName` string
          - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
        - `permissionRefs` string[]
        - `prohibitionRefs` string[]
        - `dutyRefs` string[]
      - `projectionHint` string
    - `partyAnchors` ConnectorPartyAnchorSet — Party, relationship, and projection candidates attached to connector invocation/run lineage.
      - `anchors` ConnectorPartyAnchor[]
        - `role` string
        - `party` PartyRef — Neutral Party reference carried by EDK connector envelopes without importing the VDX Party repository.
          - `partyId` string
          - `externalId` string
          - `partyType` string
          - `displayName` string
          - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
        - `relationships` object[]
      - `relationshipCandidates` object[]
      - `projectionCandidates` object[]
  - `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)