CalryOTA Docs
Listing

Get units for a listing

Retrieves all units associated with a specific listing. Shows both auto-generated units (for single-unit properties) and explicit units (for multi-unit properties).

GET
/api/v1/listing/{id}/units

Authorization

x-calry-api-key
x-calry-api-key<token>

In: header

Path Parameters

id*string

Unique identifier of the listing

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

application/json

curl -X GET "https://example.com/api/v1/listing/123e4567-e89b-12d3-a456-426614174000/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