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

# Retrieve connection details

> Retrieve details for a specific connection by its name



## OpenAPI

````yaml get /api/orchestration/fabric/{fabricId}/connection/name/{connectionName}
openapi: 3.0.3
info:
  title: Prophecy Connections API
  description: API for managing Prophecy connections
  version: 1.0.0
servers: []
security: []
paths:
  /api/orchestration/fabric/{fabricId}/connection/name/{connectionName}:
    parameters:
      - name: fabricId
        in: path
        description: The unique ID of the parent fabric
        required: true
        schema:
          type: string
      - name: connectionName
        in: path
        description: The unique name of the connection
        required: true
        schema:
          type: string
    get:
      tags:
        - Connections
      summary: Retrieve connection details
      description: Retrieve details for a specific connection by its name
      operationId: getConnectionByName
      parameters:
        - $ref: '#/components/parameters/X-AUTH-TOKEN'
      responses:
        '200':
          description: Connection resource found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Indicates whether the request was successful.
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        description: Unique identifier for the connection.
                      name:
                        type: string
                        description: The unique name of the connection.
                      kind:
                        type: string
                        description: The type of connection.
                      isDefaultWarehouseConnection:
                        type: boolean
                        description: >-
                          Whether this connection is the default warehouse
                          connection.
                      properties:
                        type: object
                        description: Connection configuration properties.
              example:
                success: true
                data:
                  id: <connection-id>
                  name: synapse_1
                  kind: synapse
                  isDefaultWarehouseConnection: false
                  properties:
                    database: SynapseDev
                    password:
                      kind: prophecy
                      properties:
                        id: '2719'
                        name: secret-synapse
                      subKind: text
                      type: secret
                    port: '1433'
                    server: <server-name>.sql.azuresynapse.net
                    username: <username>
components:
  parameters:
    X-AUTH-TOKEN:
      name: X-AUTH-TOKEN
      in: header
      description: Prophecy authentication token. Required for all API requests.
      required: true
      schema:
        type: string

````