title: GET /api/rents description: Výpis pronajímatelů se stránkováním a filtrováním.

GET /api/rents

URL: /api/rents
Metoda: GET
Autorizace: dle projektu
Vrací: stránkovaný seznam objektů Rent

Tento endpoint Rentall API vrací seznam pronajímatelů.

Parametry dotazu

page — číslo (výchozí 1)
limit — číslo (výchozí 10)
where — volitelné filtry dle konvencí Rentall

Úspěšná odpověď

Stav: 200 OK
Tělo: stránkovaný výsledek


{
  "docs": [
    {
      "id": "684dcbb7a60636d5a2618584",
      "basic": {
        "rentalName": "Example Rentals s.r.o.",
        "rentalContactPerson": "John Doe",
        "rentalEmail": "info@rentall.cz"
      },
      "createdAt": "2025-06-14T19:21:27.434Z",
      "updatedAt": "2025-06-14T19:35:26.433Z"
    }
  ],
  "hasNextPage": false,
  "limit": 10,
  "page": 1,
  "totalDocs": 1,
  "totalPages": 1
}

Chyby

401/403 při neautorizovaném/zakázaném přístupu

Příklady

curl


curl -s \
  -H "Authorization: Bearer $RENTALL_TOKEN" \
  "https://rentall.cz/api/rents?limit=20&sort=-createdAt"

JavaScript


const token = process.env.RENTALL_TOKEN;
const res = await fetch("https://rentall.cz/api/rents?limit=20&sort=-createdAt", {
  headers: { Authorization: `Bearer ${token}` },
});
const data = await res.json();
console.log(data.docs.length);

TypeScript


interface RentList { docs: Array<{ id: string }>; page: number; totalPages: number }
const token = process.env.RENTALL_TOKEN as string;
const res = await fetch("https://rentall.cz/api/rents?limit=20&sort=-createdAt", {
  headers: { Authorization: `Bearer ${token}` },
});
const data: RentList = await res.json();
console.log(data.page, data.totalPages);

PHP


<?php
$token = getenv('RENTALL_TOKEN');
$url = 'https://rentall.cz/api/rents?limit=20&sort=-createdAt';
$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . $token ]
]);
$resp = curl_exec($ch);
if ($resp === false) throw new Exception(curl_error($ch));
curl_close($ch);
$data = json_decode($resp, true);
echo count($data['docs'] ?? []);