BlendFi
APIConversions

List conversions (cursor-paginated)

GET
/v1/conversions

Authorization

ApiKey
AuthorizationBearer <token>

Paste your BlendFi API key. Sandbox keys start with sk_test_. The Bearer prefix is added automatically.

In: header

Query Parameters

limit?integer
Default50
Range1 <= value <= 100
cursor?string
user_id?string
Formatuuid
status?array<>

Filter by conversion status. Repeat the parameter to match several statuses (status=funded&status=completed); a single value is also accepted.

transaction_type?string
Value in"pix_onramp" | "pix_offramp"
created_at_from?string
Formatdate-time
created_at_to?string
Formatdate-time

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.sandbox.blendfi.com.br/v1/conversions"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
      "quote_id": "3c071a1d-db86-46a7-9dc8-72ba3fbca992",
      "liquidation_quote_id": "9db94b06-1bfa-408b-8e64-fc1b9457fe91",
      "transaction_type": "pix_onramp",
      "status": "awaiting_deposit",
      "expected_source_amount": "string",
      "received_amount": "string",
      "source_currency": "string",
      "target_amount": "string",
      "target_currency": "string",
      "deposit_window_expires_at": "2019-08-24T14:15:22Z",
      "standby_at": "2019-08-24T14:15:22Z",
      "standby_expires_at": "2019-08-24T14:15:22Z",
      "standby_reason": "string",
      "deposit_address": "string",
      "deposit_address_network": "polygon",
      "pix_qr_code": "string",
      "pix_tx_id": "string",
      "pix_e2e_id": "string",
      "usdt_tx_hash": "string",
      "completed_at": "2019-08-24T14:15:22Z",
      "failure_reason": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ],
  "next_cursor": "string"
}

{
  "code": "invalid_cursor",
  "message": "Cursor is invalid.",
  "request_id": "01KPR9F6MM8G147177J7ZQPJHG"
}

{
  "code": "authentication_required",
  "message": "No valid credentials provided.",
  "request_id": "01KPR9F6MM8G147177J7ZQPJHG"
}

{
  "code": "missing_capability",
  "message": "Your API key does not have the required capability for this endpoint.",
  "request_id": "01KPR9F6MM8G147177J7ZQPJHG"
}
{
  "code": "rate_limit_exceeded",
  "message": "Too many requests. Try again after the retry_after_seconds window.",
  "request_id": "01KPR9F6MM8G147177J7ZQPJHG",
  "details": {
    "retry_after_seconds": 60
  }
}
{
  "code": "internal_error",
  "message": "Internal server error.",
  "request_id": "01KPR9F6MM8G147177J7ZQPJHG"
}

Liquidate a standby conversion at a fresh rate

Quotes a new rate over the actually-received amount, adjusts the limit reservation, and dispatches the conversion to settlement. Valid only on `standby`.

Accept a quote and start a conversion

Consumes an active quote and creates a conversion in `awaiting_deposit`. The response includes the deposit address (offramp) or Pix QR code (onramp) plus the deposit window deadline. Only one open conversion is permitted per user per direction.