Get your TRIBU-CR declarations and tax account by API

What you can build on TRIBU-CR

• Get pending declarations

  Build this

  Reads the Pendientes tab under Declaraciones for one taxpayer: each form still to file, its period, its filing window and whether a Borrador (draft) exists.

  Takes

  Taxpayer identification, declaration name (optional)

  Returns

  Period, type, declaration, filing window start and end, status

• List filed declarations

  Build this

  Reads the Realizadas tab under Declaraciones, filtered by declaration name, type, period, status or Pagada (paid), and returns each declaration filed.

  Takes

  Taxpayer identification, period, declaration name (optional), paid (optional)

  Returns

  Declaration number, period, type, declaration, filing window, status, paid

• Read the Cuenta tributaria

  Build this

  Reads the Cuenta tributaria (tax account) for one taxpayer, under Deuda pendiente (amounts owed), Créditos disponibles (credits) or Cancelados (paid).

  Takes

  Taxpayer identification, balance type

  Returns

  Period, tax, amount, status, balance type

• Pay a pending debt from a registered account

  Build this

  Opens Pagar, selects one declaration's debt, sets the amount, chooses Pago con cuenta IBAN and the bank account, and confirms with Pagar.

  Takes

  Taxpayer identification, declaration and period, amount (optional), IBAN account

  Returns

  Declaration, period, amount paid, payment status

Automate TRIBU-CR 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.

• Declarations due in the next 14 days, for each taxpayer

  Build this

  Starts

  Every Monday at 7:00 in Costa Rica time

  Step 1

  For each taxpayer you name, get the pending declarations from the Pendientes tab.

  Step 2

  Keep the rows whose filing window ends within the next 14 days.

  Step 3

  Email you the list, one section per taxpayer, with declaration, period and deadline.

• New Deuda pendiente, posted to your accounting system

  Build this

  Starts

  Every weekday at 8:00 in Costa Rica time

  Step 1

  For each taxpayer, read the Deuda pendiente tab of the Cuenta tributaria.

  Step 2

  Keep the debts that were not there on the last run.

  Step 3

  Post each one, with period, tax and amount, to your accounting system's webhook.

• VAT filing check after the monthly deadline

  Build this

  Starts

  Every month on the 16th at 9:00 in Costa Rica time

  Step 1

  For each taxpayer, list the filed declarations for last month's period.

  Step 2

  Keep the taxpayers with no 150 - Impuesto al valor agregado declaration, or one not marked as paid.

  Step 3

  Email you the taxpayers to follow up, with status and paid flag.

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 pending declarations” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ovitribucr.hacienda.go.cr/get_pending_declarations",
    "input": {
      "taxpayer_id": "3101000000"
    }
  }'

{
  "status": "completed",
  "data": {
    "taxpayer_id": "3101000000",
    "taxpayer_name": "Northwind Servicios S.A.",
    "declarations": [
      {
        "period": "202610",
        "type": "Autoliquidativa Original",
        "declaration": "150 - Impuesto al valor agregado",
        "window_start": "2026-11-01",
        "window_end": "2026-11-15",
        "status": null
      }
    ],
    "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.

TRIBU-CR’s own options

Hacienda documents an API for comprobantes electrónicos: it receives signed invoices and receiver responses, reports their status and lists the comprobantes you have sent. Declarations, the Cuenta tributaria and payments are not part of it: you work with them in the Oficina Virtual (OVi).

Read on November 12, 2026: API de Comprobantes Electrónicos, Guías rápidas paso a paso para OVi y TRIBU-CR, TRIBU-CR at Ministerio de Hacienda.

Signing in to TRIBU-CR

On the Ingrese a su OVi screen you sign in with Usuario y contraseña (your identification and password) and a validation code sent to your registered email and mobile phone, or with Firma digital. With Fous you sign in once through TRIBU-CR's own sign-in with your own account: the login is sealed with AES-256, the emailed code is handled, and an expired session is signed back in.

Worth knowing

Users are people, companies act through them

An OVi user is created once by a natural person, who enters as Titular, Representante Legal or Autorizado. A titular grants an autorizado chosen services, and the autorizado picks the taxpayer's profile after signing in.

The password lasts 6 months

A TRIBU-CR password has at least 14 characters, cannot repeat any of the last three, and is valid for 6 months. Plan for the renewal so scheduled runs keep working.

Filed declarations are corrected, not deleted

A filed declaration cannot be deleted: you file a declaración rectificativa with Rectificar. Forms are saved as Borrador automatically and wait in Pendientes until you press Presentar.

Payment is by DTR only

Débito en Tiempo Real, from a bank account registered in the OVi, is the only payment method there. A partial payment has to cover at least the legal interest, when it applies.

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)
• Declaraciones y Pagos (SAT)
• DIAN MUISCA

Other industries: uFiling, UETS, net-entreprises.fr, Texas811 Portal, Mercury Network, NetDMR.