1. SocialEconomic
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
    • SocialEconomic
      • Generate Report
        POST
      • Download PDF
        GET
    • SAT
      • Validate RFC
  1. SocialEconomic

Generate Report

POST
{{v4_host}}/socioeconomic-detail

Detalles Socioeconómicos#

Este endpoint realiza una solicitud POST para obtener detalles socioeconómicos con la información proporcionada. La solicitud debe incluir un cuerpo de solicitud en formato JSON con el campo "curp" que representa el CURP del individuo y "wait_until_ends" que indica si se debe esperar hasta que finalice.
⚠️ IMPORTANTE: Para pruebas se recomienda usar el curp DUMMY000000XXXXXX00 para evitar cobros por uso de este servicio#

Ejemplo de Solicitud#

{
    "curp": "DUMMY000000XXXXXX00",
    "wait_until_ends": true
}

Ejemplo de Respuesta#

{
    "data":{
        //Si wait_until_ends es true, devolverá la respuesta en JSON incluyendo el ID
    },
    "message":string
    "success":bool
}
IMPORTANTE: Para recuperar el ID de la transacción, es necesario que la bandear wait_until_ends se envíe en true

Solicitud

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

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200
application/json
Body

🟠400
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location -g --request POST '{{v4_host}}/socioeconomic-detail' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "curp":"DUMMY000000XXXXXX00",
    "wait_until_ends":true
}'
Respuesta Ejemplo de Respuesta
200 - 200 - Generate Report
{
    "data": {
        "socioeconomic_detail": {
            "id": 1554040555186998,
            "report": {
                "data": {
                    "Agresores_Sexuales": "No",
                    "Aguinaldo": "$ 10,000",
                    "Alertas_Internacionales": "No",
                    "Beneficiarios": "2",
                    "Beneficiarios_detalles": [
                        {
                            "Edad": "15",
                            "Nombre": "REBORTI LEPOZ VIRGOS",
                            "PEP": "green",
                            "Parentesco": "Hijos"
                        },
                        {
                            "Edad": "33",
                            "Nombre": "LICROCIA PORIZ MASA",
                            "PEP": "green",
                            "Parentesco": "Cónyuge"
                        }
                    ],
                    "CURP": "XXXX010101MMCSHNA2",
                    "Cedula": "09999999 / LICENCIATURA EN CIENCIAS DEL MUNDO",
                    "Certificados": "No hay certificado",
                    "Circulo_Social": 1,
                    "Circulo_social_detalles": [
                        {
                            "Edad": 57,
                            "Estatus_Salario": "Empleado / $15,000",
                            "Nombre": "LIRUNA LEPOZ VIRGOS",
                            "PEP": "red",
                            "Parentesco": "Padres"
                        }
                    ],
                    "Clinica": "",
                    "Clinica_Detalles": [
                        {
                            "Organización": "IMSS",
                            "Unidad": "UMF 999 LIMON"
                        }
                    ],
                    "Colonia": "Pedregal de Carrasco, Estado de Estado, México, 99999",
                    "Crédito_Hipoteca": "Infonavit",
                    "Demandas_Administrativas": "No",
                    "Demandas_Administrativas_Detalles": [],
                    "Demandas_Administrativas_Ult_Mov": "N/A",
                    "Demandas_Civiles": "No",
                    "Demandas_Civiles_Detalles": [],
                    "Demandas_Civiles_Ult_Mov": "N/A",
                    "Demandas_Familiares": "No",
                    "Demandas_Familiares_Detalles": [],
                    "Demandas_Familiares_Ult_Mov": "N/A",
                    "Demandas_Laborales": "No",
                    "Demandas_Laborales_Detalles": [],
                    "Demandas_Penales": "No",
                    "Demandas_Penales_Detalles": [],
                    "Demandas_Penales_Ult_Mov": "N/A",
                    "Derecho_ServicioMedico": "Sí (IMSS)",
                    "Descuento_Hipoteca": "No",
                    "Dueda_SAT": "Cumplido",
                    "Edad": "43",
                    "Estatus Laboral - Promedio": "Empleado / 130 meses",
                    "Estatus_Crédito": "Crédito Disponible",
                    "Estimado desde 22 Años": "500 semanas",
                    "Fecha_Consulta": "26/05/2025",
                    "Finiquito": "$ 10,000",
                    "Funcionarios": [
                        {
                            "institución": "---",
                            "puesto": "---",
                            "salario": "---"
                        }
                    ],
                    "Funcionarios_Count": "No",
                    "Grado_Demandas": 0,
                    "Historial_Legal_Mensaje": "Excelente",
                    "Historial_laboral_porcentaje": "100.0%",
                    "Institución_escolar": "INSTITUTO DE EDUCACION",
                    "Liquidacion": "$ 9,999",
                    "NSS": "09999999999",
                    "Nivel_Estudios": "LICENCIATURA",
                    "Nivel_socioeconómico": "Medio / Alto",
                    "Numero_Empleos": "2 empleos / 65.4 meses",
                    "Numero_Empleos_Detalles": [
                        {
                            "Alta_Baja": "27-02-2023 / Vigente",
                            "Dependencia": "IMSS",
                            "Duracion": "27 meses",
                            "Empleador": "EMPRESA SA DE CV",
                            "Estado_empleo": "Ciudad de México",
                            "Payer": null,
                            "Salario": "$ 10,000"
                        },
                        {
                            "Alta_Baja": "10-07-2014 / 24-02-2023",
                            "Dependencia": "IMSS",
                            "Duracion": "103 meses",
                            "Empleador": "OTRA EMPRESA MEXICO",
                            "Estado_empleo": "Ciudad de México",
                            "Payer": null,
                            "Salario": "$ 9,246"
                        }
                    ],
                    "Partidos": [
                        {
                            "cargo": "---",
                            "elección": "---",
                            "entidad": "---",
                            "partido": "---",
                            "puesto": "---"
                        }
                    ],
                    "Partidos_Count": "No",
                    "Policitamente_expuesto_porcentaje": "No expuesto",
                    "Policitamente_expuesto_porcentaje_traffic_light": "green",
                    "Problemas_Empleador": "No",
                    "Progresion_Salarial": "12.95%",
                    "Progresion_Salarial_Detalles": [
                        {
                            "Anio": 2025,
                            "Empleador": "EMPRESA SA DE CV",
                            "Porcentaje": "0.13%",
                            "Salario": "$ 9,990"
                        }
                    ],
                    "Promedio_Final": "100.0%",
                    "Préstamo_Máximo": "---",
                    "Puntos_Crédito": "1222/1080 puntos",
                    "RFC": "XXXX010101AA1 SRF",
                    "Renta_Mensual_Estimada": "$ 6,000",
                    "Salario_Cotizado": "$ 10,112",
                    "Semanas_Cotizadas": "220 semanas / 91.75%",
                    "Semanas_Cotizadas_Detalles": [
                        {
                            "Tipo": "IMSS",
                            "Valor": "220 semanas / 91.75%"
                        },
                        {
                            "Tipo": "ISSSTE",
                            "Valor": "0 semanas / 0.0%"
                        }
                    ],
                    "Semanas_Descontadas": 0,
                    "Semanas_Descontadas_Detalles": [
                        {
                            "Dias": 0,
                            "Institución": "IMSS",
                            "Semanas": 0
                        }
                    ],
                    "Servicios": {
                        "finalizados": false,
                        "imss": false,
                        "legal": false,
                        "pep": false,
                        "vigencia": false
                    },
                    "Sindicatos": [
                        {
                            "cargo": "---",
                            "posición": "---",
                            "sindicato": "---",
                            "vigencia": "---"
                        }
                    ],
                    "Sindicatos_Count": "No",
                    "Subcuenta_Vivienda": "$ 9,641",
                    "Total_Homonimos": 1,
                    "Ultimo_Empleador_Duracion": "EMPRESA SA DE CV / 27 meses",
                    "Vacaciones": "12",
                    "Vivienda_Propia": "No",
                    "pdf_base64": null
                },
                "powerdby": "Searchlook",
                "status": 200
            }
        }
    },
    "message": "Report has been generated",
    "success": true
}
Modificado en 2026-04-10 18:59:20
Anterior
SocialEconomic
Siguiente
Download PDF
Built with