API

Terrenos (Land Plots)

Gerenciar banco de terrenos, due diligence e certidões via API.

Terrenos (Land Plots)

Gerencie o banco de terrenos da sua incorporadora: cadastro, análise, due diligence, certidões e scoring por IA. O pipeline de terrenos acompanha todo o ciclo de vida desde a prospecção até a aquisição ou descarte.

Todos os endpoints requerem autenticação via API Key no header Authorization: Bearer sua_chave_aqui.

GET /v1/land-plots

Lista todos os terrenos da organização com suporte a paginação, filtros e ordenação.

Query Parameters

ParâmetroTipoPadrãoDescrição
pagenumber1Página atual
limitnumber20Itens por página (máx: 100)
statusstring-Filtrar por status único (ex: prospeccao)
statusesstring-Filtrar por múltiplos status separados por vírgula
sourcestring-Filtrar por origem (ex: corretor, indicacao)
prioritynumber-Filtrar por prioridade: 1, 2, 3 ou 4
searchstring-Buscar por nome, endereço ou nome do proprietário
sortstring-created_atCampo de ordenação (prefixo - para descendente)

Campos Ordenáveis

CampoDescrição
nameNome do terreno
total_area_m2Área total
asking_priceValor pedido
statusStatus no pipeline
created_atData de criação
owner_nameNome do proprietário
priorityPrioridade
capture_dateData de captação
ai_scoreScore de IA

Request

curl -X GET "https://api.octabuild.com.br/v1/land-plots?status=prospeccao&priority=2&sort=-asking_price&limit=10" \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Terreno Alphaville Granja Viana",
      "address": "Rod. Raposo Tavares, km 23",
      "street": "Rodovia Raposo Tavares",
      "number": "23000",
      "complement": "Lote 15",
      "neighborhood": "Granja Viana",
      "city": "Cotia",
      "state": "SP",
      "zip_code": "06708-000",
      "latitude": -23.5868,
      "longitude": -46.8578,
      "google_maps_link": "https://maps.google.com/?q=-23.5868,-46.8578",
      "registration_number": "12345",
      "registry_office": "1o Cartório de Registro de Imóveis de Cotia",
      "judicial_district": "Cotia",
      "total_area_m2": 15000.00,
      "zoning": "ZR2",
      "floor_area_ratio": 2.5,
      "max_floors": 8,
      "boundaries": "Norte: Rua A; Sul: Rua B; Leste: Lote 14; Oeste: Lote 16",
      "owner_name": "Espólio de José da Silva",
      "owner_document": "123.456.789-00",
      "asking_price": 8500000.00,
      "appraisal_value": 7200000.00,
      "acquisition_value": null,
      "source": "corretor",
      "status": "prospeccao",
      "priority": 2,
      "ai_score": 78.5,
      "registration_link": "https://storage.example.com/matricula.pdf",
      "topography_link": null,
      "survey_link": null,
      "notes": "Terreno com boa topografia, próximo à estação de trem.",
      "broker_name": "Carlos Mendes",
      "broker_phone": "+55 11 98765-4321",
      "capture_date": "2026-02-10",
      "discard_reason": null,
      "deal_type_id": "uuid-tipo-negocio",
      "deal_type": {
        "id": "uuid-tipo-negocio",
        "name": "Compra e Venda"
      },
      "developments": [
        { "id": "uuid-emp-1", "name": "Residencial Granja Viana" }
      ],
      "created_at": "2026-02-10T14:30:00Z",
      "updated_at": "2026-02-20T09:15:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "pages": 5
  }
}

POST /v1/land-plots

Cadastra um novo terreno no banco de terrenos.

Request Body

