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

Listar imóveis

GET
/v1/properties
Lista os imóveis da conta, ordenados por updated_at decrescente, com desempate estável.

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 Consulta

Respostas

🟢200
application/json
Default Response
Bodyapplication/json

🟠400
🟠401
🟠403
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.veploy.com/v1/properties?page=undefined&per_page=undefined&status=active&ref=undefined&q=undefined&source=undefined&kind=unit&type=apartamento&transaction_type=undefined&purpose=residential&city=undefined&state=undefined&neighborhood=undefined&sale_price_min=undefined&sale_price_max=undefined&rental_price_min=undefined&rental_price_max=undefined&bedrooms_min=undefined&bathrooms_min=undefined&suites_min=undefined&parkings_min=undefined&usable_area_min=undefined&usable_area_max=undefined&total_area_min=undefined&total_area_max=undefined&is_brand_new=undefined&is_network_listing=undefined&updated_after=undefined' \
--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"
        },
        {
            "id": "9c1e4f0a-2b3d-4c5e-9f6a-7b8c9d0e1f2a",
            "ref": "EMP0007",
            "status": "active",
            "source": null,
            "slug": "residencial-jardim-das-acacias-vila-mariana-sao-paulo-emp0007",
            "title": "Residencial Jardim das Acácias",
            "auto_title": false,
            "description": "Lançamento com unidades de 2 e 3 dormitórios, entrega prevista para 2028.",
            "type": {
                "slug": "apartamento",
                "name": "Apartamento"
            },
            "purpose": [
                "residential"
            ],
            "kind": "development",
            "is_brand_new": true,
            "exclusive": false,
            "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": "690000",
                        "max": "1250000"
                    },
                    "display": "from"
                },
                "rent": {
                    "enabled": false,
                    "price": {
                        "min": null,
                        "max": null
                    },
                    "display": "price"
                },
                "short_term": {
                    "enabled": false,
                    "price": {
                        "min": null,
                        "max": null
                    },
                    "display": "price"
                }
            },
            "condominium_fee": null,
            "property_tax": null,
            "location": {
                "country": "BR",
                "state": "SP",
                "city": "São Paulo",
                "neighborhood": "Vila Mariana",
                "value_zone": null,
                "street": "Rua Joaquim Távora",
                "number": "1180",
                "complement": null,
                "zipcode": "04015013",
                "in_condominium": false,
                "condominium": null,
                "unit": null,
                "lot": null,
                "latitude": -23.5847,
                "longitude": -46.6396,
                "map_display": "exact"
            },
            "year_built": null,
            "features": {
                "bedrooms": {
                    "min": 2,
                    "max": 3
                },
                "bathrooms": {
                    "min": 1,
                    "max": 2
                },
                "suites": {
                    "min": 0,
                    "max": 1
                },
                "rooms": {
                    "min": null,
                    "max": null
                },
                "parkings": {
                    "min": 1,
                    "max": 2
                },
                "usable_area": {
                    "min": 58,
                    "max": 94
                },
                "total_area": {
                    "min": null,
                    "max": null
                }
            },
            "amenities": {
                "unit": [],
                "condominium": [
                    "piscina",
                    "salao_de_festas",
                    "coworking",
                    "bicicletario"
                ]
            },
            "media": {
                "images": [
                    {
                        "id": "51007",
                        "url": "https://cdn.veploy.com/properties/emp0007/perspectiva.jpg",
                        "featured": true,
                        "alt": "Perspectiva ilustrada da fachada",
                        "position": 0
                    }
                ],
                "floor_plans": [
                    {
                        "id": "51008",
                        "url": "https://cdn.veploy.com/properties/emp0007/planta-58.jpg",
                        "title": "2 dormitórios, 58 m²"
                    },
                    {
                        "id": "51009",
                        "url": "https://cdn.veploy.com/properties/emp0007/planta-94.jpg",
                        "title": "3 dormitórios, 94 m²"
                    }
                ],
                "video": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                "virtual_tour": null
            },
            "agents": [],
            "owners": [],
            "published_at": "2026-08-01T10:00:00-03:00",
            "last_published_at": "2026-08-01T10:00:00-03:00",
            "created_at": "2026-07-28T15:20:00-03:00",
            "updated_at": "2026-09-03T08:05:00-03:00"
        },
        {
            "id": "5e7d9c2b-8a1f-4b3c-a6d4-2f1e0c9b8a7d",
            "ref": "TE0311",
            "status": "active",
            "source": null,
            "slug": "terreno-riviera-de-sao-lourenco-bertioga-te0311",
            "title": "Terreno de 450 m² no Módulo 26",
            "auto_title": true,
            "description": "Lote plano, esquina, a 300 m da praia.",
            "type": {
                "slug": "terreno",
                "name": "Terreno"
            },
            "purpose": [
                "residential"
            ],
            "kind": "unit",
            "is_brand_new": false,
            "exclusive": false,
            "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": "1900000",
                        "max": "1900000"
                    },
                    "display": "on_request"
                },
                "rent": {
                    "enabled": false,
                    "price": {
                        "min": null,
                        "max": null
                    },
                    "display": "price"
                },
                "short_term": {
                    "enabled": false,
                    "price": {
                        "min": null,
                        "max": null
                    },
                    "display": "price"
                }
            },
            "condominium_fee": null,
            "property_tax": null,
            "location": {
                "country": "BR",
                "state": "SP",
                "city": "Bertioga",
                "neighborhood": "Riviera de São Lourenço",
                "value_zone": null,
                "street": "Alameda das Jabuticabas",
                "number": "s/n",
                "complement": null,
                "zipcode": "11250000",
                "in_condominium": true,
                "condominium": null,
                "unit": null,
                "lot": {
                    "sector": "26",
                    "block": "F",
                    "number": "1"
                },
                "latitude": -23.7936,
                "longitude": -46.0021,
                "map_display": "approx"
            },
            "year_built": null,
            "features": {
                "bedrooms": {
                    "min": null,
                    "max": null
                },
                "bathrooms": {
                    "min": null,
                    "max": null
                },
                "suites": {
                    "min": null,
                    "max": null
                },
                "rooms": {
                    "min": null,
                    "max": null
                },
                "parkings": {
                    "min": null,
                    "max": null
                },
                "usable_area": {
                    "min": null,
                    "max": null
                },
                "total_area": {
                    "min": 450,
                    "max": 450
                }
            },
            "amenities": {
                "unit": [],
                "condominium": [
                    "portaria_24h",
                    "praia"
                ]
            },
            "media": {
                "images": [
                    {
                        "id": "39920",
                        "url": "https://cdn.veploy.com/properties/te0311/lote.jpg",
                        "featured": true,
                        "alt": "Vista do lote a partir da alameda",
                        "position": 0
                    }
                ],
                "floor_plans": [],
                "video": null,
                "virtual_tour": null
            },
            "agents": [
                {
                    "id": "3f8a2b1c-5d6e-4f7a-9b8c-1d2e3f4a5b6c",
                    "role": "acquisition",
                    "transaction_types": [
                        "sale"
                    ]
                }
            ],
            "owners": [],
            "published_at": "2026-03-18T09:00:00-03:00",
            "last_published_at": "2026-03-18T09:00:00-03:00",
            "created_at": "2026-03-17T17:41:00-03:00",
            "updated_at": "2026-08-22T12:10:00-03:00"
        }
    ],
    "meta": {
        "pagination": {
            "page": 1,
            "per_page": 50,
            "count": 3,
            "total": 128,
            "total_pages": 3,
            "has_next": true,
            "has_previous": false
        }
    },
    "links": {
        "self": "https://api.veploy.com/v1/properties?page=1&per_page=50",
        "first": "https://api.veploy.com/v1/properties?page=1&per_page=50",
        "previous": null,
        "next": "https://api.veploy.com/v1/properties?page=2&per_page=50",
        "last": "https://api.veploy.com/v1/properties?page=3&per_page=50"
    }
}
Modificado em 2026-11-12 20:09:23
Página anterior
Limites de requisição
Próxima página
Consultar imóvel
Built with