1. Imóveis
Veploy API
  • Visão geral
  • Autenticação
  • Limites de requisição
  • Imóveis
    • Listar imóveis
      GET
    • Consultar imóvel
      GET
    • Cadastrar imóvel
      POST
    • Alterar imóvel
      PATCH
    • Excluir imóvel
      DELETE
    • Restaurar imóvel
      POST
    • Enviar foto do imóvel (Beta)
      POST
    • Remover foto do imóvel (Beta)
      DELETE
    • Listar tipos de imóvel
      GET
  • Proprietários
    • Listar proprietários
    • Consultar proprietário
    • Cadastrar proprietário
    • Alterar proprietário
    • Excluir proprietário
  • Leads
    • Listar leads
    • Consultar lead
    • Criar lead
    • Alterar responsável
    • Atualizar lead
    • Consultar linha do tempo do lead
  • Visitas
    • Listar visitas
    • Consultar visita
    • Agendar visita
    • Alterar visita
  • Propostas
    • Listar propostas
    • Consultar proposta
    • Registrar proposta
    • Alterar proposta
  • Portais
    • Listar portais
    • Consultar portal
    • Listar imóveis do XML
  • Usuários
    • Listar usuários
    • Consultar usuário
    • Consultar permissões do usuário
    • Convidar usuário
    • Alterar ficha do usuário
    • Desativar usuário
    • Reativar usuário
    • Remover usuário
  • Perfis de acesso
    • Listar perfis de acesso
  • Artigos
    • Listar artigos
    • Criar artigo
    • Consultar artigo
    • Alterar artigo
    • Enviar capa do artigo (Beta)
  • Temas
    • Tema do site
  1. Imóveis

Consultar imóvel

GET
/v1/properties/{ref}
Retorna um imóvel pela referência comercial (ref).

Requisição

Authorization
Bearer Token
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
or
Parâmetros de Caminho

Respostas

🟢200
application/json
Default Response
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.veploy.com/v1/properties/' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Exemplo 1
{
    "data": {
        "id": "7d8f1a2b-3c4d-4e5f-8a9b-0c1d2e3f4a5b",
        "ref": "AP0042",
        "status": "active",
        "source": null,
        "slug": "apartamento-3-quartos-moema-sao-paulo-ap0042",
        "title": "Apartamento com 3 quartos à venda em Moema",
        "auto_title": true,
        "description": "Apartamento reformado em andar alto, com vista livre e varanda gourmet.",
        "type": {
            "slug": "apartamento",
            "name": "Apartamento"
        },
        "purpose": [
            "residential"
        ],
        "kind": "unit",
        "is_brand_new": false,
        "exclusive": true,
        "accepts_exchange": false,
        "is_network_listing": false,
        "portals_enabled": true,
        "site_enabled": true,
        "mcmv": false,
        "hidden_fields": [],
        "pricing": {
            "currency": "BRL",
            "sale": {
                "enabled": true,
                "price": {
                    "min": "980000",
                    "max": "980000"
                },
                "display": "price"
            },
            "rent": {
                "enabled": false,
                "price": {
                    "min": null,
                    "max": null
                },
                "display": "price"
            },
            "short_term": {
                "enabled": false,
                "price": {
                    "min": null,
                    "max": null
                },
                "display": "price"
            }
        },
        "condominium_fee": {
            "amount": "1450",
            "currency": "BRL",
            "frequency": "monthly",
            "display": "amount"
        },
        "property_tax": {
            "amount": "4200",
            "currency": "BRL",
            "frequency": "yearly",
            "display": "amount"
        },
        "location": {
            "country": "BR",
            "state": "SP",
            "city": "São Paulo",
            "neighborhood": "Moema",
            "value_zone": null,
            "street": "Alameda dos Arapanés",
            "number": "1000",
            "complement": null,
            "zipcode": "04524001",
            "in_condominium": true,
            "condominium": "Edifício Arapanés",
            "unit": {
                "tower": null,
                "floor": "12",
                "number": "121"
            },
            "lot": null,
            "latitude": -23.6045,
            "longitude": -46.6653,
            "map_display": "approx"
        },
        "year_built": 2012,
        "features": {
            "bedrooms": {
                "min": 3,
                "max": 3
            },
            "bathrooms": {
                "min": 2,
                "max": 2
            },
            "suites": {
                "min": 1,
                "max": 1
            },
            "rooms": {
                "min": null,
                "max": null
            },
            "parkings": {
                "min": 2,
                "max": 2
            },
            "usable_area": {
                "min": 96,
                "max": 96
            },
            "total_area": {
                "min": 128,
                "max": 128
            }
        },
        "amenities": {
            "unit": [
                "varanda_gourmet",
                "ar_condicionado"
            ],
            "condominium": [
                "piscina",
                "academia",
                "portaria_24h"
            ]
        },
        "media": {
            "images": [
                {
                    "id": "48213",
                    "url": "https://cdn.veploy.com/properties/ap0042/fachada.jpg",
                    "featured": true,
                    "alt": "Fachada do edifício",
                    "position": 0
                },
                {
                    "id": "48214",
                    "url": "https://cdn.veploy.com/properties/ap0042/sala.jpg",
                    "featured": false,
                    "alt": null,
                    "position": 1
                }
            ],
            "floor_plans": [
                {
                    "id": "48215",
                    "url": "https://cdn.veploy.com/properties/ap0042/planta.jpg",
                    "title": "Planta de 128 m²"
                }
            ],
            "video": null,
            "virtual_tour": null
        },
        "agents": [
            {
                "id": "3f8a2b1c-5d6e-4f7a-9b8c-1d2e3f4a5b6c",
                "role": "acquisition",
                "transaction_types": [
                    "sale"
                ]
            }
        ],
        "owners": [],
        "published_at": "2026-05-12T14:30:00-03:00",
        "last_published_at": "2026-08-30T09:12:00-03:00",
        "created_at": "2026-05-10T11:03:00-03:00",
        "updated_at": "2026-09-01T16:45:00-03:00"
    }
}
Modificado em 2026-11-04 18:08:49
Página anterior
Listar imóveis
Próxima página
Cadastrar imóvel
Built with