Crédito, renda e birô

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.

Falar com o comercial Ver o catálogo

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.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/pessoas/quod-consulta-pf

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

{
  "document": "000.000.000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

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

Estrutura real da resposta, com valores fictícios.

{
  "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"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido