> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/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>

<ResponseField name="merchant_connection_id" type="string">
  Your internal label for this connection.
</ResponseField>

<ResponseField name="provider_id" type="string">
  The provider this connection belongs to.
</ResponseField>

<ResponseField name="status" type="string">
  Current status.
</ResponseField>

<ResponseField name="flow_type" type="string">
  Always `PAYIN`.
</ResponseField>

<ResponseField name="payment_methods" type="string[]">
  List of supported payment methods.
</ResponseField>

<ResponseField name="params" type="object[]">
  Echoed parameters. Sensitive values are masked as `***`.
</ResponseField>

<ResponseField name="costs" type="object[]">
  Cost configuration for the connection.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp.
</ResponseField>

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.y.uno/v1/connections/f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e' \
    -H 'public-api-key: <YOUR_PUBLIC_KEY>' \
    -H 'private-secret-key: <YOUR_SECRET_KEY>'
  ```

  ```json 200 OK — Stripe theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  {
    "connection_id": "f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e",
    "merchant_connection_id": "stripe-us-prod-001",
    "provider_id": "STRIPE",
    "status": "ACTIVE",
    "flow_type": "PAYIN",
    "payment_methods": ["CARD", "GOOGLE_PAY", "APPLE_PAY"],
    "params": [
      { "param_id": "API_KEY",             "value": "***" },
      { "param_id": "PUBLISHABLE_KEY",     "value": "pk_live_..." }
    ],
    "costs": [
      {
        "sort_number": 1,
        "cost_name": "Transaction Fee",
        "currency": "USD",
        "cost_values": {
          "successful":   { "fixed_fee": 0.30, "percentage": 2.9 },
          "unsuccessful": { "fixed_fee": 0.0,  "percentage": 0.0 }
        }
      }
    ],
    "created_at": "2026-05-12T10:24:00Z",
    "updated_at": "2026-05-12T10:24:00Z"
  }
  ```

  ```json 404 Not Found theme={"theme":{"light":"github-dark","dark":"github-dark-dimmed"}}
  {
    "type": "not_found",
    "code": "CONNECTION_NOT_FOUND",
    "message": "Connection '...' was not found",
    "details": { "connection_id": "..." }
  }
  ```
</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
                    example: f1a3c4d5-7b8e-4a2c-9d1e-3f4a5b6c7d8e
                  merchant_connection_id:
                    type: string
                    example: stripe-us-prod-001
                  provider_id:
                    type: string
                    example: STRIPE
                  status:
                    type: string
                    example: ACTIVE
                  flow_type:
                    type: string
                    example: PAYIN
                  payment_methods:
                    type: array
                    items:
                      type: string
                    example:
                      - CARD
                      - GOOGLE_PAY
                      - APPLE_PAY
                  params:
                    type: array
                    items:
                      type: object
                      properties:
                        param_id:
                          type: string
                          example: merchantAccount
                        value:
                          type: string
                          example: ACME_LIVE
                  costs:
                    type: array
                    items:
                      type: object
                      properties:
                        sort_number:
                          type: integer
                          example: 1
                        cost_name:
                          type: string
                          example: Transaction Fee
                        currency:
                          type: string
                          example: USD
                  created_at:
                    type: string
                    format: date-time
                    example: '2026-05-12T10:24:00Z'
                  updated_at:
                    type: string
                    format: date-time
                    example: '2026-05-12T10:24:00Z'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: auth_error
                  code:
                    type: string
                    example: INSUFFICIENT_SCOPE
                  message:
                    type: string
                    example: API key is missing required scope 'connections:read'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                    example: not_found
                  code:
                    type: string
                    example: CONNECTION_NOT_FOUND
                  message:
                    type: string
                    example: Connection '...' was not found
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>

````