Profile

Profile updates will trigger a webhook to communicate new statuses to the client-server. See more in profile webhooks section

It is significant to be careful that not all properties may be present in the request's response since the profile's data changes according to the query template definition, principally modifying the sources field.

Get person

Retrieve information of a person's profile.

GEThttps://api.combateafraude.com/v1/people/{personId}

Path parameters

personId*string

Person identifier or CPF.

Header parameters

Response

200400401403

Success

Body

application/json

requestId*string

Unique identifier of request.

Example: "2b8f373-c462-4bbf-9a4f-8aeb7d71ec53"

id*string

Unique identifier of person.

Example: "5388a3e9a73b28000bba31a3"

status*enum

Status of person profile. Possible values: APPROVED, REPROVED, PENDING, PROCESSING, WAITING_DOCUMENTS

Example: "APPROVED"

APPROVEDREPROVEDPENDINGPROCESSINGWAITING_DOCUMENTS

cpf*string

Individual person national registry.

Example: "00011122233"

basicData*object

Basic information about person.

executions*array of object

List of transactions related to profile.

sources*object

Queried sources response on transactions related to profile.

Request

JavaScriptCurlPython

const response = await fetch('https://api.combateafraude.com/v1/people/{personId}', {
    method: 'GET',
    headers: {
      "Authorization": "text"
    },
});
const data = await response.json();

Response

200400401403

{
  "requestId": "2b8f373-c462-4bbf-9a4f-8aeb7d71ec53",
  "id": "5388a3e9a73b28000bba31a3",
  "status": "APPROVED",
  "cpf": "00011122233",
  "basicData": {
    "name": "JANE DOE",
    "fatherName": "JOHN DOE",
    "motherName": "MARIA DOE",
    "birthDate": "01/01/2000",
    "rg": "115094374",
    "gender": "Female"
  },
  "executions": [
    {
      "executionId": "4w88a3e9a73b28000bba31ad",
      "executionOrigin": "API",
      "lastUpdate": "2022-09-08T22:11:05.816Z",
      "metadata": {}
    }
  ],
  "sources": {
    "pfAddresses": {
      "lastConsultation": {
        "date": "2022-09-08T22:11:05.816Z"
      }
    },
    "pfBasicData": {
      "lastConsultation": {
        "date": "2022-09-08T22:11:05.816Z"
      }
    },
    "pfMediaProfileAndExposure": {
      "lastConsultation": {
        "date": "2022-09-08T22:11:05.816Z"
      }
    }
  }
}

Get company

Retrieve information of a company's profile.

GEThttps://api.combateafraude.com/v1/companies/{companyId}

Path parameters

companyId*string

Company identifier or CNPJ.

Query parameters

Header parameters

Response

200400401403

Success

Body

application/json

requestId*string

Unique identifier of request.

Example: "2b8f373-c462-4bbf-9a4f-8aeb7d71ec53"

id*string

Unique identifier of company.

Example: "5388a3e9a73b28000bba31a3"

status*enum

Status of company profile. Possible values: APPROVED, REPROVED, PENDING, PROCESSING, WAITING_DOCUMENTS

Example: "APPROVED"

APPROVEDREPROVEDPENDINGPROCESSINGWAITING_DOCUMENTS

cnpj*string

National Register of Legal entity.

Example: "00111222333344"

basicData*object

Basic information about company.

executions*array of object

List of transactions related to profile.

onboardingobject

Partners onboarding related to profile.

qsaobject

Administrative corporate structure.

sourcesobject

Queried sources response on transactions related to profile.

Request

JavaScriptCurlPython

const response = await fetch('https://api.combateafraude.com/v1/companies/{companyId}', {
    method: 'GET',
    headers: {
      "Authorization": "text"
    },
});
const data = await response.json();

Response

200400401403

{
  "requestId": "2b8f373-c462-4bbf-9a4f-8aeb7d71ec53",
  "id": "5388a3e9a73b28000bba31a3",
  "status": "APPROVED",
  "cnpj": "00111222333344",
  "basicData": {
    "openingDate": "01/01/2022",
    "officialName": "Official name example",
    "fantasyName": "Fantasy name example",
    "companySize": "MICRO EMPRESA",
    "companyEmail": "[email protected]",
    "mainActivity": "9511800 - Reparação e manutenção de computadores e de equipamentos periféricos",
    "secondaryActivities": [
      {
        "code": "6204000",
        "description": "Consultoria em tecnologia da informação"
      }
    ],
    "legalNature": "2135 - Empresário (Individual)",
    "status": "ATIVA",
    "jointStock": "R$ 1000,00",
    "phoneNumber": "555100001111"
  },
  "executions": [
    {
      "executionId": "4w88a3e9a73b28000bba31ad",
      "executionOrigin": "API",
      "lastUpdate": "2022-09-08T22:11:05.816Z",
      "metadata": {}
    }
  ],
  "onboarding": {
    "qsa": [
      {
        "status": "COMPLETED",
        "name": "Partner name example",
        "profileId": "1e48a3e9a73b28000bba31a2db",
        "transactionId": "1e48a3e9a73b28000bba31a2db"
      }
    ]
  },
  "qsa": {
    "items": [
      {
        "name": "Partner name example",
        "functionCode": "34",
        "function": "Titular",
        "isLegalRepresentative": true,
        "profileId": "1e48a3e9a73b28000bba31a2db",
        "status": "APPROVED",
        "transactionId": "1e48a3e9a73b28000bba31a2db"
      }
    ]
  },
  "sources": {
    "pjData": {
      "lastConsultation": {
        "date": "2022-09-08T22:11:05.816Z"
      }
    },
    "pjSimples": {
      "lastConsultation": {
        "date": "2022-09-08T22:11:05.816Z"
      }
    }
  }
}