Serasa

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "document": {
      "type": "string",
      "pattern": "^(?:\\d{11}|\\d{3}\\.\\d{3}\\.\\d{3}-\\d{2}|[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": "CPF ou CNPJ completo, com ou sem pontuação.",
      "title": "CPF ou CNPJ"
    },
    "state": {
      "title": "UF",
      "description": "Sigla da unidade federativa, com duas letras maiúsculas.",
      "type": "string",
      "pattern": "^[A-Z]{2}$"
    }
  },
  "required": [
    "document"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "document": "00000000000191"
    }
  ]
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "const": "list",
      "description": "Coleção de negativações."
    },
    "document": {
      "type": "string",
      "minLength": 1,
      "description": "CPF ou CNPJ informado pela fonte; pode estar mascarado."
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "const": "negative_record",
            "description": "Ocorrência de negativação."
          },
          "type": {
            "type": "string",
            "description": "Categoria da ocorrência."
          },
          "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 ocorrência, em YYYY-MM-DD."
          },
          "amount": {
            "type": "string",
            "pattern": "^-?\\d+(?:\\.\\d+)?$",
            "description": "Valor da ocorrência em reais, como texto decimal."
          },
          "modality": {
            "type": "string",
            "description": "Modalidade da dívida informada."
          },
          "contract": {
            "type": "string",
            "description": "Identificador do contrato da dívida informado."
          },
          "creditor": {
            "type": "string",
            "description": "Nome do credor informado."
          },
          "principal": {
            "type": "boolean",
            "description": "Indica se a pessoa consultada é a devedora principal."
          },
          "city": {
            "type": "string",
            "description": "Município da ocorrência."
          },
          "state": {
            "type": "string",
            "description": "Unidade federativa da ocorrência."
          },
          "notary": {
            "type": "string",
            "description": "Cartório informado para o protesto."
          },
          "disputed": {
            "type": "boolean",
            "description": "Indicação explícita de contestação da ocorrência."
          },
          "under_judgment": {
            "type": "boolean",
            "description": "Indicação explícita de discussão judicial."
          }
        },
        "required": [
          "object",
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Ocorrências disponibilizadas pela consulta."
    },
    "summary": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Categoria dos registros negativos."
          },
          "count": {
            "description": "Quantidade de ocorrências informada.",
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "amount": {
            "type": "string",
            "pattern": "^-?\\d+(?:\\.\\d+)?$",
            "description": "Montante em reais, como texto decimal, preservando a precisão informada."
          },
          "status": {
            "type": "string",
            "description": "Situação informada pela fonte."
          }
        },
        "required": [
          "type"
        ],
        "additionalProperties": false
      },
      "description": "Totais informados por categoria; podem existir sem detalhes individuais."
    }
  },
  "required": [
    "object",
    "document",
    "data",
    "summary"
  ],
  "additionalProperties": false,
  "examples": [
    {
      "object": "list",
      "document": "00000000000191",
      "data": [
        {
          "object": "negative_record",
          "type": "refin",
          "date": "2026-08-30",
          "amount": "105556.56",
          "modality": "CREDITO E FINANCIAMENTO-FINANCEIRA",
          "contract": "CONTRATO-EXEMPLO-001",
          "creditor": "Credor Exemplo",
          "principal": true
        },
        {
          "object": "negative_record",
          "type": "collection_records",
          "date": "2026-07-26",
          "amount": "12500",
          "modality": "DUPLIC DE VENDA MERCANTIL",
          "contract": "CONTRATO-EXEMPLO-001",
          "creditor": "Credor Exemplo",
          "principal": true,
          "under_judgment": false
        },
        {
          "object": "negative_record",
          "type": "collection_records",
          "date": "2026-07-26",
          "amount": "12500",
          "modality": "DUPLIC DE VENDA MERCANTIL",
          "contract": "CONTRATO-EXEMPLO-001",
          "creditor": "Credor Exemplo",
          "principal": true,
          "under_judgment": false
        }
      ],
      "summary": [
        {
          "type": "pefin",
          "count": 0,
          "amount": "0"
        },
        {
          "type": "refin",
          "count": 1,
          "amount": "105556.56"
        },
        {
          "type": "notary",
          "count": 0,
          "amount": "0"
        }
      ]
    }
  ]
}