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

# Obtener unidad por UUID o SKU

> Retorna los detalles completos de una unidad especifica incluyendo proyecto, producto,
tipologia, atributos agrupados por categoria, ubicacion y galeria de imagenes.

Solo retorna unidades publicadas.



## OpenAPI

````yaml /api/openapi.json get /units/{identifier}
openapi: 3.1.0
info:
  title: Isprop API
  version: 1.0.0
  description: API para gestión de unidades inmobiliarias y leads de Isprop
servers:
  - url: https://{tenantDomain}/api/v1
    description: Dominio del tenant
    variables:
      tenantDomain:
        default: tenant.example.com
        description: Dominio asignado al tenant, sin protocolo ni ruta.
security:
  - http: []
tags:
  - name: Unit
  - name: Project
  - name: Product
  - name: Typology
  - name: Lead
  - name: Lead Channel
  - name: Attribute
paths:
  /units/{identifier}:
    get:
      tags:
        - Unit
      summary: Obtener unidad por UUID o SKU
      description: >-
        Retorna los detalles completos de una unidad especifica incluyendo
        proyecto, producto,

        tipologia, atributos agrupados por categoria, ubicacion y galeria de
        imagenes.


        Solo retorna unidades publicadas.
      operationId: getUnit
      parameters:
        - name: identifier
          in: path
          required: true
          description: UUID o SKU de la unidad
          schema:
            type: string
          example: 76cafe86-1f24-4ef0-9646-5ab9530450fb
      responses:
        '200':
          description: '`Unit`'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Unit'
                required:
                  - data
        '401':
          $ref: '#/components/responses/AuthenticationException'
