Get listing by ID

Retrieves a specific listing by its unique identifier. Returns detailed information about the listing including amenities, contact details, and other metadata.

Authorization

x-calry-api-key

x-calry-api-key<token>

In: header

Path Parameters

id*string

Unique identifier of the listing

Query Parameters

displayCurrency?string

Currency code for displaying pricing (ISO 4217)

integrationAccountID?string

Filter listings by integration account ID

status?string

Filter listings by status

Value in"ACTIVE" | "INACTIVE"

listingType?string

Filter by listing source

Value in"imported" | "self"

guests?number

Minimum number of guests the listing can accommodate

Range1 <= value <= 100

bedroomCount?number

Number of bedrooms

Range0 <= value <= 20

bathroomCount?number

Number of bathrooms

Range0 <= value <= 20

amenities?array<string>

Array of amenity IDs to filter by

location?string

Location coordinates in format "latitude,longitude"

radius?number

Search radius in kilometers

Range0.1 <= value <= 100

page?number

Page number for pagination

Range1 <= value

limit?number

Number of items per page

Range1 <= value <= 100

Header Parameters

x-calry-tenant-id?string

Optional tenant ID to specify which tenant to operate as. If not provided, the default tenant will be used.

Response Body

`application/json`

curl -X GET "https://example.com/api/v1/listing/123e4567-e89b-12d3-a456-426614174000"

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "providerID": "provider-listing-12345",
  "integrationAccountID": "123e4567-e89b-12d3-a456-426614174000",
  "tenantID": "123e4567-e89b-12d3-a456-426614174000",
  "is_tenant_owned": true,
  "name": "Luxury Beach Villa",
  "internalName": "<HOST> Luxury Beach Villa",
  "description": "Beautiful beachfront villa with stunning views",
  "type": "Villa",
  "thumbnailURL": "https://example.com/thumbnail.jpg",
  "pictures": [
    {
      "url": "https://example.com/picture.jpg",
      "description": "A beautiful picture of the listing"
    }
  ],
  "address": {
    "city": "Miami Beach",
    "line1": "123 Ocean Drive",
    "state": "FL",
    "country": "USA",
    "postal_code": "70078"
  },
  "latitude": -80.1918,
  "longitude": 25.7617,
  "minimumNights": 3,
  "maximumNights": 28,
  "maxOccupancy": 10,
  "startPrice": 10,
  "currency": "AED",
  "timeZone": "Asia/Dubai",
  "status": "ACTIVE",
  "rating": {
    "count": 23,
    "average": 4.2
  },
  "bedroomCount": 3,
  "bathroomCount": 3,
  "rooms": {
    "data": [
      {
        "name": "SLEEPING_ALCOVE",
        "count": 1
      },
      {
        "name": "LIVING-DINING_ROOM",
        "count": 1
      }
    ]
  },
  "checkIn": {
    "op": "CHECK_IN",
    "end": "18:00:00",
    "start": "16:00:00"
  },
  "checkOut": {
    "op": "CHECK_IN",
    "end": "15:00:00"
  },
  "houseRules": {
    "property1": null,
    "property2": null
  },
  "listingDetails": {
    "notes": "",
    "rules": "House rules are NON-negotiable conditions of stay. Any violation of our house rules will result in the immediate cancellation of your reservation, without refund, and your removal from the property.",
    "space": "",
    "access": "",
    "transit": "",
    "interaction": "",
    "instructions": "",
    "neighborhood": ""
  },
  "contact": {
    "name": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "email": [
      "john.doe@example.com"
    ],
    "phone": [
      "+1234567890"
    ],
    "address": "123 Main St, Anytown, USA",
    "language": "en",
    "country": "USA"
  },
  "unitCount": 3,
  "parentPropertyID": "string",
  "amenities": {
    "categories": {
      "Common Amenities": {
        "categoryID": "common",
        "values": [
          {
            "name": "Wifi",
            "id": "amenity-123"
          },
          {
            "name": "Kitchen",
            "id": "amenity-123"
          },
          {
            "name": "Iron",
            "id": "amenity-123"
          },
          {
            "name": "Pet friendly",
            "id": "amenity-123"
          },
          {
            "name": "Bed linens",
            "id": "amenity-123"
          }
        ]
      },
      "Outdoor": {
        "categoryID": "outdoor",
        "values": [
          {
            "name": "Smoking allowed",
            "id": "amenity-123"
          }
        ]
      }
    }
  },
  "tags": [
    {
      "id": "a1111111-1111-1111-1111-111111111111",
      "name": "Beachfront"
    },
    {
      "id": "b2222222-2222-2222-2222-222222222222",
      "name": "Pet Friendly"
    }
  ],
  "rawAmenities": [
    {
      "id": 3,
      "name": "Wireless"
    },
    {
      "id": 6,
      "name": "Swimming pool"
    },
    {
      "id": 7,
      "name": "Kitchen"
    },
    {
      "id": 13,
      "name": "Washing Machine"
    },
    {
      "id": 30,
      "name": "Shampoo"
    },
    {
      "id": 32,
      "name": "Iron"
    },
    {
      "id": 33,
      "name": "Laptop Friendly workspace"
    },
    {
      "id": 34,
      "name": "TV"
    },
    {
      "id": 36,
      "name": "Smoking allowed"
    },
    {
      "id": 37,
      "name": "Pets allowed"
    },
    {
      "id": 41,
      "name": "Suitable for events"
    }
  ],
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-02T00:00:00.000Z",
  "units": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "providerUnitID": "unit-123",
      "name": "Ocean View Suite",
      "description": "Beautiful suite with ocean views",
      "inventoryCount": 2,
      "maxOccupancy": 4,
      "bedroomCount": 2,
      "bathroomCount": 2,
      "basePrice": 200,
      "currency": "USD",
      "isAutoGenerated": false,
      "status": "ACTIVE",
      "amenities": [
        {
          "name": "Balcony",
          "description": "Private balcony",
          "type": "outdoor"
        },
        {
          "name": "Mini Bar",
          "description": "Stocked mini bar",
          "type": "amenity"
        }
      ],
      "pictures": [
        {
          "url": "https://example.com/photo1.jpg",
          "description": "Suite interior"
        },
        {
          "url": "https://example.com/photo2.jpg",
          "description": "Balcony view"
        }
      ],
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-02T00:00:00.000Z"
    }
  ]
}

{
  "timestamp": "2025-03-05T11:45:49.631Z",
  "path": "<URL_PATH>",
  "message": "Authentication failed",
  "details": []
}

Empty

Authorization

Path Parameters

Query Parameters

Header Parameters

Response Body

200application/json

401application/json

404

`application/json`

`application/json`