> ## Documentation Index
> Fetch the complete documentation index at: https://docs.daya.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Legacy: List offramps

> Legacy route for listing crypto receive flows

## Overview

Retrieve offramps through the legacy compatibility route. New integrations should use [`GET /v1/funding-accounts`](/api-reference/funding-accounts/list-funding-accounts) with `rail=CRYPTO_ADDRESS`.

## Authentication

<ParamField header="X-Api-Key" type="string" required>
  Your merchant API key
</ParamField>

## Query Parameters

<ParamField query="type" type="string">
  Filter by offramp type

  **Allowed values:** `TEMPORARY`, `PERMANENT`
</ParamField>

<ParamField query="chain" type="string">
  Filter by blockchain network

  **Allowed values:** `APTOS`, `BASE`, `CELO`, `ETHEREUM`, `POLYGON`, `SOLANA`, `TRON`
</ParamField>

<ParamField query="asset" type="string">
  Filter by stablecoin asset

  **Allowed values:** `USDC`, `USDT`
</ParamField>

<ParamField query="status" type="string">
  Filter by offramp status

  **Allowed values:** `ACTIVE`, `INACTIVE`, `EXPIRED`
</ParamField>

<ParamField query="settlement_mode" type="string">
  Filter by settlement mode

  **Allowed values:** `INTERNAL_BALANCE`, `NGN_PAYOUT`
</ParamField>

<ParamField query="page" type="integer">
  Page number (1-indexed)

  **Default:** `1`
</ParamField>

<ParamField query="limit" type="integer">
  Results per page

  **Default:** `50`

  **Max:** `200`
</ParamField>

## Request Examples

<CodeGroup>
  ```bash All Offramps theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/offramps' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```bash Permanent Only theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/offramps?type=PERMANENT' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```bash Filter by Chain and Asset theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/offramps?chain=ETHEREUM&asset=USDC' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```bash Paginated theme={null}
  curl --request GET \
    --url 'https://api.daya.co/v1/offramps?page=2&limit=20' \
    --header 'X-Api-Key: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.daya.co/v1/offramps?type=PERMANENT&chain=ETHEREUM&page=1&limit=20',
    {
      headers: {
        'X-Api-Key': 'YOUR_API_KEY'
      }
    }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.daya.co/v1/offramps',
      params={
          'type': 'PERMANENT',
          'chain': 'ETHEREUM',
          'page': 1,
          'limit': 20
      },
      headers={'X-Api-Key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## Response

<ResponseField name="data" type="array" required>
  Array of offramp objects

  <Expandable title="offramp properties">
    <ResponseField name="id" type="string">
      Unique offramp identifier (UUID)
    </ResponseField>

    <ResponseField name="type" type="string">
      Offramp type: `TEMPORARY` or `PERMANENT`
    </ResponseField>

    <ResponseField name="customer_id" type="string">
      Associated customer ID (UUID)
    </ResponseField>

    <ResponseField name="address" type="string">
      Crypto deposit address
    </ResponseField>

    <ResponseField name="chain" type="string">
      Blockchain network
    </ResponseField>

    <ResponseField name="asset" type="string">
      Stablecoin asset: `USDC` or `USDT`
    </ResponseField>

    <ResponseField name="status" type="string">
      Offramp status: `ACTIVE`, `INACTIVE`, or `EXPIRED`
    </ResponseField>

    <ResponseField name="developer_fee" type="object">
      Developer fee percentage used for deposits received through this offramp.

      <Expandable title="developer_fee properties">
        <ResponseField name="developer_fee.percentage" type="string">
          Configured percentage as a decimal string.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="settlement" type="object">
      Settlement configuration

      <Expandable title="settlement properties">
        <ResponseField name="settlement.mode" type="string">
          Settlement mode: `INTERNAL_BALANCE` or `NGN_PAYOUT`
        </ResponseField>

        <ResponseField name="settlement.rate_id" type="string">
          Associated rate identifier (nullable)
        </ResponseField>

        <ResponseField name="settlement.destination_bank" type="object">
          Bank account details (nullable)

          <Expandable title="destination_bank properties">
            <ResponseField name="settlement.destination_bank.account_name" type="string">
              Bank account holder name
            </ResponseField>

            <ResponseField name="settlement.destination_bank.account_number" type="string">
              Bank account number
            </ResponseField>

            <ResponseField name="settlement.destination_bank.bank_code" type="string">
              Bank code
            </ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      When the offramp was created (ISO 8601 timestamp)
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      When the offramp was last updated (ISO 8601 timestamp)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of offramps matching filters
</ResponseField>

<ResponseField name="page" type="integer" required>
  Current page number
</ResponseField>

<ResponseField name="limit" type="integer" required>
  Results per page
</ResponseField>

<ResponseField name="total_pages" type="integer" required>
  Total number of pages
</ResponseField>

### Success Response

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "a50e8400-e29b-41d4-a716-446655440000",
        "type": "PERMANENT",
        "customer_id": "650e8400-e29b-41d4-a716-446655440000",
        "address": "0x1a2b3c4d5e6f7890abcdef1234567890abcdef12",
        "chain": "ETHEREUM",
        "asset": "USDC",
        "status": "ACTIVE",
        "settlement": {
          "mode": "INTERNAL_BALANCE",
          "rate_id": null,
          "destination_bank": null
        },
        "created_at": "2026-01-10T12:00:00Z",
        "updated_at": "2026-01-10T12:00:00Z"
      },
      {
        "id": "b60e8400-e29b-41d4-a716-446655440000",
        "type": "TEMPORARY",
        "customer_id": "660e8400-e29b-41d4-a716-446655440000",
        "address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
        "chain": "TRON",
        "asset": "USDT",
        "status": "ACTIVE",
        "settlement": {
          "mode": "NGN_PAYOUT",
          "rate_id": "rate_8x7k2mq9p",
          "destination_bank": {
            "account_name": "John Doe",
            "account_number": "0123456789",
            "bank_code": "058"
          }
        },
        "created_at": "2026-01-14T15:05:00Z",
        "updated_at": "2026-01-14T15:05:00Z"
      }
    ],
    "total": 2,
    "page": 1,
    "limit": 50,
    "total_pages": 1
  }
  ```
</ResponseExample>

## Error Responses

<ResponseExample>
  ```json 400 Bad Request theme={null}
  {
    "error": {
      "code": "BAD_REQUEST",
      "message": "Invalid query parameters",
      "request_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": {
      "code": "UNAUTHORIZED",
      "message": "Unauthorized",
      "request_id": "550e8400-e29b-41d4-a716-446655440000"
    }
  }
  ```
</ResponseExample>

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Offramp" icon="magnifying-glass" href="/api-reference/offramps/get-offramp">
    Get a specific offramp by ID
  </Card>

  <Card title="Create Offramp" icon="plus" href="/api-reference/offramps/create-offramp">
    Create a new offramp
  </Card>
</CardGroup>