components:
  schemas:
    Unit:
      type: object
      properties:
        id:
          type: string
        sku:
          type: string
        listing_type:
          anyOf:
            - type: 'null'
            - type: string
              enum:
                - venta
                - alquiler
                - alquiler_temporal
                - permuta
        status:
          type: string
          enum:
            - disponible
            - pisado
            - cotizado
            - reservado
            - revision
            - vendido
            - no_disponible
        name:
          type: string
        stage:
          type: string
        sector:
          type: string
        unit:
          type: string
        price:
          type: string
        formatted_price:
          type: string
        currency_type:
          type: string
        currency_label:
          type: string
        total_area:
          type: string
        covered_area:
          type: string
        bedrooms:
          type: string
        bathrooms:
          type: string
        rooms:
          type: string
        store_active:
          type: string
        possession_date:
          type: string
        possession_type:
          type: string
          enum:
            - pozo
            - inmediata
            - en_ejecucion
        financial:
          type: object
          description: Condiciones comerciales
          properties:
            integration_percentage:
              type: string
            integration_discount:
              type: string
            installments:
              type: string
            currency_index_type:
              type: string
          required:
            - integration_percentage
            - integration_discount
            - installments
            - currency_index_type
        published_at:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        media:
          type: object
          properties:
            gallery:
              anyOf:
                - type: array
                  items:
                    type: string
                  minItems: 0
                  maxItems: 0
                  additionalItems: false
                - type: string
          required:
            - gallery
        project:
          $ref: '#/components/schemas/ProjectSummary'
        product:
          $ref: '#/components/schemas/ProductSummary'
        typology:
          anyOf:
            - $ref: '#/components/schemas/Typology'
            - type: 'null'
        address:
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
        attributes:
          type:
            - array
            - 'null'
          description: >-
            EAV attribute values as a flat `{ key: typed_value }` map. Includes

            denormalized fields (total_area, covered_area, bedrooms, bathrooms,
            rooms)

            so the map is a complete, self-contained snapshot of the unit.
            Top-level

            fields remain available for sorting/filtering.

            Schema metadata (label, icon, data_type, options) lives in GET
            /v1/attributes.
          items: {}
        badges:
          type: string
        attribute_categories:
          type:
            - string
            - 'null'
          description: >-
            EAV attributes grouped by category, with label/icon/sort_order for
            UI spec sheets.
      required:
        - id
        - sku
        - listing_type
        - status
        - name
        - stage
        - sector
        - unit
        - price
        - formatted_price
        - currency_type
        - currency_label
        - total_area
        - covered_area
        - bedrooms
        - bathrooms
        - rooms
        - store_active
        - possession_date
        - possession_type
        - financial
        - published_at
        - created_at
        - updated_at
        - media
        - attributes
        - badges
        - attribute_categories
      title: Unit
    ProjectSummary:
      type: object
      properties:
        id:
          type: string
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        tagline:
          type: string
        store_active:
          type: string
        logos:
          type:
            - array
            - 'null'
          items: {}
        address:
          anyOf:
            - $ref: '#/components/schemas/AddressSummary'
            - type: 'null'
        product_types:
          type:
            - array
            - 'null'
          description: >-
            Tipos de producto distintos entre los products del proyecto (ej:
            ["lotes"] o ["departamentos","cocheras","oficinas"])
          items: {}
        lots_map:
          type:
            - array
            - 'null'
          description: >-
            Config del overlay de tiles para la vista de mapa de lotes (null si
            el emprendimiento no tiene uno definido).
          items: {}
        has_lots_map:
          type: boolean
          description: >-
            Conveniencia para mostrar el toggle Lista/Mapa sin inspeccionar
            `lots_map`.
        published_at:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - slug
        - name
        - description
        - tagline
        - store_active
        - logos
        - product_types
        - lots_map
        - has_lots_map
        - published_at
        - created_at
        - updated_at
      title: ProjectSummary
    ProductSummary:
      type: object
      properties:
        id:
          type: string
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        product_type:
          type: string
        product_type_label:
          type: string
        type_labels:
          type: object
          properties:
            sector:
              anyOf:
                - type: string
                - type: string
                  enum:
                    - Sector
            unit:
              anyOf:
                - type: string
                - type: string
                  enum:
                    - Unidad
          required:
            - sector
            - unit
        thumbnail_url:
          type:
            - string
            - 'null'
        store_active:
          type: string
        logos:
          type:
            - array
            - 'null'
          description: >-
            Override: null cuando el producto no tiene logo propio (el front cae
            al del project).
          items: {}
        project:
          $ref: '#/components/schemas/ProjectSummary'
        address:
          anyOf:
            - $ref: '#/components/schemas/AddressSummary'
            - type: 'null'
        published_at:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - slug
        - name
        - description
        - product_type
        - product_type_label
        - type_labels
        - thumbnail_url
        - store_active
        - logos
        - published_at
        - created_at
        - updated_at
      title: ProductSummary
    Typology:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type: string
        created_at:
          type: string
        updated_at:
          type: string
        media:
          type: object
          properties:
            gallery:
              anyOf:
                - type: array
                  items:
                    type: string
                  minItems: 0
                  maxItems: 0
                  additionalItems: false
                - type: string
          required:
            - gallery
        product:
          $ref: '#/components/schemas/ProductSummary'
          description: Relaciones condicionales (summary para evitar nesting circular)
        units_count:
          type: integer
      required:
        - id
        - name
        - description
        - created_at
        - updated_at
        - media
      title: Typology
    Address:
      type: object
      properties:
        country:
          type: string
        state:
          type: string
        city:
          type: string
        neighborhood:
          type: string
        district:
          type: string
        postal_code:
          type: string
        address_line_1:
          type: string
        address_line_2:
          type: string
        phone:
          type: string
        latitude:
          type: string
        longitude:
          type: string
      required:
        - country
        - state
        - city
        - neighborhood
        - district
        - postal_code
        - address_line_1
        - address_line_2
        - phone
        - latitude
        - longitude
      title: Address
    AddressSummary:
      type: object
      properties:
        country:
          type: string
        state:
          type: string
        city:
          type: string
        neighborhood:
          type: string
      required:
        - country
        - state
        - city
        - neighborhood
      title: AddressSummary
  responses:
    AuthenticationException:
      description: Unauthenticated
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                description: Error overview.
            required:
              - message
  securitySchemes:
    http:
      type: http
      scheme: bearer
      bearerFormat: sanctum

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.