List ramp transactions

curl --request GET \
  --url https://api.sumvin.com/v0/ramp/transactions \
  --header 'x-juno-jwt: <api-key>'

{
  "_links": {},
  "transactions": [
    {
      "id": "<string>",
      "meld_status": "<string>",
      "transaction_type": "<string>",
      "from_asset": "<string>",
      "to_asset": "<string>",
      "chain_id": 123,
      "source_amount": "<string>",
      "destination_amount": "<string>",
      "service_provider": "<string>",
      "payment_method_type": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "is_swap": false
    }
  ]
}

Ramp

List ramp transactions

Returns a page of ramp transactions for the authenticated user, scoped to their Meld customer record. Use this to reconcile state between widget sessions opened via POST /v0/ramp/sessions and the live provider state. For status changes between polls, poll GET /v0/ramp/transactions/{id} on a back-off; outbound developer webhooks are not yet exposed (the /v0/webhooks/meld/events route is an inbound provider receiver, not a subscription endpoint).

Filtering:

Filter by status to narrow to a single provider transaction status (e.g. SETTLED, PROCESSING, FAILED). Use the raw provider value; see the meld_status field on TransactionData for the value space.

Pagination:

page is zero-indexed; count is page size (default 50, max 100). This endpoint emulates offset pagination server-side; cost grows linearly with page, so very deep paging is discouraged. Most partners stay on the first handful of pages.

Response shape: Each item is the canonical Sumvin TransactionData with both status (canonical) and meld_status (raw provider) populated. Foreign-customer transactions returned by the provider in error are filtered out before the response is built.

GET

ramp

transactions

List ramp transactions

curl --request GET \
  --url https://api.sumvin.com/v0/ramp/transactions \
  --header 'x-juno-jwt: <api-key>'

{
  "_links": {},
  "transactions": [
    {
      "id": "<string>",
      "meld_status": "<string>",
      "transaction_type": "<string>",
      "from_asset": "<string>",
      "to_asset": "<string>",
      "chain_id": 123,
      "source_amount": "<string>",
      "destination_amount": "<string>",
      "service_provider": "<string>",
      "payment_method_type": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "is_swap": false
    }
  ]
}

Authorizations

x-juno-jwt

string

header

required

JWT issued by Dynamic Labs or Privy. Sent in the x-juno-jwt header on every authenticated request.

Headers

x-juno-orgid

string | null

Tenant org ID for multi-tenant auth

x-juno-jwt

string | null

x-sumvin-token

string | null

x-sumvin-pat

string | null

X-Timestamp-Format

string

Controls how timestamp fields are serialized in JSON response bodies.

Default (header omitted or any other value): epoch milliseconds as integers. iso8601: UTC ISO 8601 strings of the form YYYY-MM-DDTHH:MM:SSZ.

Example: with X-Timestamp-Format: iso8601, the field value 1704067200000 becomes "2024-01-01T00:00:00Z".

Affected fields (recursively, in dicts and arrays): any field whose name ends in _at, plus the literal field names timestamp, period_start, and period_end. All other fields are passed through unchanged.

Only iso8601 is recognized. Any other value (or omitting the header) yields the default epoch-ms representation; the server does not reject unknown values, so this is documented as an example rather than an enum to keep generated clients permissive.

Example:

"iso8601"

Query Parameters

status

string | null

Filter by provider transaction status.

page

integer

default:0

Page index for pagination.

Required range: x >= 0

count

integer

default:50

Page size (max 100).

Required range: 1 <= x <= 100

Response

Successful Response

_links

Links · object

required

HAL-style hypermedia links for navigation and available actions.

Show child attributes

transactions

TransactionData · object[]

required

Page of ramp transactions for the authenticated user, scoped to their Meld customer record.

Show child attributes

Open a ramp widget session Get a ramp transaction

⌘I