Skip to main content
GET /status returns the current state of a stablecoin transaction using the reference used to initiate the payment. This enables you to track the progress of any payment if not using the Webhook endpoint.

​
Example Request

curl -L \
  --request GET \
  --url 'https://api.onswitch.xyz/status?reference=ccdd7666-8cb6-45d6-9caf-498b94d10929' \
  --header 'x-service-key: '"$YOUR_SERVICE_KEY" \
  --header 'Accept: */*'
reference is required and must be the UUID used to create the payment.

​
Example Response

{
  "success": true,
  "message": "Payment status fetched successfully",
  "timestamp": "2026-03-31T03:52:50.776Z",
  "data": {
    "status": "COMPLETED",
    "type": "OFFRAMP",
    "reference": "ccdd7666-8cb6-45d6-9caf-498b94d10929",
    "rate": 1408.761,
    "source": {
      "amount": 1.745636,
      "network": "BASE",
      "currency": "USDC"
    },
    "destination": {
      "amount": 2459.183917,
      "network": "FIAT",
      "currency": "NGN"
    },
    "deposit": {
      "amount": 1.745636,
      "address": "0x73E60786CA161d1BfabbaF7c7d467a0A677997aC",
      "asset": "base:usdc",
      "note": [
        "Kindly send the exact amount to the wallet address to complete the transaction.",
        "This dynamic wallet address has a 30 minutes expiry window and can only be used once."
      ]
    }
  }
}
status may be values such as AWAITING_DEPOSIT, PROCESSING, COMPLETED, FAILED, REVERSED, SCHEDULED, depending on the state of the transaction.

​
Need Help?

Email Support

Send us a message and we’ll get back to you shortly.

Book a Demo

Hop on a call with our team.