API Account
List Bridges

List bridges

Returns the bridges of your business, newest first. The list is paginated. Pass merchantReference to find the bridge you created with that reference.

GET
https://api-prod.useknit.io/api/v1/bridges
Scopepayout-wallets:readAuthBearer token

Query parameters

merchantReferencestringoptional

Only the bridge you created with this merchantReference. The list has one item if that bridge exists, and is empty if it does not. Maximum 255 characters. If you send the parameter, it must not be empty.

tokenstringoptional

Only bridges of this token, for example USDT.

fromstringoptional

Only bridges created at or after this time. An ISO 8601 date or date and time, for example 2026-11-01T00:00:00Z. A time without an offset is read as UTC.

tostringoptional

Only bridges created before this time. Must be later than from.

pageintegeroptionaldefault: 1

The page to fetch. Minimum 1, maximum 10000.

perPageintegeroptionaldefault: 15

Bridges per page. Minimum 1, maximum 100.

Request

cURL
curl -G "https://api-prod.useknit.io/api/v1/bridges" \
  -H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "merchantReference=rebalance-001"

Response

200 OK
{
  "statusCode": 200,
  "message": "Bridges retrieved successfully",
  "data": [
    {
      "id": "9f3c2a71-5d0e-4b8a-9a43-6c2f1e7b8d10",
      "merchantReference": "rebalance-001",
      "token": "USDT",
      "fromNetwork": "TRON_MAINNET",
      "toNetwork": "ETHEREUM_MAINNET",
      "amount": "200",
      "fee": "2",
      "totalDebit": "202",
      "accountBalanceBefore": "500",
      "accountBalanceAfter": "498",
      "status": "SUCCESSFUL",
      "createdAt": "2026-11-21T23:10:04.000000Z"
    }
  ],
  "pagination": {
    "totalItems": 1,
    "page": 1,
    "perPage": 15,
    "currentPage": 1,
    "lastPage": 1
  },
  "success": true
}

Each item has the fields of the Create a bridge response.

Errors

StatusCause
400A query parameter is not valid, for example an empty merchantReference, perPage above 100 or to before from. The body carries an errors entry for the parameter
401Missing or invalid token, IP not allow-listed, or missing payout-wallets:read
403API Services are not enabled for your business