---
title: "Create a dedicated rental (Full Access or Platform tier)"
method: POST
path: "/api/v1/rentals"
tags: ["Dedicated Rentals"]
---

# Create a dedicated rental (Full Access or Platform tier)

`POST /api/v1/rentals`

## Request

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

Creates a Full Access or Platform-tier dedicated rental (distinct from the one-time
`POST /api/v1/orders` activation above). `rental_type=full` uses local inventory and
works for any service for the whole duration; `rental_type=service` (Platform tier)
locks the number to one `service`, sourced via our global supplier network, for the
chosen duration — with an early-cancel refund window right after purchase.

Browse availability first at `GET /api/v1/rentals/available` (public, no auth) and
confirm price at `GET /api/v1/rentals/price` or `/api/v1/rentals/pricing`.

## Request body

- object
  - `country` string, required
  - `service` string: Required when rental_type=service (Platform tier)
  - `rental_type` 'full' | 'service', required
  - `duration_hours` 24 | 168 | 720 | 2160, required: 24=1 day, 168=7 days, 720=30 days, 2160=90 days
  - `auto_renew` boolean

## Response `201`

Rental created

- object

## Other responses

- `402`: Insufficient balance

---

[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)