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

# List Pay-ins

> Retrieve a paginated list of pay-ins.

## List Pay-ins

Retrieve a paginated list of all pay-ins, with optional filtering by status and date range.

### Endpoint

```
GET /v1/payins
```

### Query Parameters

| Parameter | Type    | Required | Description                                                                |
| --------- | ------- | -------- | -------------------------------------------------------------------------- |
| `page`    | integer | No       | Page number (default: 1).                                                  |
| `limit`   | integer | No       | Results per page (default: 20, max: 100).                                  |
| `status`  | string  | No       | Filter by status: `awaiting_deposit`, `processing`, `completed`, `failed`. |
| `from`    | string  | No       | ISO 8601 start date for filtering.                                         |
| `to`      | string  | No       | ISO 8601 end date for filtering.                                           |

### Request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.thiqwave.com/v1/payins?page=1&limit=20&status=completed" \
    -H "X-API-Key: your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.thiqwave.com/v1/payins?page=1&limit=20&status=completed',
    {
      method: 'GET',
      headers: {
        'X-API-Key': 'your_api_key',
      },
    }
  );

  const result = await response.json();
  console.log(result);
  ```

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

  response = requests.get(
      'https://api.thiqwave.com/v1/payins',
      headers={'X-API-Key': 'your_api_key'},
      params={
          'page': 1,
          'limit': 20,
          'status': 'completed',
      }
  )

  result = response.json()
  print(result)
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "data": [
    {
      "payin_id": "payin_1234567890",
      "quote_id": "quote_1234567890",
      "status": "completed",
      "source_currency": "AED",
      "destination_currency": "USDT",
      "destination_network": "ethereum",
      "destination_address": "0x742d35Cc6634C0532925a3b844Bc123e5fA42f9c",
      "source_amount": 50000,
      "estimated_stablecoin_amount": "479.50",
      "actual_stablecoin_amount": "479.50",
      "expires_at": "2026-04-09T14:45:00Z",
      "created_at": "2026-04-09T14:30:00Z",
      "completed_at": "2026-04-09T14:38:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "total_pages": 3
  }
}
```

### Response Fields

| Field              | Type    | Description              |
| ------------------ | ------- | ------------------------ |
| `data`             | array   | Array of pay-in objects. |
| `meta.page`        | integer | Current page number.     |
| `meta.limit`       | integer | Results per page.        |
| `meta.total`       | integer | Total number of pay-ins. |
| `meta.total_pages` | integer | Total number of pages.   |

## Notes

* Use pagination to retrieve large result sets efficiently.
* Filter by `status` to focus on specific pay-in states.
* Use `from` and `to` parameters to filter by date range.