CampoTipoObrigatórioDescrição
namestringSimNome identificador do terreno
addressstringNãoEndereço completo (texto livre)
streetstringNãoLogradouro
numberstringNãoNúmero
complementstringNãoComplemento
neighborhoodstringNãoBairro
citystringNãoCidade
statestringNãoUF (2 letras)
zip_codestringNãoCEP
latitudenumberNãoLatitude (decimal)
longitudenumberNãoLongitude (decimal)
google_maps_linkstringNãoLink do Google Maps
registration_numberstringNãoNúmero da matrícula
registry_officestringNãoCartório de registro
judicial_districtstringNãoComarca
total_area_m2numberNãoÁrea total em m²
zoningstringNãoZoneamento (ex: ZR2, ZM)
floor_area_rationumberNãoCoeficiente de aproveitamento
max_floorsnumberNãoGabarito máximo de pavimentos
boundariesstringNãoConfrontações
owner_namestringNãoNome do proprietário
owner_documentstringNãoCPF/CNPJ do proprietário
asking_pricenumberNãoValor pedido (R$)
appraisal_valuenumberNãoValor de avaliação (R$)
acquisition_valuenumberNãoValor de aquisição (R$)
sourcestringNãoOrigem (ex: corretor, indicacao, site)
statusstringNãoStatus no pipeline (padrão: prospeccao)
prioritynumberNãoPrioridade: 1 a 4
registration_linkstringNãoURL do arquivo da matrícula
topography_linkstringNãoURL do levantamento topográfico
survey_linkstringNãoURL da sondagem
notesstringNãoObservações
broker_namestringNãoNome do corretor
broker_phonestringNãoTelefone do corretor
capture_datestringNãoData de captação (YYYY-MM-DD)
discard_reasonstringNãoMotivo de descarte
deal_type_idstringNãoID do tipo de negócio

Request

curl -X POST https://api.octabuild.com.br/v1/land-plots \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Terreno Vila Madalena",
    "address": "Rua Harmonia, 250 - Vila Madalena, São Paulo/SP",
    "street": "Rua Harmonia",
    "number": "250",
    "neighborhood": "Vila Madalena",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "05435-000",
    "latitude": -23.5456,
    "longitude": -46.6913,
    "total_area_m2": 2400.00,
    "zoning": "ZM",
    "floor_area_ratio": 4.0,
    "max_floors": 15,
    "owner_name": "Maria Aparecida Santos",
    "owner_document": "987.654.321-00",
    "asking_price": 12000000.00,
    "source": "corretor",
    "status": "prospeccao",
    "priority": 2,
    "broker_name": "Roberto Lima",
    "broker_phone": "+55 11 91234-5678",
    "capture_date": "2026-02-25",
    "notes": "Esquina com a Rua Fidalga, alta visibilidade."
  }'

Response

{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Terreno Vila Madalena",
    "address": "Rua Harmonia, 250 - Vila Madalena, São Paulo/SP",
    "street": "Rua Harmonia",
    "number": "250",
    "complement": null,
    "neighborhood": "Vila Madalena",
    "city": "São Paulo",
    "state": "SP",
    "zip_code": "05435-000",
    "latitude": -23.5456,
    "longitude": -46.6913,
    "google_maps_link": null,
    "registration_number": null,
    "registry_office": null,
    "judicial_district": null,
    "total_area_m2": 2400.00,
    "zoning": "ZM",
    "floor_area_ratio": 4.0,
    "max_floors": 15,
    "boundaries": null,
    "owner_name": "Maria Aparecida Santos",
    "owner_document": "987.654.321-00",
    "asking_price": 12000000.00,
    "appraisal_value": null,
    "acquisition_value": null,
    "source": "corretor",
    "status": "prospeccao",
    "priority": 2,
    "ai_score": null,
    "registration_link": null,
    "topography_link": null,
    "survey_link": null,
    "notes": "Esquina com a Rua Fidalga, alta visibilidade.",
    "broker_name": "Roberto Lima",
    "broker_phone": "+55 11 91234-5678",
    "capture_date": "2026-02-25",
    "discard_reason": null,
    "deal_type_id": null,
    "deal_type": null,
    "created_at": "2026-02-25T10:30:00Z",
    "updated_at": "2026-02-25T10:30:00Z"
  }
}

GET /v1/land-plots/:id

