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.
Query parameters
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.
Only bridges of this token, for example USDT.
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.
Only bridges created before this time. Must be later than from.
The page to fetch. Minimum 1, maximum 10000.
Bridges per page. Minimum 1, maximum 100.
Request
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
{
"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
| Status | Cause |
|---|---|
400 | A 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 |
401 | Missing or invalid token, IP not allow-listed, or missing payout-wallets:read |
403 | API Services are not enabled for your business |