HIFI Docs

GET

bridges

{bridgeId}

Retrieve a bridge transfer

curl --request GET \
  --url https://production.hifi.com/v3/bridges/{bridgeId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://production.hifi.com/v3/bridges/{bridgeId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://production.hifi.com/v3/bridges/{bridgeId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://production.hifi.com/v3/bridges/{bridgeId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://production.hifi.com/v3/bridges/{bridgeId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "brdg_9dQ2mNpXwZ7bV1aLcs3Kf",
  "requestId": "b3d1f2a4-5c6e-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "COMPLETED",
  "failedReason": null,
  "error": null,
  "errorDetails": null,
  "amount": "100",
  "source": {
    "userId": "usr_3Kf9dQ2mNpXwZ7bV1aLcs",
    "walletId": "wlt_1aLcs3Kf9dQ2mNpXwZ7bV",
    "currency": "USDC",
    "chain": "POLYGON"
  },
  "destination": {
    "userId": "usr_3Kf9dQ2mNpXwZ7bV1aLcs",
    "walletId": "wlt_4mNpXwZ7bV1aLcs3Kf9dQ",
    "externalWalletId": null,
    "currency": "USDC",
    "chain": "BASE"
  },
  "receipt": {
    "transactionHash": "0x9f2c1a5b7d3e4f6089a0b1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f60",
    "operations": {
      "approve": {
        "transactionHash": "0x71a2b3c4d5e6f70819202122232425262728292a2b2c2d2e2f3031323334353",
        "userOpHash": "0x4b6c7d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829",
        "chain": "POLYGON"
      },
      "burn": {
        "transactionHash": "0x2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1",
        "userOpHash": null,
        "chain": "POLYGON"
      },
      "mint": {
        "transactionHash": "0x9f2c1a5b7d3e4f6089a0b1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f60",
        "userOpHash": null,
        "chain": "BASE"
      }
    }
  },
  "fee": {
    "feeId": "9c1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f",
    "feeType": "FIXED",
    "feeAmount": "0.50",
    "feePercent": null,
    "status": "CHARGED",
    "transactionHash": "0x71a2b3c4d5e6f70819202122232425262728292a2b2c2d2e2f3031323334353",
    "failedReason": null
  },
  "quote": {
    "sendGross": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "sendNet": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "railFee": {
      "amount": "0",
      "currency": "USDC"
    },
    "receiveGross": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "receiveNet": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "rate": "1",
    "expiresAt": null
  },
  "createdAt": "2026-07-01T10:30:00.000Z",
  "updatedAt": "2026-07-01T10:35:00.000Z"
}

{
  "type": "VALIDATION_ERROR",
  "message": "One or more fields are invalid or missing.",
  "fields": [
    {
      "code": "invalid_value",
      "message": "Must be a valid email address",
      "field": "email"
    }
  ]
}

{
  "type": "UNAUTHORIZED",
  "message": "Authentication required"
}

