Track your SECOP II contracts and payments by API

What you can build on SECOP II

• Get my contracts

  Build this

  Reads Mis contratos under Mis procesos: each contract with its Entidad Estatal (contracting entity), end date, value and Estado (status).

  Takes

  Estado (optional)

  Returns

  Contract number, Entidad Estatal, end date, contract value, Estado

• Check payment requests on a contract

  Build this

  Opens a contract's Ejecución del contrato (contract execution) section and reads the Plan de Pagos: each payment request with its amounts, radicación number and status.

  Takes

  Contract number

  Returns

  Invoice number, issue date, due date, net value, total value, radicación number, status, rejection reason

• Check the garantías on a contract

  Build this

  Reads Garantías under Configuración financiera in a contract's Condiciones section: each guarantee you sent and whether the entity accepted it.

  Takes

  Contract number

  Returns

  Guarantee reference, guarantee type, coverages, insured value, validity dates, status

• Register a payment request

  Build this

  In a contract's Plan de Pagos, selects Registro for a payment, fills in the invoice data and selects Confirmar, then Enviar.

  Takes

  Contract number, Plan de Pagos payment, invoice number, issue and due dates, net and total value, radicación number

  Returns

  Invoice number, total value, status

Automate SECOP II 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.

• Contracts waiting for your signature or approval

  Build this

  Starts

  Every weekday at 7:00

  Step 1

  Get your contracts from Mis contratos.

  Step 2

  Keep the ones in Pendiente de firma or En modificación.

  Step 3

  Email you the list with entity, contract number, value and Estado.

• Payment requests accepted, paid or rejected

  Build this

  Starts

  Every weekday at 9:00

  Step 1

  Get your contracts in En ejecución.

  Step 2

  For each contract, check the payment requests in its Plan de Pagos.

  Step 3

  Keep the requests whose status changed since the last run.

  Step 4

  Post each one, with invoice number, total value, status and Razón, to your accounting webhook.

• Rejected or pending garantías, weekly

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  Get your contracts in Firmado or En ejecución.

  Step 2

  For each contract, check its garantías.

  Step 3

  Keep the ones in Pendiente or Rechazada and email you the list.

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 my contracts” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "community.secop.gov.co/get_my_contracts",
    "input": {
      "estado": "Pendiente de firma"
    }
  }'

{
  "status": "completed",
  "data": {
    "contracts": [
      {
        "contract_number": "CO1.PCCNTR.0000001",
        "entidad_estatal": "Acme Municipal Water Utility",
        "end_date": "2027-06-30",
        "contract_value": 184500000,
        "currency": "COP",
        "estado": "Pendiente de firma"
      }
    ],
    "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.

SECOP II’s own options

Colombia Compra Eficiente publishes SECOP II's processes and contracts as open data on datos.gov.co, updated daily and readable through each dataset's JSON API, without signing in. It covers public records of every entity, not your own workspace. Offers are submitted only through SECOP II, and contract approval, garantías and payment requests are done there too.

Read on November 12, 2026: Conjuntos de datos abiertos (Colombia Compra Eficiente), Guía: Presentar ofertas en el SECOP II, Guía: Gestión contractual en el SECOP II.

Signing in to SECOP II

Colombia Compra Eficiente's guides tell suppliers to sign in to SECOP II with their user name and password, and each user is personal to its holder. A supplier account has its own users. With Fous you sign in once through SECOP II's own sign-in with your own user: the login is sealed with AES-256, code and AI agents never see it, and an expired session is signed back in.

Worth knowing

Only the signatory may approve

Aprobar contrato and Aplicar modificación must be clicked by the user entitled to sign (legal representative or proxy). If another user approves, the entity rejects the contract and sends it again.

File the invoice with the entity first

Before you load an invoice in SECOP II, you file it with the entity and get a número de radicación. The payment request asks for that number.

A rejected guarantee gets a new reference

When the entity rejects a garantía, the guide asks you to add it again with Agregar under a new reference, so the contract keeps its history.

Offers close with the clock

The process workspace shows a countdown, and an offer cannot be sent once it reaches zero. You must select Suscribirme on a process before you can take any action in it as a supplier.

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
• 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)
• DIAN MUISCA

Other industries: Egyptian Tax Authority e-Services, Plataforma de Contratación del Sector Público, MOT Testing Service, Florida Courts E-Filing Portal, LMS Conveyancer Zone, CM/ECF.