Busca um terreno específico com seus dados completos, incluindo certidões e empreendimentos vinculados.

Request

curl -X GET https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Terreno Alphaville Granja Viana",
    "address": "Rod. Raposo Tavares, km 23",
    "street": "Rodovia Raposo Tavares",
    "number": "23000",
    "complement": "Lote 15",
    "neighborhood": "Granja Viana",
    "city": "Cotia",
    "state": "SP",
    "zip_code": "06708-000",
    "latitude": -23.5868,
    "longitude": -46.8578,
    "google_maps_link": "https://maps.google.com/?q=-23.5868,-46.8578",
    "registration_number": "12345",
    "registry_office": "1o Cartório de Registro de Imóveis de Cotia",
    "judicial_district": "Cotia",
    "total_area_m2": 15000.00,
    "zoning": "ZR2",
    "floor_area_ratio": 2.5,
    "max_floors": 8,
    "boundaries": "Norte: Rua A; Sul: Rua B; Leste: Lote 14; Oeste: Lote 16",
    "owner_name": "Espólio de José da Silva",
    "owner_document": "123.456.789-00",
    "asking_price": 8500000.00,
    "appraisal_value": 7200000.00,
    "acquisition_value": null,
    "source": "corretor",
    "status": "analise_preliminar",
    "priority": 2,
    "ai_score": 78.5,
    "registration_link": "https://storage.example.com/matricula.pdf",
    "topography_link": null,
    "survey_link": null,
    "notes": "Terreno com boa topografia, próximo à estação de trem.",
    "broker_name": "Carlos Mendes",
    "broker_phone": "+55 11 98765-4321",
    "capture_date": "2026-02-10",
    "discard_reason": null,
    "deal_type_id": "uuid-tipo-negocio",
    "deal_type": {
      "id": "uuid-tipo-negocio",
      "name": "Compra e Venda"
    },
    "developments": [
      { "id": "uuid-emp-1", "name": "Residencial Granja Viana" }
    ],
    "certificates": [
      {
        "id": "cert-uuid-001",
        "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
        "type": "Certidão de Ônus Reais",
        "issuing_authority": "1o CRI de Cotia",
        "status": "obtida",
        "issued_at": "2026-02-12",
        "expires_at": "2026-05-12",
        "file_url": "https://storage.example.com/certidao-onus.pdf",
        "notes": null,
        "created_at": "2026-02-12T11:00:00Z",
        "updated_at": "2026-02-12T11:00:00Z"
      }
    ],
    "created_at": "2026-02-10T14:30:00Z",
    "updated_at": "2026-02-20T09:15:00Z"
  }
}

PUT /v1/land-plots/:id

Atualiza parcialmente um terreno existente. Envie apenas os campos que deseja alterar.

Request

curl -X PUT https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "negociacao",
    "appraisal_value": 7800000.00,
    "priority": 1,
    "notes": "Proprietário aceitou negociar. Agendar visita técnica."
  }'

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Terreno Alphaville Granja Viana",
    "status": "negociacao",
    "appraisal_value": 7800000.00,
    "priority": 1,
    "notes": "Proprietário aceitou negociar. Agendar visita técnica.",
    "deal_type": {
      "id": "uuid-tipo-negocio",
      "name": "Compra e Venda"
    },
    "updated_at": "2026-02-25T15:00:00Z"
  }
}

DELETE /v1/land-plots/:id

Remove permanentemente um terreno.

Esta operação é irreversível. Terrenos com empreendimentos vinculados podem gerar erros de integridade referencial. Considere alterar o status para descartado em vez de deletar.

Request

curl -X DELETE https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "deleted": true
  }
}

GET /v1/land-plots/:id/due-diligence

Lista todos os itens de due diligence de um terreno, ordenados por ordem, categoria e data de criação.

Request

