1. Fiduciary process
Maat.ai API
  • v4
    • Authentication
      • Get AccessToken by Email
    • BlackLists
      • OFAC Generate Report
      • PEPS Generate Report
      • SAT69
      • SAT69-B
    • Dextract
      • Extract information
    • Files
      • Upload file
      • Get file
    • SocialEconomic
      • Generate Report
      • Download PDF
    • SAT
      • Validate RFC
    • Quizes
      • Import answers from API
    • Fiduciary process
      • Download file
        GET
      • Generate/update fiduciary requests
        POST
      • Get business data with participants
        GET
      • Get participant personal information
        GET
      • Notification business complete from external (delete all information)
        POST
      • Notification of person with matches resolved
        POST
  1. Fiduciary process

Get business data with participants

GET
/api/v4/business/detail

Consulta de negocio con participantes#

Este endpoint realiza una solicitud GET para obtener el detalle completo de un negocio registrado, incluyendo la información de todos los participantes asociados.
La consulta recibe el identificador interno del negocio y devuelve la información general del negocio, el usuario responsable, los participantes registrados y la información previamente capturada para cada uno de ellos.
⚠️ IMPORTANTE: El parámetro id corresponde al identificador interno del negocio dentro de MAAT.#

Ejemplo de Solicitud#

Query Params#

NombreTipoDescripción
idIntegerID interno del negocio dentro de MAAT del cual se desea recuperar toda la información asociada.

Ejemplo de Respuesta#

{
    "data": {
        "business": {
            "id": 0,
            "id_negocio": 0,
            "cod_negocio": "NEGOCIO-DEMO",
            "business_name": "Negocio Demo",
            "responsible_user": {
                "name": "Nombre",
                "first_last_name": "Apellido Paterno",
                "second_last_name": "Apellido Materno",
                "email": "usuario@correo.com"
            },
            "participantes": [
                {
                    "id": 0,
                    "id_persona": 0,
                    "tipo_per": "FIS",
                    "nombre": "NOMBRE",
                    "apellido_paterno": "APELLIDO",
                    "apellido_materno": "APELLIDO",
                    "email": "participante@correo.com",
                    "codigo_telefonico": "",
                    "telefono": "",
                    "mod_carga": "PER",
                    "match_resolution_pending": false,
                    "roles": [
                        "COMITE TECNICO"
                    ],
                    "tipo_doctos": [
                        {
                            "cod_tipo_docto": "670",
                            "id_descarga": null
                        },
                        {
                            "cod_tipo_docto": "672",
                            "id_descarga": 123456
                        }
                    ]
                }
            ]
        }
    },
    "message": "Business detail retrieved successfully",
    "success": true
}

Información devuelta#

El objeto business contiene toda la información registrada del negocio junto con sus participantes.

Datos del negocio#

CampoTipoDescripción
idIntegerID interno del negocio dentro de MAAT.
id_negocioIntegerIdentificador del negocio proporcionado por el proveedor durante su creación.
cod_negocioStringCódigo o referencia del negocio.
business_nameStringNombre del negocio. Puede ser una cadena vacía.
responsible_userObjectInformación del usuario responsable del negocio.
participantesArrayLista de participantes asociados al negocio.

Usuario responsable (responsible_user)#

CampoTipoDescripción
nameStringNombre del usuario responsable.
first_last_nameStringApellido paterno.
second_last_nameStringApellido materno.
emailStringCorreo electrónico del usuario responsable.

Participantes (participantes[])#

Cada elemento del arreglo representa un participante asociado al negocio.
CampoTipoDescripción
idIntegerID interno del participante dentro de MAAT.
id_personaIntegerID de la persona asociado al participante dentro de MAAT.
tipo_perStringTipo de persona. Valores posibles: FIS (Persona Física) o MOR (Persona Moral).
nombreStringNombre o razón social del participante.
apellido_paternoStringApellido paterno. Puede ser una cadena vacía para personas morales.
apellido_maternoStringApellido materno. Puede ser una cadena vacía para personas morales.
emailStringCorreo electrónico registrado del participante.
codigo_telefonicoStringCódigo telefónico internacional.
telefonoStringNúmero telefónico del participante.
mod_cargaStringModalidad mediante la cual fue registrado el participante.
match_resolution_pendingBooleanIndica si el participante tiene pendiente una resolución de coincidencias.
rolesArray[String]Roles asignados al participante dentro del negocio.
tipo_doctosArray[Object]Documentos asociados al participante.

Documentos (tipo_doctos[])#

CampoTipoDescripción
cod_tipo_doctoStringCódigo del tipo de documento solicitado para el participante.
id_descargaInteger / NullIdentificador del archivo generado. Será null cuando el documento aún no se encuentre disponible.

Consideraciones importantes#

El parámetro id debe corresponder al ID interno del negocio dentro de MAAT.
La respuesta incluye todos los participantes asociados al negocio.
Cada participante contiene su ID interno (id en MAAT) y el ID externo de la persona (id_persona en el proveedor).
La información devuelta corresponde a la capturada previamente durante el proceso del negocio.
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 o server_error).

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Get all associated business data
application/json
Bodyapplication/json

🟢200Business without data
🟠400Invalid request
🔴500Error fetching business detail
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/api/v4/business/detail?id=0' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
200 - Get all associated business data
{
    "data": {
        "business": {
            "id": 0,
            "id_negocio": 0,
            "cod_negocio": "NEGOCIO-DEMO",
            "business_name": "Negocio Demo",
            "responsible_user": {
                "name": "Nombre",
                "first_last_name": "Apellido Paterno",
                "second_last_name": "Apellido Materno",
                "email": "usuario@correo.com"
            },
            "participantes": [
                {
                    "id": 0,
                    "id_persona": 0,
                    "tipo_per": "FIS",
                    "nombre": "NOMBRE",
                    "apellido_paterno": "APELLIDO PATERNO",
                    "apellido_materno": "APELLIDO MATERNO",
                    "email": "participante@correo.com",
                    "codigo_telefonico": "+00",
                    "telefono": "0000000000",
                    "mod_carga": "PER",
                    "match_resolution_pending": false,
                    "roles": [
                        "COMITE TECNICO"
                    ],
                    "tipo_doctos": [
                        {
                            "cod_tipo_docto": "000",
                            "id_descarga": null
                        },
                        {
                            "cod_tipo_docto": "001",
                            "id_descarga": null
                        },
                        {
                            "cod_tipo_docto": "002",
                            "id_descarga": null
                        }
                    ]
                }
            ]
        }
    },
    "message": "Business detail retrieved successfully",
    "success": true
}
Modificado en 2026-07-11 05:35:06
Anterior
Generate/update fiduciary requests
Siguiente
Get participant personal information
Built with