1. Imóvel
Homfy Public API
  • Bem vindo
  • Autenticação
    • Emitir token
      POST
    • Renovar token
      POST
  • Empreendimento
    • Cadastrar empreendimento
      POST
    • Atualizar empreendimento
      PUT
    • Cadastrar empreendimentos em lote
      POST
    • Consultar empreendimento
      POST
    • Vincular imóveis ao empreendimento
      POST
  • Imóvel
    • Cadastrar imóvel
      POST
    • Atualizar imóvel
      PUT
    • Cadastrar imóveis em lote
      POST
    • Consultar detalhes do imóvel
      POST
    • Enviar fotos — passo 1: obter URLs
      POST
    • Enviar fotos — passo 2: concluir
      POST
    • Andamento do processamento das fotos
      POST
    • Enviar documento — passo 1: obter URL
      POST
    • Enviar documento — passo 2: concluir
      POST
    • Buscar imóveis
      POST
  • Proprietário
    • Cadastrar proprietário
      POST
    • Atualizar proprietário
      PUT
    • Cadastrar proprietários em lote
      POST
    • Consultar detalhes do proprietário
      POST
    • Buscar proprietários
      POST
    • Vincular proprietário a imóvel
      POST
  • Cliente
    • Cadastrar cliente
      POST
    • Atualizar cliente
      PUT
    • Cadastrar clientes em lote
      POST
    • Consultar detalhes do cliente
      POST
    • Buscar clientes
      POST
    • Atribuir cliente a corretor
      POST
  • Corretor
    • Consultar corretores
  • Schemas
    • ApiPartnerAuthTokenDTO
    • ApiPartnerAuthTokenResponseDTO
    • ApiPartnerErrorResponseDTO
    • ApiPartnerAuthRefreshTokenDTO
    • ApiPartnerAddressDTO
    • ApiPartnerPropertyDetailDTO
    • ApiPartnerPropertyPriceDTO
    • ApiPartnerPropertyListingDTO
    • ApiPartnerPropertyRegisterDTO
    • ApiPartnerPropertyCreatedDTO
    • ApiPartnerPropertySkippedDTO
    • ApiPartnerPropertyErrorItemDTO
    • ApiPartnerPropertyRegisterResponseDTO
    • ApiPartnerPropertyItemDTO
    • ApiPartnerPropertyBatchRegisterDTO
    • ApiPartnerPropertyUpdateDTO
    • ApiPartnerPropertyUpdateResponseDTO
    • ApiPartnerPropertyFindDTO
    • ApiPartnerListingPriceDTO
    • ApiPartnerListingImageDTO
    • ApiPartnerListingVideoDTO
    • ApiPartnerListingResponseDTO
    • ApiPartnerPropertyDetailResponseDTO
    • ApiPartnerPhotoFileDTO
    • ApiPartnerPhotosInitDTO
    • ApiPartnerPresignedPartDTO
    • ApiPartnerPhotoUploadTargetDTO
    • ApiPartnerPhotosInitResponseDTO
    • ApiPartnerUploadPartDTO
    • ApiPartnerPhotoUploadDTO
    • ApiPartnerPhotosCompleteDTO
    • ApiPartnerPhotoCompleteItemDTO
    • ApiPartnerPhotosCompleteResponseDTO
    • ApiPartnerPhotosStatusDTO
    • ApiPartnerPhotoVariantDTO
    • ApiPartnerPhotoStatusItemDTO
    • ApiPartnerPhotosStatusResponseDTO
    • ApiPartnerDocumentInitDTO
    • ApiPartnerDocumentInitResponseDTO
    • ApiPartnerDocumentCompleteDTO
    • ApiPartnerDocumentCompleteResponseDTO
    • ApiPartnerPropertyFiltroDTO
    • ApiPartnerPropertySearchFiltersDTO
    • ApiPartnerSearchSortDTO
    • ApiPartnerPropertySearchDTO
    • ApiPartnerPropertySummaryDTO
    • ApiPartnerPropertySearchResponseDTO
    • ApiPartnerOwnerSpouseDTO
    • ApiPartnerOwnerRegisterDTO
    • ApiPartnerOwnerCreatedDTO
    • ApiPartnerOwnerSkippedDTO
    • ApiPartnerOwnerErrorItemDTO
    • ApiPartnerOwnerRegisterResponseDTO
    • ApiPartnerOwnerItemDTO
    • ApiPartnerOwnerBatchRegisterDTO
    • ApiPartnerOwnerUpdateDTO
    • ApiPartnerOwnerUpdateResponseDTO
    • ApiPartnerOwnerFindDTO
    • ApiPartnerOwnerSpouseResponseDTO
    • ApiPartnerOwnerDetailResponseDTO
    • ApiPartnerOwnerSearchSortDTO
    • ApiPartnerOwnerSearchFiltersDTO
    • ApiPartnerOwnerSearchDTO
    • ApiPartnerOwnerSummaryDTO
    • ApiPartnerOwnerSearchResponseDTO
    • ApiPartnerOwnerLinkPropertyDTO
    • ApiPartnerOwnerLinkResponseDTO
    • ApiPartnerLeadRegisterDTO
    • ApiPartnerLeadCreatedDTO
    • ApiPartnerLeadSkippedDTO
    • ApiPartnerLeadErrorItemDTO
    • ApiPartnerLeadRegisterResponseDTO
    • ApiPartnerLeadItemDTO
    • ApiPartnerLeadBatchRegisterDTO
    • ApiPartnerLeadUpdateDTO
    • ApiPartnerLeadUpdateResponseDTO
    • ApiPartnerLeadFindDTO
    • ApiPartnerLeadDetailResponseDTO
    • ApiPartnerLeadSearchSortDTO
    • ApiPartnerLeadSearchFiltersDTO
    • ApiPartnerLeadSearchDTO
    • ApiPartnerLeadSummaryDTO
    • ApiPartnerLeadSearchResponseDTO
    • ApiPartnerLeadAssignAgentDTO
    • ApiPartnerLeadAssignAgentResponseDTO
    • ApiPartnerAgentSearchFiltersDTO
    • ApiPartnerAgentSearchDTO
    • ApiPartnerAgentSummaryDTO
    • ApiPartnerAgentSearchResponseDTO
    • ApiPartnerRealtyClusterRegisterDTO
    • ApiPartnerRealtyClusterCreatedDTO
    • ApiPartnerRealtyClusterSkippedDTO
    • ApiPartnerRealtyClusterErrorItemDTO
    • ApiPartnerRealtyClusterRegisterResponseDTO
    • ApiPartnerRealtyClusterItemDTO
    • ApiPartnerRealtyClusterBatchRegisterDTO
    • ApiPartnerRealtyClusterUpdateDTO
    • ApiPartnerRealtyClusterAddressResponseDTO
    • ApiPartnerRealtyClusterDetailResponseDTO
    • ApiPartnerRealtyClusterFindDTO
    • ApiPartnerRealtyClusterLinkPropertiesDTO
    • ApiPartnerRealtyClusterLinkedDTO
    • ApiPartnerRealtyClusterLinkErrorDTO
    • ApiPartnerRealtyClusterLinkResponseDTO
  1. Imóvel