curl -X GET https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/due-diligence \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "dd-uuid-001",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Certidão de Matrícula Atualizada",
      "category": "juridica",
      "subcategory": "documentacao",
      "status": "concluido",
      "priority": "alta",
      "responsible": "Dr. Fernando Alves",
      "notes": "Matrícula sem ônus ou gravames.",
      "completed_at": "2026-02-15T10:00:00Z",
      "deadline": "2026-02-20",
      "file_url": "https://storage.example.com/matricula-atualizada.pdf",
      "file_name": "matricula-atualizada.pdf",
      "assessment": "verde",
      "assessment_justification": "Imóvel livre e desembaraçado.",
      "estimated_cost": 150.00,
      "order": 1,
      "created_at": "2026-02-10T14:30:00Z",
      "updated_at": "2026-02-15T10:00:00Z"
    },
    {
      "id": "dd-uuid-002",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Laudo Ambiental",
      "category": "ambiental",
      "subcategory": "analise_solo",
      "status": "em_andamento",
      "priority": "alta",
      "responsible": "Eng. Ana Paula Costa",
      "notes": "Aguardando resultado da análise de solo.",
      "completed_at": null,
      "deadline": "2026-03-15",
      "file_url": null,
      "file_name": null,
      "assessment": null,
      "assessment_justification": null,
      "estimated_cost": 8500.00,
      "order": 2,
      "created_at": "2026-02-10T14:35:00Z",
      "updated_at": "2026-02-22T08:00:00Z"
    },
    {
      "id": "dd-uuid-003",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Viabilidade Urbanística",
      "category": "urbanistica",
      "subcategory": "zoneamento",
      "status": "pendente",
      "priority": "media",
      "responsible": null,
      "notes": null,
      "completed_at": null,
      "deadline": "2026-03-30",
      "file_url": null,
      "file_name": null,
      "assessment": null,
      "assessment_justification": null,
      "estimated_cost": 3000.00,
      "order": 3,
      "created_at": "2026-02-10T14:40:00Z",
      "updated_at": "2026-02-10T14:40:00Z"
    }
  ]
}

POST /v1/land-plots/:id/due-diligence

Cria um novo item de due diligence para um terreno.

Request Body

CampoTipoObrigatórioDescrição
namestringSimNome do item de due diligence
categorystringNãoCategoria: juridica, ambiental, urbanistica, tecnica
subcategorystringNãoSubcategoria livre
statusstringNãoStatus: pendente, em_andamento, concluido, nao_aplicavel
prioritystringNãoPrioridade: alta, media, baixa
responsiblestringNãoNome do responsável
notesstringNãoObservações
completed_atstringNãoData de conclusão (ISO 8601)
deadlinestringNãoPrazo limite (YYYY-MM-DD)
file_urlstringNãoURL do arquivo anexo
file_namestringNãoNome do arquivo
assessmentstringNãoParecer: verde, amarelo, vermelho
assessment_justificationstringNãoJustificativa do parecer
estimated_costnumberNãoCusto estimado (R$)
ordernumberNãoOrdem de exibição

Request

curl -X POST https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/due-diligence \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Análise de Passivos Trabalhistas",
    "category": "juridica",
    "subcategory": "passivos",
    "status": "pendente",
    "priority": "media",
    "responsible": "Dr. Fernando Alves",
    "deadline": "2026-03-20",
    "estimated_cost": 2500.00,
    "order": 4
  }'

Response

{
  "success": true,
  "data": {
    "id": "dd-uuid-004",
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Análise de Passivos Trabalhistas",
    "category": "juridica",
    "subcategory": "passivos",
    "status": "pendente",
    "priority": "media",
    "responsible": "Dr. Fernando Alves",
    "notes": null,
    "completed_at": null,
    "deadline": "2026-03-20",
    "file_url": null,
    "file_name": null,
    "assessment": null,
    "assessment_justification": null,
    "estimated_cost": 2500.00,
    "order": 4,
    "created_at": "2026-02-25T11:00:00Z",
    "updated_at": "2026-02-25T11:00:00Z"
  }
}

GET /v1/land-plots/:id/certificates

Lista todas as certidões de um terreno, ordenadas pela mais recente.

Request

