Skip to main content

Place Operations

You can use these endpoints to manage and list physical spaces, event venues, concert halls, workshop studios, or store branches (Places). This module is critical for map, event, booking, and location-based applications.

The x-avci-client identity header is mandatory for all requests.


1. List Places​

Lists all venues and physical spaces on the platform with pagination and filtering support.

  • Endpoint: GET /v1/place
  • Auth Requirement: x-avci-client

Query Parameters​

ParameterTypeDescription
pageNumberPage number (Default: 1)
limitNumberNumber of records per page (Default: 10)
areaStringFilter by area / category ObjectId.
searchStringSearches within the place name and description.

Example JSON Response:

{
"status": "success",
"data": [
{
"_id": "6735c03a9f1a2b3c4d5e6f70",
"name": "KucukCiftlik Park",
"slug": "kucukciftlik-park",
"abstract": "Istanbul's premier open-air event & performance venue.",
"logo": {
"_id": "6735c03a9f1a2b3c4d5e6f71",
"path": "https://cdn.avcicms.com/uploads/kcp-logo.webp"
},
"featuredImage": {
"_id": "6735c03a9f1a2b3c4d5e6f72",
"path": "https://cdn.avcicms.com/uploads/kcp-featured.webp"
},
"capacity": {
"min": 500,
"max": 17000
},
"address": {
"city": "İstanbul",
"district": "Şişli",
"formattedAddress": "Harbiye Mah. Kadırgalar Cad. No:4, Şişli/İstanbul",
"location": {
"type": "Point",
"coordinates": [28.9950, 41.0450]
}
},
"pricing": {
"isPaid": true,
"pricingType": "PER_EVENT",
"amount": 250000,
"currency": "TRY"
},
"status": "ACTIVE"
}
]
}

2. Place Details by Slug​

Fetches full profile details of a specific venue (photos, capacity, working hours, pricing model, map coordinates) via its slug value.

  • Endpoint: GET /v1/place/:slug
  • Auth Requirement: x-avci-client

Example JSON Response:

{
"status": "success",
"data": {
"_id": "6735c03a9f1a2b3c4d5e6f70",
"name": "KucukCiftlik Park",
"slug": "kucukciftlik-park",
"abstract": "Istanbul's premier open-air event & performance venue.",
"description": "Offering world-class acoustics and versatile hosting capabilities for concerts, festivals, and corporate celebrations.",
"capacity": {
"min": 500,
"max": 17000
},
"working": [
{
"day": 1,
"hours": { "start": "09:00", "end": "23:00" }
},
{
"day": 5,
"hours": { "start": "10:00", "end": "02:00" }
}
],
"pricing": {
"isPaid": true,
"pricingType": "DAILY",
"amount": 250000,
"currency": "TRY"
},
"address": {
"city": "İstanbul",
"district": "Şişli",
"street": "Kadırgalar Cad.",
"buildingNumber": "4",
"formattedAddress": "Harbiye Mah. Kadırgalar Cad. No:4, Şişli/İstanbul",
"location": {
"type": "Point",
"coordinates": [28.9950, 41.0450]
}
},
"logo": { "path": "https://cdn.avcicms.com/uploads/kcp-logo.webp" },
"coverImage": { "path": "https://cdn.avcicms.com/uploads/kcp-cover.webp" },
"gallery": [
{ "path": "https://cdn.avcicms.com/uploads/kcp-stage.webp" },
{ "path": "https://cdn.avcicms.com/uploads/kcp-crowd.webp" }
],
"status": "ACTIVE"
}
}

3. Place Details by ID​

Fetches the complete profile details of a venue using its MongoDB _id identifier.

  • Endpoint: GET /v1/place/id/:_id
  • Auth Requirement: x-avci-client

4. Place Summary Card​

Returns lightweight preview data optimized for map pin popups, mobile preview cards, and listing grids.

  • Endpoint: GET /v1/place/short/:slug
  • Auth Requirement: x-avci-client

Example JSON Response:

{
"status": "success",
"data": {
"_id": "6735c03a9f1a2b3c4d5e6f70",
"name": "KucukCiftlik Park",
"slug": "kucukciftlik-park",
"abstract": "Istanbul's premier open-air event & performance venue.",
"logo": { "path": "https://cdn.avcicms.com/uploads/kcp-logo.webp" },
"capacity": { "min": 500, "max": 17000 },
"address": {
"city": "İstanbul",
"district": "Şişli"
},
"pricing": {
"isPaid": true,
"amount": 250000,
"currency": "TRY"
}
}
}

5. Sub-Services & Community Interactions​

Places integrate seamlessly with AVCI CMS shared microservices:

  • Categories: GET /v1/place/category — Filter venues by sector/type categories.
  • Groups: GET /v1/place/group — Curated groupings (e.g., "Historic Venues", "Open-Air Theatres").
  • Collections: GET /v1/place/collection — Editorial venue lists.
  • Favorites / Likes: POST /v1/place/like/:slug — Toggle user favorite status.
  • View Counter: POST /v1/place/view/:slug — Increment showcase analytics view counter.
  • Social Shares: POST /v1/place/share/:slug — Track referral shares across social channels.
  • Q&A Inquiries: GET /v1/place/question/:slug & POST /v1/place/question/:slug — Submit direct venue inquiries.