Get one listing#

GET/v1/listings/{listingId}

Convenience for a single listing. Prefer the bulk form with listingIds.

Request

cURL

curl -X GET 'https://partner-api.elivaas.com/v1/listings/{listingId}' \
  -u "$ELIVAAS_API_KEY:" \
  -H 'Content-Type: application/json'

Node.js

const res = await fetch('https://partner-api.elivaas.com/v1/listings/{listingId}', {
  method: 'GET',
  headers: {
    Authorization: 'Basic ' + Buffer.from(process.env.ELIVAAS_API_KEY + ':').toString('base64'),
    'Content-Type': 'application/json',
  },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

Python

import os, requests
res = requests.get(
    "https://partner-api.elivaas.com/v1/listings/{listingId}",
    auth=(os.environ["ELIVAAS_API_KEY"], ""),
    timeout=30,
)
res.raise_for_status()
data = res.json()

Response 200

{
  "id": "lst_0853ie",
  "title": "Querencia | Pet-friendly 5-BHK Villa With Sunset & Hill Views",
  "status": "ACTIVE",
  "type": "STANDALONE",
  "city": "Kasauli",
  "state": "Himachal Pradesh",
  "country": "India",
  "locality": "Garkhal",
  "latitude": 30.91535,
  "longitude": 76.95875,
  "maxAdults": 13,
  "maxChildren": 14,
  "price": 29553,
  "createdAt": "2026-02-15T22:00:57.719717Z",
  "updatedAt": "2026-05-21T11:09:03.024811Z",
  "properties": [
    {
      "id": "prop_20Etl54TyDHROM",
      "name": "Querencia | Pet-friendly 5-BHK Villa With Sunset & Hill Views",
      "brand": "ELIVAAS",
      "type": "STANDALONE",
      "city": "Kasauli",
      "state": "Himachal Pradesh",
      "country": "India",
      "location": "Garkhal",
      "latitude": 30.91535,
      "longitude": 76.95875,
      "maxAdults": 13,
      "maxChildren": 14,
      "applicableAdult": 8,
      "applicableChild": 8,
      "numberOfBeds": 5,
      "quantity": 1,
      "price": 29553,
      "isPetFriendly": true,
      "photos": [
        {
          "url": "https://cdn.elivaas.com/hero.webp",
          "name": "Hero shot"
        }
      ],
      "amenities": [
        {
          "icon": "https://cdn.elivaas.com/pool.svg",
          "name": "Private pool",
          "category": "Outdoor"
        }
      ]
    }
  ]
}

Path parameters#

listingIdstringrequired: No description in the spec.

Responses#

Status	Meaning
`200`	OK
`400`	Validation failure. The message names the offending parameter. Limits are rejected, never silently clamped: an over-length id list, a page size above 100 or a date window longer than 365 days all land here rather than coming back quietly truncated.
`401`	Missing, malformed, revoked or unknown API key, or an agent group whose distribution access is disabled. Pass the key as the HTTP Basic username with an empty password.
`404`	No such resource on your channel. A resource that exists but belongs to another tenant is reported identically — the two are never distinguished, so this response can't be used to enumerate ids.
`429`	Rate limit exhausted for this credential. Wait `Retry-After` seconds before retrying; the budget is per credential, not per IP.

See Errors for the error body shape and which statuses are worth retrying.