Cadastro Nacional de Obras

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "document": {
      "type": "string",
      "pattern": "^(?:[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
      "description": "CNPJ completo, com ou sem pontuação.",
      "title": "CNPJ"
    }
  },
  "required": [
    "document"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "document": "19131243000197"
    }
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "const": "list",
      "description": "Coleção de objetos Base39."
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "construction_work",
            "description": "Tipo do objeto Base39."
          },
          "number": {
            "type": "string",
            "minLength": 1,
            "description": "Número do Cadastro Nacional de Obras."
          },
          "name": {
            "type": "string",
            "description": "Nome informado no cadastro."
          },
          "legal_name": {
            "type": "string",
            "description": "Nome empresarial relacionado à obra."
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Data de início."
          },
          "responsibility_start_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Data de início da responsabilidade pela obra."
          },
          "registered_at": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Data do registro."
          },
          "status_date": {
            "type": "string",
            "format": "date",
            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
            "description": "Data da situação cadastral."
          },
          "city_code": {
            "type": "string",
            "description": "Código do município."
          },
          "area_unit": {
            "type": "string",
            "description": "Unidade de medida da área."
          },
          "total_area": {
            "type": "string",
            "pattern": "^-?\\d+(?:\\.\\d+)?$",
            "description": "Área total informada, como texto decimal."
          },
          "linked_work_number": {
            "type": "string",
            "description": "Número da obra vinculada."
          },
          "country_code": {
            "type": "string",
            "description": "Código do país."
          },
          "responsible_qualification": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string",
                "const": "code_description",
                "description": "Tipo do objeto Base39."
              },
              "code": {
                "type": "string",
                "description": "Código de identificação."
              },
              "description": {
                "type": "string",
                "description": "Descrição informada."
              }
            },
            "required": [
              "object"
            ],
            "additionalProperties": false,
            "description": "Qualificação do responsável pela obra."
          },
          "location_code": {
            "type": "string",
            "description": "Código de localização."
          },
          "address": {
            "type": "object",
            "properties": {
              "street": {
                "type": "string",
                "description": "Logradouro."
              },
              "street_type": {
                "type": "string",
                "description": "Tipo de logradouro."
              },
              "number": {
                "type": "string",
                "description": "Número do endereço."
              },
              "complement": {
                "type": "string",
                "description": "Complemento do endereço."
              },
              "neighborhood": {
                "type": "string",
                "description": "Bairro."
              },
              "postal_code": {
                "type": "string",
                "description": "Código postal."
              },
              "city": {
                "type": "string",
                "description": "Município."
              },
              "state": {
                "type": "string",
                "description": "Unidade federativa."
              },
              "country": {
                "type": "string",
                "description": "País informado pela fonte."
              },
              "active": {
                "type": "boolean",
                "description": "Indica se o endereço está ativo na fonte."
              }
            },
            "additionalProperties": false,
            "description": "Endereço da obra."
          },
          "status": {
            "type": "string",
            "description": "Situação informada."
          },
          "status_code": {
            "type": "string",
            "description": "Código da situação cadastral da obra."
          }
        },
        "required": [
          "object",
          "number"
        ],
        "additionalProperties": false
      },
      "description": "Objetos da coleção."
    },
    "next_cursor": {
      "description": "Cursor opaco da próxima página; ausente ao final.",
      "type": "string"
    },
    "document": {
      "type": "string",
      "minLength": 1,
      "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
    },
    "updated_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      "description": "Data e hora da última atualização publicada, em ISO 8601."
    }
  },
  "required": [
    "object",
    "data",
    "document"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "object": "list",
      "data": [
        {
          "object": "construction_work",
          "number": "123456789012",
          "name": "Obra de teste",
          "legal_name": "Empresa de teste",
          "start_date": "2020-01-02",
          "area_unit": "m²",
          "total_area": "0.00",
          "responsible_qualification": {
            "object": "code_description",
            "code": "1",
            "description": "Responsável"
          },
          "address": {
            "postal_code": "01001000",
            "city": "São Paulo",
            "state": "SP"
          },
          "status": "Ativa",
          "status_code": "1"
        }
      ],
      "document": "19131243000197",
      "updated_at": "2026-11-01T00:00:00Z"
    }
  ]
}