Skip to main content
GET
/
v1
/
onramps
List all onramps
curl --request GET \
  --url https://api.daya.co/v1/onramps \
  --header 'X-Api-Key: <x-api-key>'
{
  "data": [
    {
      "id": "750e8400-e29b-41d4-a716-446655440000",
      "type": "PERMANENT",
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "provisioning_status": "ACTIVE",
      "settlement": {
        "mode": "ONCHAIN",
        "asset": "USDC",
        "chain": "BASE",
        "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
      },
      "virtual_account": {
        "account_number": "1234567890",
        "account_name": "Daya-John Doe",
        "bank_name": "Wema Bank"
      },
      "created_at": "2026-01-10T12:00:00Z"
    },
    {
      "id": "850e8400-e29b-41d4-a716-446655440000",
      "type": "TEMPORARY",
      "customer_id": "660e8400-e29b-41d4-a716-446655440000",
      "provisioning_status": "ACTIVE",
      "rate_id": "550e8400-e29b-41d4-a716-446655440000",
      "rate_expires_at": "2026-01-14T15:30:00Z",
      "settlement": {
        "mode": "ONCHAIN",
        "asset": "USDC",
        "chain": "SOLANA",
        "destination_address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV"
      },
      "virtual_account": {
        "account_number": "9876543210",
        "account_name": "Daya - user@example.com",
        "bank_name": "Wema Bank",
        "expires_at": "2026-01-14T15:30:00Z"
      },
      "created_at": "2026-01-14T15:05:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 50,
  "total_pages": 1
}

​
Overview

Retrieve a paginated list of onramps for the authenticated merchant, with optional filtering by onramp type.

​
Authentication

​
X-Api-Key
string
required
Your merchant API key

​
Query Parameters

​
type
string
Filter by onramp typeAllowed values: TEMPORARY, PERMANENT
​
page
integer
Page number (1-indexed)Default: 1
​
limit
integer
Results per pageDefault: 50Max: 200

​
Request Examples

curl --request GET \
  --url 'https://api.daya.co/v1/onramps' \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

​
data
array
required
Array of onramp objects
​
total
integer
required
Total number of onramps matching filters
​
page
integer
required
Current page number
​
limit
integer
required
Results per page
​
total_pages
integer
required
Total number of pages

​
Success Response

{
  "data": [
    {
      "id": "750e8400-e29b-41d4-a716-446655440000",
      "type": "PERMANENT",
      "customer_id": "650e8400-e29b-41d4-a716-446655440000",
      "provisioning_status": "ACTIVE",
      "settlement": {
        "mode": "ONCHAIN",
        "asset": "USDC",
        "chain": "BASE",
        "destination_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
      },
      "virtual_account": {
        "account_number": "1234567890",
        "account_name": "Daya-John Doe",
        "bank_name": "Wema Bank"
      },
      "created_at": "2026-01-10T12:00:00Z"
    },
    {
      "id": "850e8400-e29b-41d4-a716-446655440000",
      "type": "TEMPORARY",
      "customer_id": "660e8400-e29b-41d4-a716-446655440000",
      "provisioning_status": "ACTIVE",
      "rate_id": "550e8400-e29b-41d4-a716-446655440000",
      "rate_expires_at": "2026-01-14T15:30:00Z",
      "settlement": {
        "mode": "ONCHAIN",
        "asset": "USDC",
        "chain": "SOLANA",
        "destination_address": "7EcDhSYGxXyscszYEp35KHN8vvw3svAuLKTzXwCFLtV"
      },
      "virtual_account": {
        "account_number": "9876543210",
        "account_name": "Daya - user@example.com",
        "bank_name": "Wema Bank",
        "expires_at": "2026-01-14T15:30:00Z"
      },
      "created_at": "2026-01-14T15:05:00Z"
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 50,
  "total_pages": 1
}

​
Error Responses

{
  "error": "Invalid query parameters",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

​
Next Steps

Get Onramp

Get a specific onramp by ID

Create Onramp

Create a new onramp