MyRentals API v1

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

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
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.

ScopeAllows
readAll GET requests. Any other method returns 403.
writeEverything 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.

TypeBehaviour
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.

HeaderDescription
X-RateLimit-LimitMaximum requests allowed per minute.
X-RateLimit-RemainingRequests left in the current window.
Retry-AfterSeconds 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.

429 Too Many Requests
{
  "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 response
{
  "error": {
    "code": "not_available",
    "message": "The unit is already booked for this period."
  }
}
StatusCodeMeaning
400invalid_inputA required parameter is missing or malformed.
400invalid_datesDates are not YYYY-MM-DD, or checkout is not after checkin.
400invalid_timesTimes are missing or not HH:MM. Vehicle accounts only.
400invalid_jsonThe request body is not valid JSON.
400invalid_templateThe template_id does not exist on your account.
401unauthorizedThe API key is missing, revoked or invalid.
403forbiddenThe key is read-only but the request tries to write.
404not_foundThe endpoint or the referenced unit does not exist.
405method_not_allowedWrong HTTP method for this endpoint.
409not_availableThe unit is already booked for the requested period.
429rate_limit_exceededToo many requests. See rate limits.
500server_errorSomething went wrong on our side. Retry; if it persists, contact support.

Ping

GET /api/v1/ping read

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.

Request
curl https://cloud.myrentals.ro/api/v1/ping \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
  "ok": true,
  "user_id": 19,
  "scope": "write",
  "method": "GET",
  "time": "2026-08-20T11:36:30+03:00"
}

Units

GET /api/v1/units read

Returns every non-archived unit on your account — the cars, apartments or equipment you rent out. Archived units are never included.

Query parameters

ParameterDescription
limitoptionalMaximum number of units to return. Omit to return all of them.

Response fields

FieldDescription
unit_idUnique identifier. Use it when checking availability or creating a reservation.
nameOn vehicle accounts this is the licence plate. On stays it is the unit name, such as "Apartament 1".
modelThe vehicle model, e.g. "Skoda Octavia". Vehicle accounts only.
priceDefault daily rate, as a string with two decimals.
status1 if the unit is active and bookable, 0 if temporarily disabled.
documentsExpiry dates for itp, rca, rovinieta and casco. Each is null when not recorded. Vehicle accounts only.
Request
curl "https://cloud.myrentals.ro/api/v1/units?limit=2" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK — vehicle account
{
  "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"
      }
    }
  ]
}
200 OK — stays account
{
  "data": [
    {
      "unit_id": 49,
      "name": "Apartament 1",
      "price": "240.00",
      "status": 1
    }
  ]
}

Reservations

GET /api/v1/reservations read

Lists reservations, newest check-in first. Results are paginated at a maximum of 100 per page.

Query parameters

ParameterDescription
reservation_idoptionalReturn a single reservation by its ID.
unit_idoptionalOnly reservations for this unit.
fromoptionalOnly reservations with a check-in on or after this date.
tooptionalOnly reservations with a check-in on or before this date.
limitoptionalResults per page, 1 to 100. Defaults to 100.
pageoptionalPage number, starting at 1.

Response fields

FieldDescription
reservation_idUnique identifier.
unit_idThe booked unit.
date_addedWhen the reservation was created.
name, phone, emailCustomer contact details.
country, city, addressCustomer address.
checkin_date, checkout_dateRental period.
checkin_time, checkout_timePickup and return times. Vehicle accounts only.
price_per_dayAgreed daily rate for this reservation, which may differ from the unit's default.
payment_statusOne of yes, no, partial.
sourceWhere the booking came from. See field values.
depositSecurity deposit. Vehicle accounts only.
pickup_location, delivery_locationHandover locations. Vehicle accounts only.
statusReservation stage, or null if not set yet. Vehicle accounts only.
contract_urlPublic link to the rental contract, or an empty string if none was issued. Vehicle accounts only.
companyBusiness details when the customer booked as a company. Omitted for individuals.
Request
curl "https://cloud.myrentals.ro/api/v1/reservations?from=2026-09-01&limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
  "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

GET /api/v1/availability read

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

ParameterDescription
checkin_daterequiredStart of the period, YYYY-MM-DD.
checkout_daterequiredEnd of the period. Must be after checkin_date.
checkin_timevehiclesPickup time, HH:MM. Required on vehicle accounts, ignored on stays.
checkout_timevehiclesReturn time, HH:MM. Required on vehicle accounts, ignored on stays.
unit_idoptionalCheck 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.

Request — all free units
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"
200 OK
{
  "checkin": "2026-08-24 12:00",
  "checkout": "2026-08-26 12:00",
  "available": [
    {
      "unit_id": 483,
      "name": "NT123ABC",
      "price": "65.00",
      "model": "Audi A4"
    }
  ]
}
200 OK — single unit, booked
{
  "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

GET /api/v1/contract_templates read

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

FieldDescription
template_idTemplate identifier, unique within your account.
nameTemplate name, as set in the dashboard.
languageLanguage code of the template, e.g. ro-ro or en-gb.
is_defaulttrue for the template used when no template_id is sent.
Request
curl https://cloud.myrentals.ro/api/v1/contract_templates \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
  "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

POST /api/v1/new_reservation write

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

ParameterDescription
unit_idrequiredThe unit to book.
namerequiredCustomer name.
checkin_daterequiredStart date, YYYY-MM-DD.
checkout_daterequiredEnd date. Must be after checkin_date.
checkin_timevehiclesPickup time, HH:MM. Required on vehicle accounts.
checkout_timevehiclesReturn time, HH:MM. Required on vehicle accounts.
phoneoptionalCustomer phone number.
emailoptionalCustomer email address.
country, zone, city, addressoptionalCustomer address. zone is the county or region.
price_per_dayoptionalDaily rate for this booking. Defaults to the unit's own price.
payment_statusoptionalyes, no or partial. Defaults to no.
depositoptionalSecurity deposit. Vehicle accounts only.
statusoptionalInitial stage. Defaults to requested. Vehicle accounts only.
generate_contractoptionaltrue to issue a rental contract. Uses your default template unless template_id is sent. Vehicle accounts only.
template_idoptionalContract template to use, from GET /contract_templates. Only applies together with generate_contract. An unknown ID returns 400 and no reservation is created.
companyoptionalObject with name, vat_code, reg_com and address when booking on behalf of a business.
Request
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
  }'
201 Created
{
  "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.

requested confirmed picked_up returned completed

A reservation may also return null if no status has been set yet.

Payment status

yes no partial

Source

Read-only. Tells you where a reservation originated.

ValueMeaning
manualEntered by hand in the MyRentals dashboard.
booking_engineCame through your MyRentals booking page.
airbnbSynced from Airbnb.
bookingSynced 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.