> ## Documentation Index
> Fetch the complete documentation index at: https://yuno-3979e326-2026-05-13-universal-sdk-proposal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a Connection

> Returns a connection you previously created. Secrets are masked.

Returns a connection you previously created. Secrets are masked.

### Path Parameters

<ParamField path="connection_id" type="string" required>
  The id returned by [Create a Connection](/reference/organizations/connections/create-connection). Must belong to the account your API key is scoped to.
</ParamField>

### Response

<ResponseField name="connection_id" type="string">
  Unique identifier for the connection.
</ResponseField>

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
       --url https://api.y.uno/v1/connections/{connection_id} \
       --header 'private-secret-key: <YOUR_SECRET_KEY>' \
       --header 'public-api-key: <YOUR_PUBLIC_KEY>'
  ```

  ```json Response Example theme={null}
  {
    "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
    "merchant_connection_id": "adyen-us-prod-001",
    "provider_id": "ADYEN",
    "status": "ACTIVE",
    "flow_type": "PAYIN",
    "payment_methods": ["CARD", "GOOGLE_PAY", "IDEAL"],
    "params": [
      { "param_id": "merchantAccount",        "value": "ACME_LIVE" },
      { "param_id": "x-api-key",              "value": "***" }
    ],
    "created_at": "2026-05-12T10:24:00Z",
    "updated_at": "2026-05-12T10:24:00Z"
  }
  ```
</CodeGroup>

### Errors

| HTTP  | `code`                 | When                                                               |
| ----- | ---------------------- | ------------------------------------------------------------------ |
| `404` | `CONNECTION_NOT_FOUND` | Unknown `connection_id`, or the id belongs to a different account. |
| `403` | `INSUFFICIENT_SCOPE`   | API key missing `connections:read`.                                |


## OpenAPI

````yaml openapi/organizations/connections/retrieve-connection.json GET /connections/{connection_id}
openapi: 3.1.0
info:
  title: Connections API - Retrieve
  version: 1.0.0
servers:
  - url: https://api-sandbox.y.uno/v1
security:
  - sec0: []
    sec1: []
paths:
  /connections/{connection_id}:
    get:
      summary: Retrieve a Connection
      description: Returns a connection you previously created.
      operationId: retrieve-connection
      parameters:
        - name: connection_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  connection_id:
                    type: string
                  status:
                    type: string
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: PUBLIC-API-KEY
      x-default: <Your PUBLIC-API-KEY>
    sec1:
      type: apiKey
      in: header
      name: PRIVATE-SECRET-KEY
      x-default: <Your PRIVATE-SECRET-KEY>

````