curl -X GET https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/certificates \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "cert-uuid-001",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "Certidão de Ônus Reais",
      "issuing_authority": "1o CRI de Cotia",
      "status": "obtida",
      "issued_at": "2026-02-12",
      "expires_at": "2026-05-12",
      "file_url": "https://storage.example.com/certidao-onus.pdf",
      "notes": null,
      "created_at": "2026-02-12T11:00:00Z",
      "updated_at": "2026-02-12T11:00:00Z"
    },
    {
      "id": "cert-uuid-002",
      "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "Certidão Negativa de Débitos Municipais",
      "issuing_authority": "Prefeitura Municipal de Cotia",
      "status": "pendente",
      "issued_at": null,
      "expires_at": null,
      "file_url": null,
      "notes": "Solicitada em 20/02/2026, prazo de 10 dias úteis.",
      "created_at": "2026-02-20T09:00:00Z",
      "updated_at": "2026-02-20T09:00:00Z"
    }
  ]
}

POST /v1/land-plots/:id/certificates

Cria uma nova certidão vinculada a um terreno.

Request Body

CampoTipoObrigatórioDescrição
typestringSimTipo da certidão (ex: Certidão de Ônus Reais)
issuing_authoritystringNãoÓrgão emissor
statusstringNãoStatus: pendente, obtida, vencida
issued_atstringNãoData de emissão (YYYY-MM-DD)
expires_atstringNãoData de validade (YYYY-MM-DD)
file_urlstringNãoURL do arquivo da certidão
notesstringNãoObservações

Request

curl -X POST https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/certificates \
  -H "Authorization: Bearer ea_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "Certidão Negativa de Débitos Trabalhistas",
    "issuing_authority": "Tribunal Superior do Trabalho",
    "status": "obtida",
    "issued_at": "2026-02-20",
    "expires_at": "2026-08-20",
    "file_url": "https://storage.example.com/cndt.pdf",
    "notes": "CNDT válida por 180 dias."
  }'

Response

{
  "success": true,
  "data": {
    "id": "cert-uuid-003",
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "type": "Certidão Negativa de Débitos Trabalhistas",
    "issuing_authority": "Tribunal Superior do Trabalho",
    "status": "obtida",
    "issued_at": "2026-02-20",
    "expires_at": "2026-08-20",
    "file_url": "https://storage.example.com/cndt.pdf",
    "notes": "CNDT válida por 180 dias.",
    "created_at": "2026-02-25T11:30:00Z",
    "updated_at": "2026-02-25T11:30:00Z"
  }
}

POST /v1/land-plots/:id/score

Recalcula o score de IA de um terreno com base nos dados cadastrados. O score é atualizado automaticamente no registro do terreno.

O score de IA avalia automaticamente o potencial do terreno considerando localização, zoneamento, área, valores e outros fatores. O resultado é um valor de 0 a 100 com detalhamento por categoria.

Request

curl -X POST https://api.octabuild.com.br/v1/land-plots/550e8400-e29b-41d4-a716-446655440000/score \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "land_plot_id": "550e8400-e29b-41d4-a716-446655440000",
    "score": 78.5,
    "breakdown": {
      "total": 78.5,
      "localizacao": 85,
      "zoneamento": 90,
      "area": 70,
      "valor": 65,
      "documentacao": 75,
      "topografia": 80
    }
  }
}

GET /v1/land-plots/stats

Retorna estatísticas agregadas do pipeline de terrenos: totais por status, por origem, score médio, valor do pipeline e novos cadastros recentes.

Request

curl -X GET https://api.octabuild.com.br/v1/land-plots/stats \
  -H "Authorization: Bearer ea_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "total": 47,
    "by_status": {
      "prospeccao": 18,
      "analise_preliminar": 10,
      "estudo_massa": 5,
      "negociacao": 6,
      "due_diligence": 3,
      "aprovado": 2,
      "adquirido": 1,
      "descartado": 2
    },
    "by_source": {
      "corretor": 22,
      "indicacao": 12,
      "site": 8,
      "prospecao_ativa": 5
    },
    "average_score": 62.35,
    "pipeline_value": 185000000.00,
    "new_last_7_days": 4
  }
}

