1. Authentication
Maat.ai API
  • v4
    • Authentication
      • Get AccessToken by Email
        POST
    • BlackLists
      • OFAC Generate Report
      • PEPS Generate Report
      • SAT69
      • SAT69-B
    • Dextract
      • Extract information
    • Files
      • Upload file
    • SocialEconomic
      • Generate Report
      • Download PDF
    • SAT
      • Validate RFC
  1. Authentication

Get AccessToken by Email

POST
{{v4_host}}/auth/attempt/credentials

Autenticación de Credenciales#

Se realiza una solicitud POST para autenticar las credenciales del usuario en el endpoint {{v4_host}}/auth/attempt/credentials.

Ejemplo del Cuerpo de la Solicitud#

El cuerpo de la solicitud es de tipo raw y tiene el siguiente formato:
{
    "email": "Email codificado ebn Base64",
    "password": "Password codificado en Base64"
}

Ejemplo de Respuesta#

{
    "data": {
        "code_message": "",
        "user": {
            // Campos propios de la entidad de usuario
            "token": {
                "access_token": "access_token",
                "refresh_token": "refresh_token"
            }
        }
    },
    "message": "",
    "success": true
}
La solicitud debe incluir los siguientes encabezados:
x-api-key: {{api-key}}
service: {{service}}
x-user-agent: portal|2.0.0
Content-Type: application/json

Solicitud

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}}/auth/attempt/credentials' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}' \
--header 'x-user-agent: {{x-user-agent}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email":"{{email}}", // IMPORTANT: This must be encoded in Base64
    "password":"{{password}}"  // IMPORTANT: This must be encoded in Base64
}'
Respuesta Ejemplo de Respuesta
200 - 200 - Valid credentials
{
    "data": {
        "code_message": "logged_in",
        "user": {
            "confirmation_code": "",
            "code_phone": "",
            "creation": "0001-01-01T00:00:00Z",
            "curp": "",
            "email": "example@example.com",
            "first_name": "Maat Pruebas",
            "id": 1000000000000001,
            "kind": "CLIENT",
            "last_name": "",
            "name": "",
            "phone": "",
            "role_id": 1000000000000001,
            "phone_confirmated": false,
            "profile": {
                "countries": null,
                "delete_date": "0001-01-01T00:00:00Z",
                "delete_reason": "",
                "id_val": 1000000000000001,
                "last_login": "2025-05-23T14:06:29.069212069Z",
                "last_name": "",
                "mother_last_name": "",
                "name": "",
                "onboarding_complete": false,
                "onboarding_stage": "",
                "personal_number": "",
                "rfc": "",
                "profile_photo": 0,
                "social_networks": null,
                "2fa_enabled": false,
                "update_at": "2025-05-23T14:06:29.069212389Z",
                "user_id": 1000000000000001
            },
            "social_media_facebook": "",
            "social_media_linkedin": "",
            "social_media_twitter": "",
            "terms_accepted": false,
            "terms_accepted_time": "0001-01-01T00:00:00Z",
            "token": {
                "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NDgwMzc5ODksImtpbmQiOiJBVCIsImtpbmRfdXNlciI6IkNMSUVOVCIsInVpZCI6NTY1ODMxMjk5NjE1OTQ4OH0.K4MaPLyBzxZPTvfKPCebVhFJvvvrJl7lKO3_Qt37SP8",
                "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3NjM1NjExODksImtpbmQiOiJSVCIsInVpZCI6NTY1ODMxMjk5NjE1OTQ4OH0.mbBoTfA0nr8bcx1WLnAYrWUFNA9IwMJz5xmNS0C5nYw"
            }
        }
    },
    "message": "Attempt was successful",
    "success": true
}
Modificado en 2026-04-10 18:59:29
Anterior
Authentication
Siguiente
BlackLists
Built with