Atualizar imóvel

PUT
/partner/v1/property
Atualização PARCIAL: o que não vier no corpo fica como está. O imóvel é identificado pelo partner_code.
É por aqui que se sincroniza preço e conteúdo do anúncio, no bloco listing — a busca do site é reprocessada em seguida.
Regras de negócio que podem recusar a chamada: imóvel vendido (status: 6) não muda mais de status, tipo, contrato ou finalidade; status: 5 (alugado) exige contract: "Aluguel" e status: 6 exige contract: "Compra".

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Example
{
    "status": 1,
    "realty_cluster_id": 42,
    "partner_code": "AP-1024",
    "type": "Apartamento",
    "purpose": "Residencial",
    "contract": "Compra",
    "address": {
        "state": "SC",
        "zipcode": "88015-600",
        "city": "Florianópolis",
        "district": "Centro",
        "street": "Bocaiúva",
        "street_number": "120",
        "street_type": "Rua",
        "reference": "Próximo ao mercado",
        "complement": "Apto 302",
        "block": "Torre B",
        "latitude": "-27.593500",
        "longitude": "-48.548500"
    },
    "detail": {
        "exclusividade": false,
        "lancamento": false,
        "permuta": false,
        "seguro_fianca": true,
        "fiador": true,
        "caucao": false,
        "titulo_capitalizacao": false,
        "entrega_ano": 2027,
        "entrega_mes": 3,
        "dormitorios": 2,
        "suites": 1,
        "banheiros": 2,
        "garagens": 1,
        "financiavel": 1,
        "ano_construcao": 2019,
        "area_total": 120,
        "area_privativa": 88,
        "area_util": 95,
        "terreno_comprimento": 30,
        "terreno_largura": 12,
        "numero_pessoas": 6,
        "distancia_mar": 500,
        "nro_matricula": 123456,
        "nro_iptu": 987654,
        "nro_medidor_energia": 12345,
        "nro_medidor_agua": 67890,
        "nro_medidor_gas": 11223,
        "andares": 2,
        "area_escritorio": 30,
        "area_laje": 60,
        "area_mezanino": 25,
        "closet": 1,
        "hidro_suite": 1,
        "living_ambientes": 2,
        "salas": 1,
        "tipo_construcao": "Alvenaria",
        "garagem_tipo": "Coberta",
        "garagem_numero_box": "12",
        "ocupacao": "Desocupado",
        "topografia": "Plano",
        "posicao": "Frente",
        "posicao_solar": "Norte",
        "andar_do_apto": "3",
        "estado_conservacao_imovel": "Novo",
        "formatodo_galpao": "Modular",
        "pe_direito_alto": "Não",
        "piso": "Porcelanato",
        "piso_area_intima": "Madeira",
        "piso_dormitorio": "Vinílico",
        "piso_sala": "Laminado",
        "caracteristicas": [
            "Piscina",
            "Churrasqueira",
            "Academia"
        ]
    },
    "listing": {
        "title": "Apartamento 2 dormitórios no Centro",
        "description": "Apartamento reformado, a duas quadras do mar.",
        "tour360": "https://tour.exemplo.com/ap-2-dorm",
        "price": {
            "price_sale": 450000,
            "price_rental": 2500,
            "price_realty_cluster": 680,
            "price_iptu": 120,
            "price_cleaning_fee": 250
        },
        "display_on_site": true
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/partner/v1/property' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "status": 1,
    "realty_cluster_id": 42,
    "partner_code": "AP-1024",
    "type": "Apartamento",
    "purpose": "Residencial",
    "contract": "Compra",
    "address": {
        "state": "SC",
        "zipcode": "88015-600",
        "city": "Florianópolis",
        "district": "Centro",
        "street": "Bocaiúva",
        "street_number": "120",
        "street_type": "Rua",
        "reference": "Próximo ao mercado",
        "complement": "Apto 302",
        "block": "Torre B",
        "latitude": "-27.593500",
        "longitude": "-48.548500"
    },
    "detail": {
        "exclusividade": false,
        "lancamento": false,
        "permuta": false,
        "seguro_fianca": true,
        "fiador": true,
        "caucao": false,
        "titulo_capitalizacao": false,
        "entrega_ano": 2027,
        "entrega_mes": 3,
        "dormitorios": 2,
        "suites": 1,
        "banheiros": 2,
        "garagens": 1,
        "financiavel": 1,
        "ano_construcao": 2019,
        "area_total": 120,
        "area_privativa": 88,
        "area_util": 95,
        "terreno_comprimento": 30,
        "terreno_largura": 12,
        "numero_pessoas": 6,
        "distancia_mar": 500,
        "nro_matricula": 123456,
        "nro_iptu": 987654,
        "nro_medidor_energia": 12345,
        "nro_medidor_agua": 67890,
        "nro_medidor_gas": 11223,
        "andares": 2,
        "area_escritorio": 30,
        "area_laje": 60,
        "area_mezanino": 25,
        "closet": 1,
        "hidro_suite": 1,
        "living_ambientes": 2,
        "salas": 1,
        "tipo_construcao": "Alvenaria",
        "garagem_tipo": "Coberta",
        "garagem_numero_box": "12",
        "ocupacao": "Desocupado",
        "topografia": "Plano",
        "posicao": "Frente",
        "posicao_solar": "Norte",
        "andar_do_apto": "3",
        "estado_conservacao_imovel": "Novo",
        "formatodo_galpao": "Modular",
        "pe_direito_alto": "Não",
        "piso": "Porcelanato",
        "piso_area_intima": "Madeira",
        "piso_dormitorio": "Vinílico",
        "piso_sala": "Laminado",
        "caracteristicas": [
            "Piscina",
            "Churrasqueira",
            "Academia"
        ]
    },
    "listing": {
        "title": "Apartamento 2 dormitórios no Centro",
        "description": "Apartamento reformado, a duas quadras do mar.",
        "tour360": "https://tour.exemplo.com/ap-2-dorm",
        "price": {
            "price_sale": 450000,
            "price_rental": 2500,
            "price_realty_cluster": 680,
            "price_iptu": 120,
            "price_cleaning_fee": 250
        },
        "display_on_site": true
    }
}'

Responses

🟢200
application/json
Imóvel atualizado.
Bodyapplication/json

Example
{
    "partner_code": "AP-1024",
    "property_id": 1547,
    "code": "SC1547"
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴500
Modified at 2026-08-20 16:06:11
Previous
Cadastrar imóvel
Next
Cadastrar imóveis em lote
Built with