Track your DIAN exógena requests through an API

What you can build on MUISCA

• Get exógena requests and their status

  Build this

  Reads Consultar envíos de solicitudes (check sent requests) for one formato and año gravable, with each solicitud's estado.

  Takes

  Formato code, año gravable

  Returns

  Request number, formato, version, year reported, number of files, total records, first file name, estado

• Get the errors of an exógena request

  Build this

  Opens one solicitud in Consultar envíos de solicitudes and reads its files and the error detail DIAN found in each.

  Takes

  Formato code, año gravable, request number

  Returns

  Request number, estado, file names, error details per file

• Get the next file consecutivo

  Build this

  Reads, in Colocar archivos en su bandeja de entrada (place files in your inbox), the next file consecutivo DIAN expects from the organization.

  Takes

  Formato code

  Returns

  Organization name, NIT, formato, version, next consecutivo

• Cancel a duplicated exógena request

  Build this

  In Cancelación Solicitud, finds the solicitud by number, picks the motivo de cancelación (reason) and signs it with your firma electrónica.

  Takes

  Formato code, request number, reason

  Returns

  Request number, formato, concept, watermark status

Automate MUISCA with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Exógena requests that came back with errors

  Build this

  Starts

  Every weekday at 8:00

  Step 1

  For each formato you report, get the exógena requests and their status for the año gravable.

  Step 2

  Keep the solicitudes whose estado starts with Solicitud con Error and were not on the last run.

  Step 3

  For each one, get the errors of the request.

  Step 4

  Email you the list with request number, formato, file names and error details.

• Next consecutivo sent to your XML generator

  Build this

  Starts

  When your system calls the workflow's webhook with a formato code

  Step 1

  Get the next file consecutivo for that formato.

  Step 2

  Post the organization's NIT, formato, version and next consecutivo to your system's webhook.

• Weekly exógena status report for the accounting team

  Build this

  Starts

  Every Monday at 7:00

  Step 1

  For each formato you report, get the exógena requests and their status for the año gravable.

  Step 2

  Group the solicitudes by estado, with a count for each formato.

  Step 3

  Email you the summary and the requests whose estado changed since the last run.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get exógena requests and their status” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "muisca.dian.gov.co/get_exogena_requests",
    "input": {
      "formato": "1001",
      "anio_gravable": 2025
    }
  }'

{
  "status": "completed",
  "data": {
    "organization": "Acme Colombia S.A.S.",
    "formato": "1001",
    "version": "10",
    "requests": [
      {
        "request_number": "1100000482",
        "year_reported": 2025,
        "file_count": 3,
        "total_records": 12840,
        "first_file_name": "Dmuisca_010100110202600000001.xml",
        "estado": "Solicitud Recibida"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

MUISCA’s own options

DIAN's guides describe no API for MUISCA. Información exógena goes in as XML files that you build with DIAN's free Excel prevalidador or your own systems, place in the Bandeja de Entrada and sign with your firma electrónica. Declarations and RUT updates are filled in and signed in the portal itself.

Read on November 12, 2026: Cartilla Presentación de información por envío de archivos (2026), Prevalidadores, Información Exógena Tributaria, Paso a paso actualización en línea RUT.

Signing in to MUISCA

MUISCA signs you in as Usuario Registrado with a document type, document number and password, A nombre propio or A nombre de un tercero with the organization's NIT. Signing a document asks for that password again and a clave dinámica. With Fous you sign in once through DIAN's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

5,000 records a file, 50,000 a request

Each XML file holds at most 5,000 records, and one solicitud takes at most 10 files and 50,000 records. A larger formato goes in two or more solicitudes.

The consecutivo must match, per organization

File names carry a consecutivo that restarts each year and is kept per organization. If a request does not start with the consecutivo DIAN expects, it cannot be presented.

Check the PDF watermark

A request's PDF says Recibido once it is signed and presented, and En Trámite when signing failed. Check too that it was presented in the organization's name, not the legal representative's.

A clave dinámica lasts two hours, once

Signing asks for a clave dinámica, sent to your bandeja de comunicados. It is valid for up to two hours and for one use.

More in Government: Latin America

• Mis Comprobantes
• Facturación Electrónica DIAN
• Simplificación Registral
• ARCA - servicios con Clave Fiscal
• Portal Empresarial INFONAVIT
• SIFERE Web
• Declaración en Línea (F.931)
• AFPnet
• ARBA
• SEACE
• SECOP II
• BPS Servicios en Línea
• IESS - Portal de Empleadores
• Oficina Virtual CCSS (SICERE)
• SUIR
• Previred
• Aportes en Línea
• SOI
• SIPARE
• DGI Servicios en Línea
• e-Tax 2.0
• Agencia Virtual SAT
• Oficina Virtual DGII
• Portal del SAT (Factura Electrónica)
• SII (Mi SII)
• SRI en Línea
• SUNAT Operaciones en Línea (SOL)
• TRIBU-CR
• Declaraciones y Pagos (SAT)

Other industries: Mudad, e-Zamówienia, ePortal ESTV, Accela Citizen Access, Desktop Underwriter, FINRA Gateway.