---
title: "Get Bridge Integration Status"
method: GET
path: "/bridge-integration"
tags: ["Bridge Integration"]
---

# Get Bridge Integration Status

`GET /bridge-integration`

Retrieves the current Bridge integration status and information for the organization.
Returns live data from the Bridge API including KYC status and virtual account details.

## Response `200`

Bridge integration status retrieved successfully

- BridgeIntegrationInfo — Complete Bridge integration information including status and related data
  - `status` 'NOT_ENABLED' | 'NOT_OPTED_IN' | 'OPTED_IN' | 'READY_FOR_DEPOSIT' | 'ERROR', required — Current status of the Bridge integration
  - `customer_id` string — Bridge customer ID
  - `kyc_status` KYCLinkInfo — KYC verification link information
    - `id` string, required — Unique identifier for the KYC link
    - `full_name` string, required — Full name of the person undergoing KYC
    - `email` string, email, required — Email address for KYC verification
    - `type` 'individual' | 'business', required — Type of KYC verification
    - `kyc_link` string, uri, required — URL for completing KYC verification
    - `tos_link` string, uri, required — URL for accepting terms of service
    - `kyc_status` 'not_started' | 'incomplete' | 'awaiting_ubo' | 'under_review' | 'approved' | 'rejected' | 'paused' | 'offboarded', required — KYC verification status: - not_started: KYC process not yet started - incomplete: KYC process started but not complete - awaiting_ubo: Awaiting Ultimate Beneficial Owner verification - under_review: KYC submission under review - approved: KYC verification approved - rejected: KYC verification rejected - paused: KYC process paused - offboarded: Customer offboarded
    - `tos_status` 'pending' | 'approved', required — Terms of Service acceptance status: - pending: Terms of service not yet accepted - approved: Terms of service accepted
    - `rejection_reasons` string[] — Reasons for KYC rejection (if applicable)
    - `created_at` string, date-time — When the KYC link was created
    - `customer_id` string, required — Bridge customer ID
  - `virtual_account` VirtualAccountInfo — Virtual account information for USD deposits
    - `id` string, required — Unique identifier for the virtual account
    - `status` 'activated' | 'deactivated', required — Virtual account status: - activated: Account is active and ready for deposits - deactivated: Account is deactivated
    - `developer_fee_percent` string, required — Developer fee percentage as a string
    - `customer_id` string, required — Bridge customer ID
    - `source_deposit_instructions` VirtualAccountDepositInstructions, required — Bank deposit instructions for sending USD to the virtual account
      - `bank_beneficiary_name` string, required — Name of the bank account beneficiary
      - `currency` string, required — Currency for deposits
      - `bank_name` string, required — Name of the receiving bank
      - `bank_address` string, required — Address of the receiving bank
      - `bank_account_number` string, required — Bank account number for deposits
      - `bank_routing_number` string, required — Bank routing number
      - `payment_rails` string[], required — Supported payment rails for deposits
    - `destination` VirtualAccountDestination, required — Destination configuration for converted funds
      - `payment_rail` string, required — Payment rail for destination
      - `currency` string, required — Destination currency
      - `address` string, required — Stellar address for receiving USDC
      - `blockchain_memo` string — Blockchain memo for the destination transaction
  - `opted_in_by` string — User ID who opted the organization into Bridge
  - `opted_in_at` string, date-time — Timestamp when organization opted into Bridge
  - `virtual_account_created_by` string — User ID who created the virtual account
  - `virtual_account_created_at` string, date-time — Timestamp when virtual account was created

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/versions/39f9dc64156c/schema)