Consulta de información personal de participante

Este endpoint realiza una solicitud GET para obtener la información personal de un participante asociado a un negocio.

La consulta utiliza el identificador interno del negocio (business_id) y el identificador externo de la persona (external_person_id) registrado en el sistema del proveedor.

Este endpoint permite consultar información de participantes de los siguientes tipos:

Persona Moral (MOR)

Persona Física primaria (FIS)

Persona Física secundaria (FIS)

La información retornada dependerá del tipo de persona consultada y de la información registrada para el participante.

Ejemplo de Solicitud

Path Params

Nombre	Tipo	Descripción
`business_id`	Integer	ID interno del negocio dentro de MAAT.
`external_person_id`	Integer	ID de la persona dentro del sistema del proveedor.

Ejemplo de Respuesta

{
    "data": {
        "participant": {}
    },
    "message": "Participant information retrieved successfully",
    "success": true
}

Respuestas por tipo de participante

Persona Moral (`person_type: MOR`)

Para participantes registrados como persona moral, la respuesta incluye información relacionada con la constitución de la empresa, actividad económica y datos fiscales.

Ejemplo de respuesta

{
    "data": {
        "participant": {
            "alias": "EMPRESA DEMO",
            "business_activity": "SERVICIOS PROFESIONALES",
            "external_person_id": 100001,
            "fiel": "ABC123XYZ",
            "fiscal_domicile": {
                "city": "CIUDAD DEMO",
                "country": "MX - México",
                "exterior_number": "100",
                "interior_number": "10",
                "neighborhood": "COLONIA DEMO",
                "origin_type": "NAC",
                "province": "ESTADO DEMO",
                "street": "CALLE DEMO",
                "zip_code": "50000"
            },
            "incorporation_date": "01/01/2025",
            "origin_country": "MX - México",
            "origin_type": "NAC",
            "person_type": "MOR",
            "profession": "CONSULTORÍA",
            "rfc": "AAA010101AAA"
        }
    },
    "message": "Participant information retrieved successfully",
    "success": true
}

Persona Física primaria (`person_type: FIS`)

Para participantes registrados como persona física primaria, la respuesta incluye información personal, fiscal y de identificación.

Ejemplo de respuesta

{
    "data": {
        "participant": {
            "alias": null,
            "birth_country": "US - Estados Unidos",
            "birth_date": "01/01/1990",
            "curp": "AAAA900101HDFBCD01",
            "external_person_id": 100002,
            "fiel": "ABC123XYZ",
            "fiscal_domicile": {
                "city": "CIUDAD DEMO",
                "country": "CA - Canadá",
                "exterior_number": "100",
                "interior_number": "10",
                "neighborhood": "COLONIA DEMO",
                "origin_type": "EXT",
                "province": "ESTADO DEMO",
                "street": "CALLE DEMO",
                "zip_code": "50000"
            },
            "marital_status": "SOL",
            "origin_country": null,
            "origin_type": "NAC",
            "person_type": "FIS",
            "profession": null,
            "rfc": "AAA900101AAA",
            "sex": "FEM"
        }
    },
    "message": "Participant information retrieved successfully",
    "success": true
}

Persona Física secundaria (`person_type: FIS`)

Para participantes registrados como persona física secundaria, la respuesta incluye información personal, fiscal y de identificación.

Ejemplo de respuesta

{
    "data": {
        "participant": {
            "alias": "ALIAS DEMO",
            "birth_country": "DE - Alemania",
            "birth_date": "01/01/1995",
            "curp": "BBBB950101HDFEFG02",
            "external_person_id": 100003,
            "fiel": "ABC123XYZ",
            "fiscal_domicile": {
                "city": "CIUDAD DEMO",
                "country": "MX - México",
                "exterior_number": "100",
                "interior_number": "10",
                "neighborhood": "COLONIA DEMO",
                "origin_type": "NAC",
                "province": "ESTADO DEMO",
                "street": "CALLE DEMO",
                "zip_code": "50000"
            },
            "marital_status": "CAS",
            "origin_country": "MX - México",
            "origin_type": "NAC",
            "person_type": "FIS",
            "profession": "INGENIERO",
            "rfc": "BBB950101BBB",
            "sex": "MAS"
        }
    },
    "message": "Participant information retrieved successfully",
    "success": true
}

