API Reference

The Renta API is organized around REST. It uses JSON for request/response bodies, standard HTTP verbs, and returns conventional HTTP status codes.

Base URL

https://api.getrenta.io/v1

Authentication

All requests require a Bearer token:

Authorization: Bearer renta_sk_live_...

See Authentication for details on key types and scopes.

Conventions

Monetary values are in cents (e.g., 5000 = $50.00 USD)
Dates use ISO 8601 format (2026-07-01T09:00:00Z)
IDs are UUID strings (e.g., fi_abc123)
Pagination uses cursor-based pagination with cursor and limit parameters
snake_case is used for all JSON field names

Endpoints by Domain

Fleet & Inventory

Fleet

Categories and items — manage your rental inventory

Availability

Check item availability for date ranges

Pricing

Calculate pricing breakdowns

Bookings & Payments

Bookings

Create, update, extend, cancel, and swap items

Payments

Create Stripe payment intents

Deposits

Hold, capture, and release deposit authorization holds

Customers & Commerce

Customers

Customer profiles and lifetime stats

Add-ons

Helmets, insurance, and accessories

Coupons

Discount codes with validation

Locations & Reviews

Locations

Pickup locations with address, hours, and coordinates

Reviews

Customer reviews with moderation

Documents & Platform

Documents

Document templates, signing sessions, and e-signatures

Waivers

Digital waiver templates and signing

Calendar

iCal feed management

Storefront

Public-facing inventory and booking

Health

API connectivity and credential validation

Webhooks

Webhook endpoint management (coming soon)

Pagination

All list endpoints use cursor-based pagination:

{
  "data": [...],
  "has_more": true,
  "next_cursor": "eyJpZCI6ImZpXzk5OSJ9"
}

Parameter	Type	Default	Description
`cursor`	string	—	Cursor from `next_cursor` of previous response
`limit`	integer	20	Number of results (1–100)

Error Format

{
  "error": {
    "type": "not_found",
    "message": "Fleet item not found"
  }
}

See Error Handling for all error types.