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

# Retrieve a connected Account

> Retrieves one current connected Account by its Ionic Account ID.



## OpenAPI

````yaml /openapi/connect.yaml get /connected_accounts/{id}
openapi: 3.0.3
info:
  title: Ionic Connect API
  version: '2026-09-02'
  description: |
    Connect an existing Ionic Account to a Platform and read the Accounts that
    have granted that Platform access.

    These endpoints require the Platform's Connect secret key. The key and its
    test or live mode identify the Platform; `Ionic-Account` is not accepted on
    this surface. Authorization uses a browser redirect with PKCE. Store the
    original `state` and PKCE verifier before sending the Account holder to the
    returned `authorization_url`, then validate `state` and exchange the
    one-time code after Ionic redirects back.
servers:
  - url: '{baseUrl}/v1'
    variables:
      baseUrl:
        default: https://api.ionicfi.com
        description: API base URL for your environment.
security:
  - secretKey: []
tags:
  - name: Account Authorizations
    description: Ask an existing Account to authorize a Platform.
  - name: Connected Accounts
    description: Accounts that currently authorize the Platform.
paths:
  /connected_accounts/{id}:
    get:
      tags:
        - Connected Accounts
      summary: Retrieve a connected Account
      description: Retrieves one current connected Account by its Ionic Account ID.
      operationId: retrieveConnectedAccount
      parameters:
        - $ref: '#/components/parameters/ConnectedAccountId'
      responses:
        '200':
          description: The connected Account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectedAccount'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
      security:
        - secretKey:
            - platform:act
components:
  parameters:
    ConnectedAccountId:
      name: id
      in: path
      required: true
      description: Connected Ionic Account ID.
      schema:
        type: string
        pattern: ^mer_[0-9A-Za-z]{14}$
  schemas:
    ConnectedAccount:
      type: object
      additionalProperties: false
      required:
        - id
        - object
        - business_name
        - account_status
        - connection_status
        - payments_enabled
        - permissions
        - livemode
        - connected_at
      properties:
        id:
          type: string
          pattern: ^mer_[0-9A-Za-z]{14}$
        object:
          type: string
          enum:
            - connected_account
        business_name:
          type: string
        account_status:
          type: string
          enum:
            - pending
            - active
            - suspended
            - rejected
        connection_status:
          type: string
          enum:
            - pending
            - active
            - suspended
        payments_enabled:
          type: boolean
        permissions:
          type: array
          items:
            type: string
        livemode:
          type: boolean
        connected_at:
          type: integer
          format: int64
          description: Unix epoch seconds.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  responses:
    BadRequest:
      description: >-
        Invalid fields, PKCE data, callback data, permissions, or pagination
        cursor.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The credential cannot perform this Connect operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The connected Account was not found for this Platform and key mode.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: Too many requests.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >-
        A Platform Connect secret key (`sk_…`) sent as `Authorization: Bearer
        <key>`.

````