1. Files
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
        POST
      • Get file
        GET
    • SocialEconomic
      • Generate Report
      • Download PDF
    • SAT
      • Validate RFC
    • Quizes
      • Import answers from API
    • Fiduciary process
      • Download file
      • Generate/update fiduciary requests
      • Get business data with participants
      • Get participant personal information
      • Notification business complete from external (delete all information)
      • Notification of person with matches resolved
  1. Files

Get file

GET
/api/v4/file/{file_id}

Obtención/visualización de archivos#

Este endpoint realiza una solicitud GET para obtener un archivo previamente generado dentro de los sistemas de MAAT. Permite visualizar el archivo directamente en el navegador o forzar su descarga, dependiendo del parámetro download.
La solicitud utiliza parámetros en la URL para indicar el archivo (file_id) y el request_id asociado.
⚠️ IMPORTANTE: Es necesario enviar correctamente el file_id en la URL y el request_id como parámetro de consulta para evitar errores en la obtención del archivo.#

Ejemplo de Solicitud#

Ejemplo de Respuesta#

Content-Type: application/pdf | image/jpeg | image/png
Content-Disposition: attachment; filename="file.extension"

(binary content del archivo)
Nomeclatura de contenido:
application/pdf → Archivos PDF
image/jpeg → Imágenes JPG/JPEG
image/png → Imágenes PNG
IMPORTANTE:
Este endpoint no envía ni recibe JSON, la respuesta es un archivo (por ejemplo: PDF, imagen, etc.).
El comportamiento del archivo depende del parámetro download:
?download=true → Content-Disposition: attachment → fuerza la descarga del archivo.
Sin download=true → Content-Disposition: inline → el archivo se muestra directamente en el navegador (por ejemplo, visor de PDF).
Este mecanismo es el estándar HTTP para controlar si un archivo se visualiza o se descarga.
El request_id es obligatorio para poder recuperar correctamente el archivo asociado a una solicitud previa.
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, server_error).
Es necesario enviar los headers x-api-key, service y Authorization con un Bearer Token válido para evitar errores de autenticación.

Solicitud

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

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Get file
image/jpeg
🟠401Unauthorized user
🟠400Invalid request
🔴500Error get file
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/api/v4/file/0?download=true&request_id=0' \
--header 'x-api-key: {{api-key}}' \
--header 'service: api' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
200 - Get file
Archivo JPEG/PNG/PDF válido retornado correctamente
Content-Type: image/jpeg | image/png | application/pdf
Content-Disposition: attachment
Modificado en 2026-06-15 17:52:29
Anterior
Upload file
Siguiente
SocialEconomic
Built with