> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List secret provider items

> Lists the items visible to a secret-provider connection across its accessible vaults. Use an item's `ref` as `secret_ref` when binding a vault entry. Authenticated with your CloudCruise API key, like the rest of the Vault API.

> **Note:**
>
> * Authenticated with your CloudCruise API key (`cc-key` header), the same as the rest of the Vault API.
> * Use an item's `ref` as `secret_ref` when binding a [vault entry](/vault-api/create-vault-entry) to this connection.
> * Returns metadata only — secret values are never included.


## OpenAPI

````yaml vault-api/vault-api.yaml get /secret-providers/{id}/items
openapi: 3.1.0
info:
  title: CloudCruise Vault API
  version: 0.1.0
  description: Endpoints for managing vault entries.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /secret-providers/{id}/items:
    get:
      summary: List secret provider items
      description: >-
        Lists the items visible to a secret-provider connection across its
        accessible vaults. Use an item's `ref` as `secret_ref` when binding a
        vault entry. Authenticated with your CloudCruise API key, like the rest
        of the Vault API.
      operationId: list_secret_provider_items
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The secret-provider connection id (from `GET /secret-providers`).
      responses:
        '200':
          description: Items the connection can resolve.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SecretProviderItem'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: The connection was not found in this workspace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SecretProviderItem:
      type: object
      description: >-
        A secret item the connection can resolve. Metadata only — never includes
        secret values.
      properties:
        id:
          type: string
          description: Provider-native item id.
        title:
          type: string
          description: Item display name.
        vaultId:
          type: string
          description: Provider-native id of the vault containing the item.
        vaultName:
          type: string
          description: Display name of the vault containing the item.
        ref:
          type: string
          description: >-
            The reference to use as `secret_ref` on a vault entry (e.g.
            `op://<vaultId>/<itemId>`).
      required:
        - id
        - title
        - vaultId
        - vaultName
        - ref
    ErrorResponse:
      type: object
      description: Error response returned when a request fails
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Human-readable error message
        error:
          type: string
          description: HTTP status text (e.g., "Not Found", "Conflict")
      required:
        - statusCode
        - message
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````