# Quod Consulta PF

Consulta Quod PF: dados cadastrais e participações societárias (QuodReport v2.1). Quod Score e Negativações, protestos e consultas disponíveis como módulos adicionais.

- **Identificador:** `pessoas/quod-consulta-pf`
- **Categoria:** Crédito, renda e birô
- **Audiência:** PF
- **Endpoint:** `POST /api/v1/{tenant}/pessoas/quod-consulta-pf`
- **Preço de tabela:** R$ 1,400 por consulta bem-sucedida
- **Página:** https://www.proteo.com.br/api/consultas/pessoas/quod-consulta-pf

## Quando usar

Descrição

O serviço Quod Consulta PF consulta a API QuodReport (v2.1) e retorna dados cadastrais enriquecidos (incluindo históricos de endereço, e-mail e telefone) e participações em empresas.

Módulos adicionais

Estes módulos só são retornados quando habilitados na configuração do serviço:

Quod Score: score de crédito do CPF consultado.

Negativações, protestos e consultas: negativações, protestos, ações judiciais, cheques sem fundo (CCF) e consultas ao CPF.

## Parâmetros (corpo JSON)

| Campo | Obrigatório | Descrição |
|---|---|---|
| `document` | sim | CPF da pessoa, com ou sem máscara. |

## Campos de retorno (`data`)

