> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hudhud.sa/llms.txt
> Use this file to discover all available pages before exploring further.

# Place Detail

> Fetch the full detail record for a single place by its ID, as returned by Places Search. Returns the richer attributes a search result omits: description, full address, contact details, social links, opening hours, amenities and media.



## OpenAPI

````yaml /swagger.json get /places/{id}
openapi: 3.1.0
info:
  description: >-
    Hudhud Maps provides the most accurate, real-time mapping data for the
    Kingdom of Saudi Arabia.
  title: Next-Generation Geospatial Intelligence for Saudi Arabia
  version: '1.0'
servers:
  - description: Production
    url: https://b.hudhud.sa/v1
security: []
externalDocs:
  description: ''
  url: ''
paths:
  /places/{id}:
    get:
      tags:
        - Places
      summary: Place Detail
      description: >-
        Fetch the full detail record for a single place by its ID, as returned
        by Places Search. Returns the richer attributes a search result omits:
        description, full address, contact details, social links, opening hours,
        amenities and media.
      operationId: PlacesEnrichment
      parameters:
        - description: Response language
          in: header
          name: Accept-Language
          schema:
            enum:
              - en
              - ar
            type: string
        - description: Place ID
          in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-PlaceEnrichment'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-any'
          description: Missing or invalid place ID
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-any'
          description: Missing or invalid API key
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-any'
          description: API key type is not secret
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-any'
          description: Place not found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response-any'
          description: Places service error
      security:
        - BearerAuth: []
components:
  schemas:
    Response-PlaceEnrichment:
      properties:
        data:
          $ref: '#/components/schemas/PlaceEnrichment'
        error:
          description: Error message (only present when ok is false)
          example: ''
          type: string
        ok:
          description: Whether the request was successful
          example: true
          type: boolean
      type: object
    Response-any:
      properties:
        data:
          description: Response payload
        error:
          description: Error message (only present when ok is false)
          example: ''
          type: string
        ok:
          description: Whether the request was successful
          example: true
          type: boolean
      type: object
    PlaceEnrichment:
      description: Response payload
      properties:
        amenities:
          description: Amenities offered by the place
          items:
            $ref: '#/components/schemas/PlaceAmenity'
          type: array
          uniqueItems: false
        building_no:
          description: Building number
          example: '7830'
          type: string
        category_ar:
          description: Category name in Arabic
          example: مطاعم
          type: string
        category_en:
          description: Category name in English
          example: Restaurants
          type: string
        category_key:
          description: Category key (see GET /places/categories)
          example: restaurants
          type: string
        city_ar:
          description: City name in Arabic
          example: الرياض
          type: string
        city_en:
          description: City name in English
          example: Riyadh
          type: string
        description_ar:
          description: Place description in Arabic
          example: مطعم يقدم المأكولات المحلية
          type: string
        description_en:
          description: Place description in English
          example: A restaurant serving local cuisine
          type: string
        district_ar:
          description: District name in Arabic
          example: العليا
          type: string
        district_en:
          description: District name in English
          example: Al Olaya
          type: string
        email:
          description: Contact email address
          example: hello@example.com
          type: string
        id:
          description: Unique identifier for the place
          example: 01K3E3MDPBRMRNWQNG7ERMB65T
          type: string
        instagram_url:
          description: Instagram profile URL
          example: https://www.instagram.com/example
          type: string
        is_trending:
          description: Whether the place is trending
          example: true
          type: boolean
        latitude:
          description: Latitude coordinate
          example: 24.887376
          type: number
        logo_url:
          description: Logo image URL
          example: https://cdn.example.com/logo.webp
          type: string
        longitude:
          description: Longitude coordinate
          example: 46.618124
          type: number
        media:
          description: Photos and videos of the place
          items:
            $ref: '#/components/schemas/PlaceMedia'
          type: array
          uniqueItems: false
        name_ar:
          description: Place name in Arabic
          example: مطعم
          type: string
        name_en:
          description: Place name in English
          example: Restaurant
          type: string
        national_address:
          description: Saudi national address short code
          example: RRRA2929
          type: string
        opening_hours:
          description: Regular opening hours, one entry per day of the week
          items:
            $ref: '#/components/schemas/PlaceOpeningHours'
          type: array
          uniqueItems: false
        phone_number:
          description: Contact phone number
          example: '+966500000000'
          type: string
        photo_count:
          description: Number of media items available for the place
          example: 12
          type: integer
        postal_code:
          description: Postal code
          example: '12333'
          type: string
        rating:
          description: Rating out of 5
          example: 4.5
          type: number
        snapchat_url:
          description: Snapchat profile URL
          example: https://www.snapchat.com/add/example
          type: string
        status:
          description: 'Operating status: open, permanently_closed or temporarily_closed'
          example: open
          type: string
        streetname_ar:
          description: Street name in Arabic
          example: طريق الملك فهد
          type: string
        streetname_en:
          description: Street name in English
          example: King Fahd Road
          type: string
        tiktok_url:
          description: TikTok profile URL
          example: https://www.tiktok.com/@example
          type: string
        website_url:
          description: Website URL
          example: https://example.com
          type: string
        x_url:
          description: X (formerly Twitter) profile URL
          example: https://x.com/example
          type: string
      type: object
    PlaceAmenity:
      description: Amenity, optionally grouping nested amenities
      properties:
        children:
          description: Amenities nested under this one
          items:
            $ref: '#/components/schemas/PlaceAmenity'
          type: array
          uniqueItems: false
        name_ar:
          description: Amenity name in Arabic
          example: واي فاي
          type: string
        name_en:
          description: Amenity name in English
          example: Wifi
          type: string
      type: object
    PlaceMedia:
      description: Media item with its full-size and thumbnail URLs
      properties:
        thumbnail_url:
          description: Thumbnail image URL
          example: https://cdn.example.com/photo-thumb.webp
          type: string
        type:
          description: 'Media type: photo, video, store_front or menu_photo'
          example: photo
          type: string
        url:
          description: Full-size media URL
          example: https://cdn.example.com/photo.webp
          type: string
      type: object
    PlaceOpeningHours:
      description: Opening intervals for one day of the week
      properties:
        day:
          description: 'Day of the week: sunday through saturday'
          example: sunday
          type: string
        hours:
          description: Intervals the place is open on this day
          items:
            $ref: '#/components/schemas/PlaceHour'
          type: array
          uniqueItems: false
      type: object
    PlaceHour:
      description: One interval during which the place is open
      properties:
        close:
          description: Closing time
          example: '23:00'
          type: string
        open:
          description: Opening time
          example: '09:00'
          type: string
      type: object
  securitySchemes:
    BearerAuth:
      description: >-
        JWT Bearer token for authentication. Example: "Bearer
        YOUR_API_TOKEN_HERE"
      in: header
      name: Authorization
      type: apiKey

````