{
  "type": "RESOURCE_NOT_FOUND",
  "message": "<string>",
  "fields": [
    {
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ]
}

{
  "type": "INTERNAL_SERVER_ERROR",
  "message": "An internal server error occurred"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

bridgeId

string

required

Public ID of the bridge transfer (prefixed with brdg_)

Response

Bridge transfer retrieved successfully.

A cross-chain bridge transfer.

string

Public ID of the bridge transfer (prefixed with brdg_).

Example:

"brdg_9dQ2mNpXwZ7bV1aLcs3Kf"

requestId

string<uuid>

Client-supplied idempotency key.

Example:

"b3d1f2a4-5c6e-4a7b-8c9d-0e1f2a3b4c5d"

status

enum<string>

Available options:

NOT_INITIATED,

OPEN_QUOTE,

CREATED,

SOURCE_INITIATED,

SOURCE_PENDING,

SOURCE_PROCESSED,

SOURCE_FAILED,

DESTINATION_INITIATED,

DESTINATION_PENDING,

COMPLETED,

DESTINATION_FAILED,

QUOTE_FAILED,

UNKNOWN,

PENDING_APPROVAL,

APPROVED,

REJECTED,

EXPIRED

Example:

"OPEN_QUOTE"

failedReason

string | null

Example:

null

error

string | null

Example:

null

errorDetails

string | null

Example:

null

amount

string

Example:

"100"

source

object

Resolved source of the bridge transfer.

Show child attributes

destination

object

Resolved destination of the bridge transfer. One of walletId or externalWalletId is present.

Show child attributes

receipt

object

On-chain receipt for the bridge. transactionHash is the final settlement hash. operations contains provider-specific step hashes (for example approve, send, mint, burn, deposit) and is empty until execution begins.

Show child attributes

fee

object | null

Developer fee charged for the bridge transfer, or null when no fee applies.

Show child attributes

quote

object | null

null while the bridge is waiting for approval (PENDING_APPROVAL), and if the approval is rejected or expires. A bridge that requires approval is quoted when it is approved.

Show child attributes

createdAt

string<date-time>

Example:

"2026-07-01T10:30:00.000Z"

updatedAt

string<date-time>

Example:

"2026-07-01T10:30:00.000Z"

⌘I

Retrieve a bridge transfer

curl --request GET \
  --url https://production.hifi.com/v3/bridges/{bridgeId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://production.hifi.com/v3/bridges/{bridgeId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://production.hifi.com/v3/bridges/{bridgeId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://production.hifi.com/v3/bridges/{bridgeId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://production.hifi.com/v3/bridges/{bridgeId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "brdg_9dQ2mNpXwZ7bV1aLcs3Kf",
  "requestId": "b3d1f2a4-5c6e-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "COMPLETED",
  "failedReason": null,
  "error": null,
  "errorDetails": null,
  "amount": "100",
  "source": {
    "userId": "usr_3Kf9dQ2mNpXwZ7bV1aLcs",
    "walletId": "wlt_1aLcs3Kf9dQ2mNpXwZ7bV",
    "currency": "USDC",
    "chain": "POLYGON"
  },
  "destination": {
    "userId": "usr_3Kf9dQ2mNpXwZ7bV1aLcs",
    "walletId": "wlt_4mNpXwZ7bV1aLcs3Kf9dQ",
    "externalWalletId": null,
    "currency": "USDC",
    "chain": "BASE"
  },
  "receipt": {
    "transactionHash": "0x9f2c1a5b7d3e4f6089a0b1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f60",
    "operations": {
      "approve": {
        "transactionHash": "0x71a2b3c4d5e6f70819202122232425262728292a2b2c2d2e2f3031323334353",
        "userOpHash": "0x4b6c7d8e9f0a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f6071829",
        "chain": "POLYGON"
      },
      "burn": {
        "transactionHash": "0x2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90a1",
        "userOpHash": null,
        "chain": "POLYGON"
      },
      "mint": {
        "transactionHash": "0x9f2c1a5b7d3e4f6089a0b1c2d3e4f5061728394a5b6c7d8e9f0a1b2c3d4e5f60",
        "userOpHash": null,
        "chain": "BASE"
      }
    }
  },
  "fee": {
    "feeId": "9c1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f",
    "feeType": "FIXED",
    "feeAmount": "0.50",
    "feePercent": null,
    "status": "CHARGED",
    "transactionHash": "0x71a2b3c4d5e6f70819202122232425262728292a2b2c2d2e2f3031323334353",
    "failedReason": null
  },
  "quote": {
    "sendGross": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "sendNet": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "railFee": {
      "amount": "0",
      "currency": "USDC"
    },
    "receiveGross": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "receiveNet": {
      "amount": "100.000000",
      "currency": "USDC"
    },
    "rate": "1",
    "expiresAt": null
  },
  "createdAt": "2026-07-01T10:30:00.000Z",
  "updatedAt": "2026-07-01T10:35:00.000Z"
}

{
  "type": "VALIDATION_ERROR",
  "message": "One or more fields are invalid or missing.",
  "fields": [
    {
      "code": "invalid_value",
      "message": "Must be a valid email address",
      "field": "email"
    }
  ]
}

{
  "type": "UNAUTHORIZED",
  "message": "Authentication required"
}

{
  "type": "RESOURCE_NOT_FOUND",
  "message": "<string>",
  "fields": [
    {
      "code": "<string>",
      "message": "<string>",
      "field": "<string>"
    }
  ]
}

{
  "type": "INTERNAL_SERVER_ERROR",
  "message": "An internal server error occurred"
}

Overview

Endpoints

Retrieve a bridge transfer

Authorizations

Path Parameters

Response