{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/luniumpay-com/json-schema/luniumpay-com-titular-pix-schema.json",
  "title": "TitularPix",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/luniumpay-com-pix-api-openapi.yml#/components/schemas/TitularPix",
  "type": "object",
  "required": [
    "pix_key",
    "pix_key_type",
    "owner_name",
    "verified",
    "source",
    "checked_at"
  ],
  "properties": {
    "pix_key": {
      "type": "string",
      "description": "A chave, normalizada (telefone em +55…)."
    },
    "pix_key_type": {
      "type": "string",
      "enum": [
        "cpf",
        "cnpj",
        "phone",
        "email",
        "random"
      ],
      "description": "Tipo da chave consultada: \"cpf\", \"cnpj\", \"phone\", \"email\" ou \"random\"."
    },
    "owner_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do titular, como está no DICT."
    },
    "owner_tax_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF/CNPJ MASCARADO. Nunca vem inteiro."
    },
    "institution_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Instituição onde a chave está registrada."
    },
    "ispb": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISPB da instituição (8 dígitos)."
    },
    "verified": {
      "type": "boolean",
      "description": "true quando titular foi consultado ou simulado (source=sandbox); false quando não verificado."
    },
    "source": {
      "type": "string",
      "enum": [
        "dict",
        "sandbox",
        "disabled"
      ]
    },
    "checked_at": {
      "type": "string",
      "format": "date-time"
    },
    "cached": {
      "type": "boolean",
      "description": "true quando a resposta veio do cache de 24h."
    },
    "sandbox": {
      "type": "boolean",
      "description": "Só em chave de teste: titular fictício."
    },
    "available": {
      "type": "boolean",
      "description": "false quando consulta está indisponível; pode vir com HTTP 200."
    },
    "optional": {
      "type": "boolean",
      "description": "Consulta é auxiliar; não é um requisito de pagamento."
    },
    "verification_status": {
      "type": "string",
      "description": "not_performed quando a verificação não foi executada."
    },
    "detail": {
      "type": "string"
    }
  }
}