| Campo | Tipo |
|---|---|
| `QuodReportResponseEx.Response.Header.Status` | número |
| `QuodReportResponseEx.Response.Header.TransactionId` | texto |
| `QuodReportResponseEx.Response.Records.Record[].CPStatus` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Segment` | texto |
| `QuodReportResponseEx.Response.Records.Record[].HasOnlyMinimumPII` | booleano |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.CPF` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.CPFStatus` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.PersonName.DateLastSeen.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.PersonName.DateLastSeen.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.PersonName.DateLastSeen.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.PersonName.Name.Full` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.MotherName.Full` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.DOB.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.DOB.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.DOB.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Age` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Gender` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Address.Street` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Address.Number` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Address.City` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Address.State` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Address.PostalCode` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.Email.Email` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.PhoneNumber.PhoneNumber` | texto |
| `QuodReportResponseEx.Response.Records.Record[].BestInfo.MobilePhoneNumber.PhoneNumber` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].EntityType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].CNPJ` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].CompanyName` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].CNPJStatus` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].PercentParticipation` | texto |
| `QuodReportResponseEx.Response.Records.Record[].EnterpriseData.Partnerships.Partnership[].RelationshipDescription` | texto |
| `QuodReportResponseEx.Response.Records.Record[].QuodScore.Score` | número |
| `QuodReportResponseEx.Response.Records.Record[].QuodScore.Segment` | texto |
| `QuodReportResponseEx.Response.Records.Record[].HasNegativeData` | booleano |
| `QuodReportResponseEx.Response.Records.Record[].HasInquiryData` | booleano |
| `QuodReportResponseEx.Response.Records.Record[].Negative.DateLastApontamento.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.DateLastApontamento.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.DateLastApontamento.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.PendenciesControlCred` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].EntityType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].CpfCnpj` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].CNPJ` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].CompanyName` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Nature` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Amount` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].ContractNumber` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateOccurred.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateOccurred.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateOccurred.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].ParticipantType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].ApontamentoStatus` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateIncluded.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateIncluded.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateIncluded.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateModified.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateModified.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].DateModified.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.Street` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.Number` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.Complement` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.Neighborhood` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.City` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.State` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.Apontamentos.Apontamento[].Address.PostalCode` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].ProcessNumber` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].ProtocolNumber` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].Comarca` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].Forum` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].Vara` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].Name` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].DateDistribution.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].DateDistribution.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].DateDistribution.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].ProcessType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].CurrentStatus` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].AmountLawsuit` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].ProcessAuthor` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].City` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].State` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].JusticeType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.LawSuitApontamentos.LawSuitApontamento[].CpfCnpj` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].EntityType` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].CpfCnpj` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].ReportingCodeBank` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].ReportingNameBank` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].ReportingBranchPrefix` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].ReasonBounce` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].CountBounce` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].DateLastBounce.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].DateLastBounce.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Negative.CcfApontamentos.CcfApontamento[].DateLastBounce.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryCountLast30Days` | número |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryCountLast31to60Days` | número |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryCountLast61to90Days` | número |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryCountMore90Days` | número |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryDetails.InquiryDetail[].DateInquiry.Year` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryDetails.InquiryDetail[].DateInquiry.Month` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryDetails.InquiryDetail[].DateInquiry.Day` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryDetails.InquiryDetail[].InquiryCount` | número |
| `QuodReportResponseEx.Response.Records.Record[].Inquiries.InquiryDetails.InquiryDetail[].Segment` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].erro_descricao` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].situacao` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].valor_protestados_total` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].totalProtestos` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].codigo_cidade` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].codigo_cartorio` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].nome` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].telefone` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].endereco` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].uf` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].cidade` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].protestos` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].valor_protestado` | texto |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].listaprotestos.protestos[].data` | data |
| `QuodReportResponseEx.Response.Records.Record[].Protests.Protest[].conteudo.cartorio[].listaprotestos.protestos[].valor` | texto |

## Exemplo de resposta (valores fictícios)

```json
{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Quod Consulta PF",
  "query_slug": "quod-consulta-pf",
  "data": {
    "QuodReportResponseEx": {
      "Response": {
        "Header": {
          "Status": 0,
          "TransactionId": "texto"
        },
        "Records": {
          "Record": [
            {
              "CPStatus": "texto",
              "Segment": "texto",
              "HasOnlyMinimumPII": false,
              "BestInfo": {
                "CPF": "texto",
                "CPFStatus": "texto",
                "PersonName": {
                  "DateLastSeen": {
                    "Year": "texto",
                    "Month": "texto",
                    "Day": "texto"
                  },
                  "Name": {
                    "Full": "texto"
                  }
                },
                "MotherName": {
                  "Full": "texto"
                },
                "DOB": {
                  "Year": "texto",
                  "Month": "texto",
                  "Day": "texto"
                },
                "Age": "texto",
                "Gender": "texto",
                "Address": {
                  "Street": "texto",
                  "Number": "texto",
                  "City": "texto",
                  "State": "texto",
                  "PostalCode": "texto"
                },
                "Email": {
                  "Email": "texto"
                },
                "PhoneNumber": {
                  "PhoneNumber": "texto"
                },
                "MobilePhoneNumber": {
                  "PhoneNumber": "texto"
                }
              },
              "EnterpriseData": {
                "Partnerships": {
                  "Partnership": [
                    {
                      "EntityType": "texto",
                      "CNPJ": "texto",
                      "CompanyName": "texto",
                      "CNPJStatus": "texto",
                      "PercentParticipation": "texto",
                      "RelationshipDescription": "texto"
                    }
                  ]
                }
              },
              "QuodScore": {
                "Score": 0,
                "Segment": "texto"
              },
              "HasNegativeData": false,
              "HasInquiryData": false,
              "Negative": {
                "DateLastApontamento": {
                  "Year": "texto",
                  "Month": "texto",
                  "Day": "texto"
                },
                "PendenciesControlCred": "texto",
                "Apontamentos": {
                  "Apontamento": [
                    {
                      "EntityType": "texto",
                      "CpfCnpj": "texto",
                      "CNPJ": "texto",
                      "CompanyName": "texto",
                      "Nature": "texto",
                      "Amount": "texto",
                      "ContractNumber": "texto",
                      "DateOccurred": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      },
                      "ParticipantType": "texto",
                      "ApontamentoStatus": "texto",
                      "DateIncluded": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      },
                      "DateModified": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      },
                      "Address": {
                        "Street": "texto",
                        "Number": "texto",
                        "Complement": "texto",
                        "Neighborhood": "texto",
                        "City": "texto",
                        "State": "texto",
                        "PostalCode": "texto"
                      }
                    }
                  ]
                },
                "LawSuitApontamentos": {
                  "LawSuitApontamento": [
                    {
                      "ProcessNumber": "texto",
                      "ProtocolNumber": "texto",
                      "Comarca": "texto",
                      "Forum": "texto",
                      "Vara": "texto",
                      "Name": "texto",
                      "DateDistribution": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      },
                      "ProcessType": "texto",
                      "CurrentStatus": "texto",
                      "AmountLawsuit": "texto",
                      "ProcessAuthor": "texto",
                      "City": "texto",
                      "State": "texto",
                      "JusticeType": "texto",
                      "CpfCnpj": "texto"
                    }
                  ]
                },
                "CcfApontamentos": {
                  "CcfApontamento": [
                    {
                      "EntityType": "texto",
                      "CpfCnpj": "texto",
                      "ReportingCodeBank": "texto",
                      "ReportingNameBank": "texto",
                      "ReportingBranchPrefix": "texto",
                      "ReasonBounce": "texto",
                      "CountBounce": "texto",
                      "DateLastBounce": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      }
                    }
                  ]
                }
              },
              "Inquiries": {
                "InquiryCountLast30Days": 0,
                "InquiryCountLast31to60Days": 0,
                "InquiryCountLast61to90Days": 0,
                "InquiryCountMore90Days": 0,
                "InquiryDetails": {
                  "InquiryDetail": [
                    {
                      "DateInquiry": {
                        "Year": "texto",
                        "Month": "texto",
                        "Day": "texto"
                      },
                      "InquiryCount": 0,
                      "Segment": "texto"
                    }
                  ]
                }
              },
              "Protests": {
                "Protest": [
                  {
                    "erro_descricao": "texto",
                    "situacao": "texto",
                    "valor_protestados_total": "texto",
                    "totalProtestos": "texto",
                    "conteudo": {
                      "cartorio": [
                        {
                          "codigo_cidade": "texto",
                          "codigo_cartorio": "texto",
                          "nome": "texto",
                          "telefone": "texto",
                          "endereco": "texto",
                          "uf": "texto",
                          "cidade": "texto",
                          "protestos": "texto",
                          "valor_protestado": "texto",
                          "listaprotestos": {
                            "protestos": [
                              {
                                "data": "2026-01-01",
                                "valor": "texto"
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        }
      }
    }
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "1.400"
}
```