v1.0 · REST API

Build stablecoin payments
in minutes.

A complete REST API for cross-border payouts. Idempotent, signed webhooks, type-safe SDKs.

⌘K
Overview

Introduction

The Streamline API is organized around REST. It uses resource-oriented URLs, accepts JSON request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

POST/api/public/v1/payouts

All requests must be made over HTTPS. The base URL is https://api.streamline.dev.

Security

Authentication

Authenticate requests using API keys. Generate keys from your dashboard. Include your secret key in the Authorization header with the Bearer scheme.

Keep your keys safe
Never commit secret keys to source control or expose them in client-side code. Use environment variables and rotate compromised keys immediately.
Reliability

Errors & retries

Streamline uses conventional HTTP response codes. Codes in the 2xx range indicate success, 4xx indicate a client error, 5xx indicate a server error.

200
OK — request succeeded
400
Bad request — validation failed
401
Unauthorized — invalid API key
402
Insufficient balance
404
Not found
429
Too many requests — back off and retry
5xx
Server error — retry with exponential backoff

All POST requests support idempotency keys via the Idempotency-Key header. Retries with the same key return the cached response.

Resource

Payouts

Send a stablecoin payout to a recipient. The rail router automatically picks Solana for crypto-enabled recipients, falling back to Dodo Payments fiat rails when needed.

Parameter
Type
Description
recipient_idstring
ID of the recipient to pay
amountnumber
Amount in the specified currency
currencyenum
USDC, USDT, USD, EUR, …
railenum
auto · solana · dodo
memostring?
Optional memo on the payout
Resource

Recipients

Recipients are people or businesses you pay. Each recipient can hold a Solana wallet address, bank details, or both.

POST/api/public/v1/recipients
GET/api/public/v1/recipients
Resource

Schedules

Recurring payout schedules let you automate payroll, retainers, and subscriptions. Schedules run on cron expressions in your timezone.

POST/api/public/v1/schedules
Realtime

Webhooks

Subscribe to events to receive real-time updates when payout state changes. All webhooks are HMAC-SHA256 signed via the X-Streamline-Signature header.

Parameter
Type
Description
payout.createdevent
Payout was created and queued
payout.processingevent
On-chain transaction submitted
payout.completedevent
Payout settled successfully
payout.failedevent
Payout failed; no funds moved

Ready to start building?

Grab an API key and send your first payout in under 5 minutes.