---
title: "List rental history"
method: GET
path: "/api/v1/rentals"
tags: ["Dedicated Rentals"]
---

# List rental history

`GET /api/v1/rentals`

## Request

- Base URL: `https://virtualsms.io`
- URL: `https://virtualsms.io/api/v1/rentals`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`

Returns paginated rental history with optional filters.

## Query parameters

- `page` integer
- `limit` integer
- `service` string
- `status` 'waiting' | 'received' | 'done' | 'cancelled'

## Response `200`

Paginated list of rentals

- object
  - `rentals` RentalStatus[]
    - `rental_id` integer
    - `status` 'waiting' | 'received' | 'done' | 'cancelled'
    - `sms_code` string, nullable
    - `sms_text` string, nullable
    - `received_at` string, date-time, nullable
  - `total` integer
  - `page` integer
  - `limit` integer

---

[API](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and.md) · [All operations](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/llms.txt) · [OpenAPI document](https://skmtc.dev/virtualsms/apis/virtualsms-account-verification-platform-for-developers-and/revisions/be89af981be1?raw)