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

Download file

GET
/api/v4/fiduciary/download

Descarga de archivos fiduciarios#

Este endpoint realiza una solicitud GET para obtener uno o varios archivos asociados a un documento fiduciario dentro de los sistemas de MAAT.
La respuesta del endpoint devuelve el contenido del archivo en bytes. Dependiendo de la cantidad y tipo de archivos encontrados, la respuesta puede corresponder a un PDF, una imagen (JPG/PNG) o un archivo ZIP.
La búsqueda del archivo se realiza utilizando los parámetros external_reference_id y document_id.
⚠️ IMPORTANTE: Es obligatorio enviar al menos uno de los parámetros external_reference_id o document_id. Ambos pueden enviarse en la misma solicitud, pero no es válido omitir los dos.#

Ejemplo de Solicitud#

Query Params#

NombreTipoDescripción
external_reference_idIntegerID externo del proveedor utilizado para identificar el archivo.
document_idIntegerID interno asociado al documento del cual se desea obtener el archivo.

Ejemplo de Respuesta#

Nomenclatura de contenido:
application/pdf → Archivo PDF.
image/jpeg → Imagen JPG/JPEG.
image/png → Imagen PNG.
application/zip → Archivo ZIP que contiene múltiples archivos.
IMPORTANTE:
Si se encuentra un único archivo, la respuesta corresponderá directamente al tipo del archivo (por ejemplo, PDF o imagen).
Si la búsqueda devuelve múltiples archivos, la respuesta será un archivo ZIP que los contiene.
El archivo se entrega con el header Content-Disposition: attachment, por lo que el navegador o cliente HTTP iniciará la descarga del archivo.
Es obligatorio enviar al menos uno de los parámetros external_reference_id o document_id. Ambos pueden enviarse juntos si se desea.
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).

Solicitud

Parámetros de consulta

Parámetros de Header

Respuestas

🟢200Downloand file
image/jpeg
🟠400Invalid request
🟠401File doesn't belong to the client/user
🔴500Error during file retrieval
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/api/v4/fiduciary/download?external_reference_id=0' \
--header 'x-api-key: {{api-key}}' \
--header 'service: {{service}}'
Respuesta Ejemplo de Respuesta
200 - Downloand file
Archivo JPEG/PNG/PDF válido retornado correctamente
Content-Type: image/jpeg | image/png | application/pdf | application/zip
Content-Disposition: attachment
Modificado en 2026-07-10 17:18:45
Anterior
Fiduciary process
Siguiente
Generate/update fiduciary requests
Built with