API Documentation

Developer Resources

Integrate Max-Rent.com into your applications with our comprehensive REST API. Build powerful vacation rental management tools.

Quick Start

Authentication

All API requests require authentication using your API key

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.max-rent.com/v1/properties

Get your API key from your account dashboard under Settings → API Keys.

Rate Limits

API usage limits and best practices

Requests per minute

1000

Requests per hour

10,000

Concurrent connections

Rate limit headers are included in all responses to help you manage your usage.

API Endpoints

GET

/api/v1/properties

Retrieve all properties for the authenticated user

Parameters

limit

integer

Number of results to return (max 100)

offset

integer

Number of results to skip

status

string

Filter by property status (active, inactive)

Response Codes

200

Success

401

Unauthorized

429

Rate limit exceeded

POST

/api/v1/properties

Create a new property listing

Parameters

name

string

Property name (required)

address

object

Property address details

type

string

Property type (apartment, house, villa)

amenities

array

List of property amenities

Response Codes

201

Property created successfully

400

Bad request

401

Unauthorized

GET

/api/v1/bookings

Get booking information and reservations

Parameters

property_id

string

Filter by specific property ID

date_from

date

Start date for booking search

date_to

date

End date for booking search

status

string

Booking status (confirmed, pending, cancelled)

Response Codes

200

Success

401

Unauthorized

404

No bookings found

PUT

/api/v1/availability

Update property availability and pricing

Parameters

property_id

string

Property ID (required)

date

date

Date to update (required)

available

boolean

Availability status

price

number

Nightly rate

Response Codes

200

Availability updated

400

Bad request

401

Unauthorized

404

Property not found

Official SDKs

JavaScript/Node.js

Official SDK for JavaScript and Node.js applications

Installation

npm install @max-rent/sdk

Example

import { MaxRentAPI } from '@max-rent/sdk';

const client = new MaxRentAPI({
  apiKey: 'your-api-key'
});

const properties = await client.properties.list();

Python

Python SDK for easy integration with Python applications

Installation

pip install maxrent-python

Example

from maxrent import MaxRentClient

client = MaxRentClient(api_key='your-api-key')
properties = client.properties.list()

PHP

PHP SDK for web applications and WordPress plugins

Installation

composer require maxrent/php-sdk

Example

<?php
use MaxRent\Client;

$client = new Client('your-api-key');
$properties = $client->properties()->list();

API Explorer

Test our API endpoints directly from your browser with our interactive explorer.