O campo pipeline_value soma o asking_price apenas dos terrenos nos status de prospecção ativa: prospeccao, analise_preliminar, estudo_massa, negociacao e due_diligence.

Referência de Status

StatusDescriçãoEtapa
prospeccaoTerreno identificado, aguardando análise inicialCaptação
analise_preliminarPrimeira análise de viabilidade em andamentoAnálise
estudo_massaEstudo de massa e viabilidade técnicaAnálise
negociacaoEm negociação com proprietárioNegociação
due_diligenceProcesso de due diligence em andamentoJurídico
aprovadoAprovado pela diretoria para aquisiçãoAprovação
adquiridoTerreno adquirido com sucessoConcluído
descartadoDescartado (informar discard_reason)Encerrado

Referência de Prioridade

ValorNívelDescrição
1UrgenteRequer ação imediata
2AltaAlta prioridade de análise
3NormalPrioridade padrão
4BaixaBaixa prioridade

Categorias de Due Diligence

CategoriaDescrição
juridicaAnálise jurídica (matrícula, ônus, passivos)
ambientalAnálise ambiental (solo, contaminação, licenças)
urbanisticaAnálise urbanística (zoneamento, gabarito, recuos)
tecnicaAnálise técnica (topografia, sondagem, fundação)

Status de Due Diligence

StatusDescrição
pendenteAinda não iniciado
em_andamentoEm execução
concluidoFinalizado
nao_aplicavelNão se aplica a este terreno

Pareceres de Due Diligence

ParecerSignificado
verdeSem restrições ou riscos identificados
amareloRestrições parciais ou riscos mitigáveis
vermelhoRestrições graves ou riscos elevados

Status de Certidões

StatusDescrição
pendenteCertidão solicitada, aguardando emissão
obtidaCertidão emitida e válida
vencidaCertidão com prazo de validade expirado

Erros Comuns

CódigoErroSolução
400VALIDATION_ERROR - Invalid JSON bodyVerifique se o corpo da requisição é um JSON válido
400VALIDATION_ERROR - Field 'name' is requiredO campo name é obrigatório ao criar terrenos
400VALIDATION_ERROR - Field 'type' is requiredO campo type é obrigatório ao criar certidões
404NOT_FOUND - Land plot not foundO terreno não existe ou não pertence à sua organização
401UNAUTHORIZEDAPI Key ausente ou inválida
403FORBIDDENSem permissão para acessar este recurso
500QUERY_ERRORErro interno ao consultar dados
500INSERT_ERRORErro interno ao inserir registro
500UPDATE_ERRORErro interno ao atualizar registro
500DELETE_ERRORErro interno ao deletar registro
500SCORE_ERROR - Failed to calculate scoreErro ao calcular o score de IA

Referência da API

Documentação completa de todos os endpoints da API OctaBuild.

Empreendimentos

Criar e gerenciar empreendimentos imobiliarios, blocos e tipologias via API.

On this page

Terrenos (Land Plots)GET /v1/land-plotsQuery ParametersCampos OrdenáveisRequestResponsePOST /v1/land-plotsRequest BodyRequestResponseGET /v1/land-plots/:idRequestResponsePUT /v1/land-plots/:idRequestResponseDELETE /v1/land-plots/:idRequestResponseGET /v1/land-plots/:id/due-diligenceRequestResponsePOST /v1/land-plots/:id/due-diligenceRequest BodyRequestResponseGET /v1/land-plots/:id/certificatesRequestResponsePOST /v1/land-plots/:id/certificatesRequest BodyRequestResponsePOST /v1/land-plots/:id/scoreRequestResponseGET /v1/land-plots/statsRequestResponseReferência de StatusReferência de PrioridadeCategorias de Due DiligenceStatus de Due DiligencePareceres de Due DiligenceStatus de CertidõesErros Comuns