Background check service

The background search service is a solution to search for companies and individuals against public compliance lists for the Prevention of Money Laundering and Financing of Terrorism (PLD / FT).

Endpoint

The characteristics of the endpoints for the consumption of the background check service of individuals and companies are listed below.

Physical person

This method filters individuals against public compliance lists for the Prevention of Money Laundering and Financing of Terrorism (PLD / FT).

~/api/BackgroundCheck/physicalPerson

Parameters

Name	Type	Required	Description
name	string	yes	Name(s) of the person without accents or special characters.
lastName	string	yes	Last name without accents or special characters.
secondLastName	string	yes	Second last name without accents or special characters.
rfc	string	no	RFC with homoclave of the person.
curp	string	no	CURP (Clave Única de Registro de Población).
dateOfBirth	string	no	Date of birth.

Headers

Name	Type	Required	Description
ApiKey	string	yes	Access credentials

Formdata

{
  "name": "string",
  "lastName": "string",
  "secondLastName": "string",
  "rfc": "string",
  "curp": "string",
  "dateOfBirth": "string"
}

Response:

Correct

Name	Type	Description
found	boolean	Success
coincidenceResult	string	Level of coincidence between the input parameters and the results obtained.
name	string	Name (s) of the person.
lastName	string	Last name.
secondLastName	string	Mother's last name.
rfc	string	RFC with homoclave of the person.
curp	string	CURP (Clave Única de Registro de Población).
dateOfBirth	string	Date of birth.
list	string	List on which a match was found.
completeName	string	Complete name of the person.
sex	string	Sex of the person.
email	string	Mail of the person.

{
    "found": 'success',
    "coincidences": [{
        "coincidenceResult": integer,
        "name": string,
        "lastName": string,
        "secondLastName": string,
        "rfc": string,
        "curp": string,
        "dateOfBirth": string,
        "list": string,
        "sex": string,
        "email": string, 
    }]
}

Error

Code	Description
Error code	If there are errors, they will be listed.
Message	Error message

{
    "code": "string",
    "message": "string"
}

Juridical person

This method searches for legal entities against public compliance lists for the Prevention of Money Laundering and Financing of Terrorism (PLD / FT).

~/api/BackgroundCheck/juridicalPerson

Parameters

Name	Type	Required	Description
businessName	string	yes	Business name
rfc	string	no	RFC with homoclave of the company.

Headers

Name	Type	Required	Description
ApiKey	string	yes	Access credentials

FormData

{
  "businessName": "string",
  "rfc": "string"
}

Response:

Correct

Name	Type	Description
found	boolean	Success
coincidenceResult	string	Level of coincidence between the input parameters and the results obtained.
list	string	Name of the public list where records of juridical person were found.
wantedBy	string	Additional registration information.
businessName	string	Business name of the juridical person.
program	string	Program name of the juridical person.
personType	string	PM (Juridical person)
email	string	mail of the company.

{
    found: 'success',
    coincidences: [{
        "coincidenceResult": string,
        "completeName": string,
        "rfc": string,
        "program":string,
        "list": string,
        "wantedBy": string,
        "email": string
    }]
}

Error

Code	Description
Error code	If there are errors, they will be listed.

{
    "code": "string",
    "message": "string"
}

Service messages

Code	Message	Description
BGC001	Something was wrong, We are working on the failure.	Indicates if the request was successful. If all goes well, it will show the structure of the data.
BGC002	Unauthorized at BGC Services	Message that is displayed when a request is sent with empty fields: Name, lastname, second last name and RFC.
BGC003	BGC Services Timeout Error	Message that is displayed when the server takes a long time to deliver a response and cannot be obtained.
BGC004	BGC service is not available	Message displayed when there is an error getting the response from the server.
BGC005	Unable to validate data with source	The service has issues to validate data in the source.
BGC006	BGC Document Timeout Error	Message that is displayed when the server takes a long time to deliver a response and cannot be obtained.
BGC007	Parameter error	The request has an error in some of the values in the parameters.
BGC008	The apiKey is not valid.	The apiKey is not valid.
BGC009	ApiKey is required	The ApiKey was not sent in the request.