---
title: "List resources attached to a connector"
method: GET
path: "/connectors/{connectorInstanceId}/resources"
tags: ["ConnectorResources"]
---

# List resources attached to a connector

`GET /connectors/{connectorInstanceId}/resources`

Lists resource descriptors attached to a connector instance for source and destination use.
The attached resource adds connector-local access details such as external resource name,
endpoint id, and access protocol; the descriptor remains the reusable logical data shape.

## Path parameters

- `connectorInstanceId` string, uuid, required — Stable platform identifier for a configured connector instance.

## Query parameters

- `role` 'SOURCE' | 'DESTINATION' — How a connector participates in data movement. Use SOURCE for reads and DESTINATION for writes. Connectors that support both roles declare both values in supportedRoles.
- `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 resources attached to the connector.

- ConnectorResourcePage — Page of resources attached to connectors.
  - `data` ConnectorResource[], required
    - `resourceDescriptorId` string, uuid, required — Stable identifier for a described external or internal resource shape.
    - `role` 'SOURCE' | 'DESTINATION', required — How a connector participates in data movement. Use SOURCE for reads and DESTINATION for writes. Connectors that support both roles declare both values in supportedRoles.
    - `externalResourceName` string — Connector-local table, endpoint, bucket, object, claim set, form, topic, or collection name.
    - `accessProtocol` 'HTTP' | 'HTTPS' | 'JDBC' | 'ODBC' | 'SFTP' | 'FILE' | 'S3' | 'AZURE_BLOB' | 'GCS' | 'KAFKA' | 'AMQP' | 'MQTT' | 'OIDC' | 'DIDCOMM' | 'VAULT' | 'INTERNAL' | 'CUSTOM' — Transport or access protocol. This is intentionally separate from ResourceKind and RepresentationKind: for example, CSV data can be read over HTTPS, S3, SFTP, FILE, or VAULT.
    - `endpointId` string, uuid — Optional connector endpoint used to access this resource.
    - `metadata` StringMap — Small string-only metadata map for labels, ownership, routing hints, and implementation-specific annotations. Use first-class fields for contractually significant data.
    - `connectorResourceId` string, uuid, required — Stable identifier for a resource attached to a connector instance.
    - `connectorInstanceId` string, uuid, required — Stable platform identifier for a configured connector instance.
  - `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

- `401` — Authentication is required.
- `404` — The requested resource was not found.

---

[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)