Campos de respuesta

Campo	Tipo	Descripción
`alias`	String / Null	Alias registrado para el participante. Puede ser `null`.
`external_person_id`	Integer	ID de la persona dentro del sistema del proveedor.
`person_type`	String	Tipo de persona. Valores posibles: `MOR` (Persona Moral) o `FIS` (Persona Física).
`rfc`	String	Registro Federal de Contribuyentes (RFC). Formato de 12 o 13 caracteres alfanuméricos en mayúsculas.
`fiel`	String / Null	Identificador o información de la firma electrónica registrada.
`profession`	String / Null	Profesión u ocupación registrada para el participante.
`origin_country`	String / Null	País de origen en formato `<ISO 3166-1 alfa-2> - <Nombre del país>`. Puede ser `null`.
`origin_type`	String	Tipo de origen. Valores posibles: `NAC` (Nacional) o `EXT` (Extranjero).
`business_activity`	String	Actividad económica registrada. Solo aplica para personas morales.
`incorporation_date`	String	Fecha de constitución de la persona moral en formato `DD/MM/YYYY`.
`birth_date`	String	Fecha de nacimiento en formato `DD/MM/YYYY`. Solo aplica para personas físicas.
`birth_country`	String	País de nacimiento en formato `<ISO 3166-1 alfa-2> - <Nombre del país>`. Solo aplica para personas físicas.
`curp`	String	CURP del participante. Cadena de 18 caracteres con formato CURP estándar. Solo aplica para personas físicas.
`marital_status`	String	Estado civil. Valores posibles: `SOL`, `CAS`, `ULI`, `DIV`, `SUH` o `VIU`. Solo aplica para personas físicas.
`sex`	String	Sexo del participante. Valores posibles: `MAS` o `FEM`. Solo aplica para personas físicas.
`fiscal_domicile`	Object	Información del domicilio fiscal registrado para el participante.

Objeto `fiscal_domicile`

Campo	Tipo	Descripción
`street`	String	Calle del domicilio fiscal.
`exterior_number`	String	Número exterior.
`interior_number`	String	Número interior.
`neighborhood`	String	Colonia o localidad.
`city`	String	Ciudad.
`province`	String	Estado o provincia.
`country`	String	País del domicilio en formato `<ISO 3166-1 alfa-2> - <Nombre del país>`.
`zip_code`	String	Código postal.
`origin_type`	String	Tipo de origen del domicilio. Valores posibles: `NAC` (Nacional) o `EXT` (Extranjero).

Consideraciones importantes

La respuesta dependerá del tipo de persona consultada y de la información registrada para el participante.

Los países (origin_country, birth_country y country) son devueltos en el formato <ISO 3166-1 alfa-2> - <Nombre del país>.

Los campos origin_type pueden tomar los valores NAC (Nacional) o EXT (Extranjero).

Algunos campos pueden devolver null cuando no exista información registrada para el participante.

Es necesario enviar los headers x-api-key, service y Authorization con un Bearer Token válido para evitar errores de autenticación.

En caso de error general, la respuesta incluirá el campo code_message, el cual puede variar dependiendo del tipo de error (por ejemplo: invalid_request, unauthorized o server_error).

Get participant personal information

Consulta de información personal de participante#

Ejemplo de Solicitud#

Path Params#

Ejemplo de Respuesta#

Respuestas por tipo de participante#

Persona Moral (person_type: MOR)#

Ejemplo de respuesta#

Persona Física primaria (person_type: FIS)#

Ejemplo de respuesta#

Persona Física secundaria (person_type: FIS)#

Ejemplo de respuesta#

Campos de respuesta#

Objeto fiscal_domicile#

Consideraciones importantes#

Solicitud

Respuestas

Consulta de información personal de participante

Ejemplo de Solicitud

Path Params

Ejemplo de Respuesta

Respuestas por tipo de participante

Persona Moral (`person_type: MOR`)

Ejemplo de respuesta

Persona Física primaria (`person_type: FIS`)

Ejemplo de respuesta

Persona Física secundaria (`person_type: FIS`)

Ejemplo de respuesta

Campos de respuesta

Objeto `fiscal_domicile`

Consideraciones importantes