MyRentals API
A REST API for reading your fleet, checking availability and creating reservations programmatically. Build your own booking flow, sync with an existing website, or connect MyRentals to any other system.
Base URL
https://cloud.myrentals.ro/api/v1
All requests must use HTTPS. Responses are JSON encoded. Requests are scoped to the account that owns the API key — you will only ever see and modify your own data.
Conventions
- Dates use
YYYY-MM-DD, times useHH:MM(24-hour), both in your account's local timezone. - Monetary values are returned as strings with two decimals, for example
"122.00", to avoid floating point rounding. - Fields that do not apply to your account type are omitted from the response rather than returned as
null.
Authentication
Every request is authenticated with an API key sent as a bearer token in the Authorization header. Generate your key from the MyRentals dashboard under Integrations → API.
curl https://cloud.myrentals.ro/api/v1/ping \
-H "Authorization: Bearer YOUR_API_KEY"
Your API key is shown only once, at the moment you generate it. Store it somewhere safe. Treat it like a password — anyone holding it has full access to your account data at the key's permission level. If a key is exposed, revoke it from the dashboard and generate a new one.
Permission scopes
Each key carries a scope that determines what it may do.
| Scope | Allows |
|---|---|
| read | All GET requests. Any other method returns 403. |
| write | Everything a read key can do, plus creating reservations. |
Use a read-only key wherever you only need to display data — for example on a public website — so that a leaked key cannot be used to create bookings.
Account types
The shape of the response depends on what your account rents out. This is set once in your account settings and applies to every endpoint.
| Type | Behaviour |
|---|---|
| vehicles | Cars, motorcycles and equipment. Pickup and drop-off times matter, so time fields are required on availability checks and when creating reservations. Responses include vehicle model, document expiry dates, deposit, locations, status and contract links. |
| stays | Apartments and hotels. Only dates matter — time fields are ignored if sent. Vehicle-specific fields are omitted entirely from responses. |
Call GET /ping once during setup to confirm your key works, then GET /units — the presence of a model field tells you whether you are on a vehicle account.
Rate limits
Each API key is limited to 60 requests per minute. The window is fixed and resets at the start of every minute.
| Header | Description |
|---|---|
| X-RateLimit-Limit | Maximum requests allowed per minute. |
| X-RateLimit-Remaining | Requests left in the current window. |
| Retry-After | Seconds until the window resets. Sent only with a 429 response. |
Exceeding the limit returns 429. Wait for the number of seconds given in Retry-After before retrying. If you are polling availability, cache results on your side rather than requesting on every page view.
{
"error": {
"code": "rate_limit_exceeded",
"message": "Rate limit exceeded. Maximum 60 requests per minute."
}
}
Errors
Errors use standard HTTP status codes and always return the same JSON shape. Check the status code first, then use error.code for programmatic handling — error.message is meant for humans and its wording may change.
{
"error": {
"code": "not_available",
"message": "The unit is already booked for this period."
}
}
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_input | A required parameter is missing or malformed. |
| 400 | invalid_dates | Dates are not YYYY-MM-DD, or checkout is not after checkin. |
| 400 | invalid_times | Times are missing or not HH:MM. Vehicle accounts only. |
| 400 | invalid_json | The request body is not valid JSON. |
| 400 | invalid_template | The template_id does not exist on your account. |
| 401 | unauthorized | The API key is missing, revoked or invalid. |
| 403 | forbidden | The key is read-only but the request tries to write. |
| 404 | not_found | The endpoint or the referenced unit does not exist. |
| 405 | method_not_allowed | Wrong HTTP method for this endpoint. |
| 409 | not_available | The unit is already booked for the requested period. |
| 429 | rate_limit_exceeded | Too many requests. See rate limits. |
| 500 | server_error | Something went wrong on our side. Retry; if it persists, contact support. |
Ping
Verifies that your API key is valid and returns the account it belongs to. Takes no parameters. Useful as a connection test during setup and as a health check.
curl https://cloud.myrentals.ro/api/v1/ping \
-H "Authorization: Bearer YOUR_API_KEY"
{
"ok": true,
"user_id": 19,
"scope": "write",
"method": "GET",
"time": "2026-08-20T11:36:30+03:00"
}
Units
Returns every non-archived unit on your account — the cars, apartments or equipment you rent out. Archived units are never included.
Query parameters
| Parameter | Description |
|---|---|
| limitoptional | Maximum number of units to return. Omit to return all of them. |
Response fields
| Field | Description |
|---|---|
| unit_id | Unique identifier. Use it when checking availability or creating a reservation. |
| name | On vehicle accounts this is the licence plate. On stays it is the unit name, such as "Apartament 1". |
| model | The vehicle model, e.g. "Skoda Octavia". Vehicle accounts only. |
| price | Default daily rate, as a string with two decimals. |
| status | 1 if the unit is active and bookable, 0 if temporarily disabled. |
| documents | Expiry dates for itp, rca, rovinieta and casco. Each is null when not recorded. Vehicle accounts only. |
curl "https://cloud.myrentals.ro/api/v1/units?limit=2" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"unit_id": 224,
"name": "NT112ABC",
"price": "55.00",
"status": 1,
"model": "Skoda Octavia",
"documents": {
"itp": "2027-05-06",
"rca": "2026-05-14",
"rovinieta": null,
"casco": "2026-05-31"
}
}
]
}
{
"data": [
{
"unit_id": 49,
"name": "Apartament 1",
"price": "240.00",
"status": 1
}
]
}
Reservations
Lists reservations, newest check-in first. Results are paginated at a maximum of 100 per page.
Query parameters
| Parameter | Description |
|---|---|
| reservation_idoptional | Return a single reservation by its ID. |
| unit_idoptional | Only reservations for this unit. |
| fromoptional | Only reservations with a check-in on or after this date. |
| tooptional | Only reservations with a check-in on or before this date. |
| limitoptional | Results per page, 1 to 100. Defaults to 100. |
| pageoptional | Page number, starting at 1. |
Response fields
| Field | Description |
|---|---|
| reservation_id | Unique identifier. |
| unit_id | The booked unit. |
| date_added | When the reservation was created. |
| name, phone, email | Customer contact details. |
| country, city, address | Customer address. |
| checkin_date, checkout_date | Rental period. |
| checkin_time, checkout_time | Pickup and return times. Vehicle accounts only. |
| price_per_day | Agreed daily rate for this reservation, which may differ from the unit's default. |
| payment_status | One of yes, no, partial. |
| source | Where the booking came from. See field values. |
| deposit | Security deposit. Vehicle accounts only. |
| pickup_location, delivery_location | Handover locations. Vehicle accounts only. |
| status | Reservation stage, or null if not set yet. Vehicle accounts only. |
| contract_url | Public link to the rental contract, or an empty string if none was issued. Vehicle accounts only. |
| company | Business details when the customer booked as a company. Omitted for individuals. |
curl "https://cloud.myrentals.ro/api/v1/reservations?from=2026-09-01&limit=1" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"reservation_id": 12065,
"unit_id": 484,
"date_added": "2026-08-14 14:13:56",
"name": "Ion Popescu",
"phone": "+40712345678",
"email": "ion@example.com",
"country": "Romania",
"city": "Piatra-Neamt",
"address": "Str. Exemplu 10",
"checkin_date": "2026-09-24",
"checkout_date": "2026-09-26",
"price_per_day": "122.00",
"payment_status": "no",
"source": "booking_engine",
"checkin_time": "12:00:00",
"checkout_time": "12:00:00",
"deposit": "500.00",
"pickup_location": "Piatra-Neamt",
"delivery_location": "Brasov",
"status": "requested",
"contract_url": "https://contract.myrentals.ro/view_contract?token=3c4eb6ba-97d1-11f1-a1c9-7cc25526969e"
}
],
"meta": {
"total": 102,
"page": 1,
"limit": 1,
"pages": 102
}
}
The contract_url is a public link — anyone holding it can view and sign that contract. Send it only to the customer it belongs to.
Availability
Checks which units are free for a given period. Call it without unit_id to list every free unit, or with unit_id to check one and see what is blocking it.
Query parameters
| Parameter | Description |
|---|---|
| checkin_daterequired | Start of the period, YYYY-MM-DD. |
| checkout_daterequired | End of the period. Must be after checkin_date. |
| checkin_timevehicles | Pickup time, HH:MM. Required on vehicle accounts, ignored on stays. |
| checkout_timevehicles | Return time, HH:MM. Required on vehicle accounts, ignored on stays. |
| unit_idoptional | Check one specific unit instead of listing all free ones. |
When listing all units, only active, non-archived units are considered, and only the free ones are returned. When checking a single unit, the response includes available as a boolean and, if it is booked, a blocking_reservations array showing exactly which reservations overlap.
curl "https://cloud.myrentals.ro/api/v1/availability?checkin_date=2026-08-24&checkin_time=12:00&checkout_date=2026-08-26&checkout_time=12:00" \ -H "Authorization: Bearer YOUR_API_KEY"
{
"checkin": "2026-08-24 12:00",
"checkout": "2026-08-26 12:00",
"available": [
{
"unit_id": 483,
"name": "NT123ABC",
"price": "65.00",
"model": "Audi A4"
}
]
}
{
"checkin": "2026-08-24 12:00",
"checkout": "2026-08-26 12:00",
"unit": {
"unit_id": 484,
"name": "NT125ABC",
"price": "90.00",
"model": "Porsche Cayenne"
},
"available": false,
"blocking_reservations": [
{
"reservation_id": 12065,
"checkin_date": "2026-08-24",
"checkout_date": "2026-08-26",
"checkin_time": "12:00:00",
"checkout_time": "12:00:00"
}
]
}
Availability can change between the moment you check it and the moment you book. Creating a reservation re-checks the period and returns 409 if it was taken in the meantime — always handle that response.
Contract templates
Returns the contract templates defined on your account. Use a template_id from this list when creating a reservation with generate_contract. Takes no parameters. Accounts without templates return an empty data array.
Response fields
| Field | Description |
|---|---|
| template_id | Template identifier, unique within your account. |
| name | Template name, as set in the dashboard. |
| language | Language code of the template, e.g. ro-ro or en-gb. |
| is_default | true for the template used when no template_id is sent. |
curl https://cloud.myrentals.ro/api/v1/contract_templates \
-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"template_id": 1,
"name": "Contract standard",
"language": "ro-ro",
"is_default": true
},
{
"template_id": 3,
"name": "Contract EN",
"language": "en-gb",
"is_default": false
}
]
}
New reservation
Creates a reservation. Send a JSON body with Content-Type: application/json. The unit must belong to your account, must not be archived, and must be free for the requested period.
Body parameters
| Parameter | Description |
|---|---|
| unit_idrequired | The unit to book. |
| namerequired | Customer name. |
| checkin_daterequired | Start date, YYYY-MM-DD. |
| checkout_daterequired | End date. Must be after checkin_date. |
| checkin_timevehicles | Pickup time, HH:MM. Required on vehicle accounts. |
| checkout_timevehicles | Return time, HH:MM. Required on vehicle accounts. |
| phoneoptional | Customer phone number. |
| emailoptional | Customer email address. |
| country, zone, city, addressoptional | Customer address. zone is the county or region. |
| price_per_dayoptional | Daily rate for this booking. Defaults to the unit's own price. |
| payment_statusoptional | yes, no or partial. Defaults to no. |
| depositoptional | Security deposit. Vehicle accounts only. |
| statusoptional | Initial stage. Defaults to requested. Vehicle accounts only. |
| generate_contractoptional | true to issue a rental contract. Uses your default template unless template_id is sent. Vehicle accounts only. |
| template_idoptional | Contract template to use, from GET /contract_templates. Only applies together with generate_contract. An unknown ID returns 400 and no reservation is created. |
| companyoptional | Object with name, vat_code, reg_com and address when booking on behalf of a business. |
curl -X POST https://cloud.myrentals.ro/api/v1/new_reservation \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "unit_id": 483, "name": "Ion Popescu", "phone": "+40712345678", "email": "ion@example.com", "checkin_date": "2026-09-25", "checkin_time": "10:00", "checkout_date": "2026-09-27", "checkout_time": "10:00", "status": "confirmed", "generate_contract": true }'
{
"reservation_id": 12310,
"days": 2,
"price_per_day": "65.00",
"total": "130.00",
"contract_url": "https://contract.myrentals.ro/view_contract?token=66e99209-9c71-11f1-be10-7cc25526969e"
}
How days are counted
On vehicle accounts the rental length is the number of hours between pickup and return, rounded up to whole days — so a 26-hour rental counts as 2 days. On stays the count is simply the number of nights. In both cases the minimum is one day.
This endpoint is not idempotent. Retrying a request that already succeeded will create a second reservation if the period is still free. Store the returned reservation_id and check it before retrying after a network timeout.
Field values
Reservation status
Vehicle accounts only. Reflects where a rental is in its lifecycle.
A reservation may also return null if no status has been set yet.
Payment status
Source
Read-only. Tells you where a reservation originated.
| Value | Meaning |
|---|---|
| manual | Entered by hand in the MyRentals dashboard. |
| booking_engine | Came through your MyRentals booking page. |
| airbnb | Synced from Airbnb. |
| booking | Synced from Booking.com. |
Reservations created through this API are recorded separately and appear in the dashboard history as created via API.
Support
Questions about the API, a key that stopped working, or something you need that is not covered here — write to contact@myrentals.ro.
When reporting a problem, include the endpoint you called, the approximate time of the request and the error code you received. Never include your API key in an email.