Turn VUMPA into an API for your vessel visits

What you can build on VUMPA

• Get my visits and pending items

  Build this

  Reads My Visits and Information Compliance: each vessel visit, its status and the information requirements that still have pending items.

  Takes

  Nothing, or a vessel name, SIN or IMO number

  Returns

  Visit number, vessel name, SIN, IMO number, service order, port of arrival, ETA, visit status, pending items

• Check a visit's transactions

  Build this

  Finds a visit in Visit Management and reads its Transactions list: each booking, swap, substitution or cancellation request and where it stands.

  Takes

  Service order number, SIN, visit number or IMO number

  Returns

  Visit number, vessel name, transaction type, booking date, submitted at, status

• Get a visit's invoices and credit memos

  Build this

  Reads the financial information for one visit: quotations, invoices and credit memos for the services requested.

  Takes

  Service order number, SIN or visit number

  Returns

  Visit number, vessel name, document type, document number, date, service, amount, currency

• Request a transit booking

  Build this

  Opens a visit in Visit Management, selects BOOK on Service Overview, chooses Booking Request, enters the Booking Date, certifies and submits.

  Takes

  Service order number or SIN, booking date

  Returns

  Visit number, vessel name, booking date, confirmation message, transaction status

Automate VUMPA 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.

• Visits with pending information, before the 96-hour deadline

  Build this

  Starts

  Every day at 7:00, Panama time

  Step 1

  Get your visits and their pending items from My Visits and Information Compliance.

  Step 2

  Keep the visits whose ETA is within the next 5 days and that still have pending items.

  Step 3

  Email you the list, with vessel name, SIN, ETA and what is missing.

• Booking request statuses that changed

  Build this

  Starts

  Every hour

  Step 1

  For each open visit, check its Transactions list.

  Step 2

  Keep the transactions whose status changed since the last run.

  Step 3

  Post each one, with vessel name, transaction type, booking date and status, to your webhook.

• New invoices and credit memos, sent to accounting

  Build this

  Starts

  Every weekday at 17:00, Panama time

  Step 1

  For each of your visits, get the invoices and credit memos.

  Step 2

  Keep the documents that were not there on the last run, and stop when there are none.

  Step 3

  Post document number, visit, vessel, service, amount and currency to your accounting webhook.

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 visits and pending items” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "vumpa.gob.pa/get_my_visits",
    "input": {
      "vessel_name": "Northwind"
    }
  }'

{
  "status": "completed",
  "data": {
    "visits": [
      {
        "visit_number": "V-204418",
        "vessel_name": "Northwind Spirit",
        "sin": "N4417",
        "imo_number": "9999991",
        "service_order": "SO-771203",
        "port_of_arrival": "Balboa",
        "eta": "2026-11-15T06:00:00-05:00",
        "status": "Pending",
        "pending_items": [
          "Vessel Cargo Declaration"
        ]
      }
    ],
    "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.

VUMPA’s own options

The Canal authority offers VUMPA's web portal and a Business-to-Business Gateway. The gateway takes EDIFACT or XML messages over the internet, with a secure FTP option, in its own PC-ADR format, for three forms only: cargo, crew and officer, and passenger declarations. Getting it means a request, an accreditation of 30 to 60 days and four stages of testing. Everything else is done in the portal.

Read on November 12, 2026: OP Notice to Shipping N-3-2026, Communication on Transit Activities, Quick Guides, Transit Reservation System (April 2025), Vessel ETA and transit booking.

Signing in to VUMPA

The SIGN IN button on VUMPA opens a Microsoft sign-in page, and each user's access is approved by the sponsor of their company's customer or agent code. With Fous you sign in once through that same sign-in with your own account. The login is sealed with AES-256, never returned by the API or written to logs, and a method reads and does only what your account can.

Worth knowing

Your sponsor controls who gets in

Each customer or agent code holder has a sponsor account. Only the sponsor approves access package requests, and more users than your company's allowance need an emailed request with a justification.

Information is due 96 hours before arrival

Visit information is required 96 hours before arrival. For a second transit in the same visit, it is due 12 hours before the next scheduled transit.

BAPLIE by 09:00 the day after transit

The BAPLIE file is due by 09:00 the day after the transit date. A late file means the variable toll is based on the total TEU allowance (TTA). Extensions use a BAPLIE Late Verification Request, at extra charge.

A booking request carries a certification

A booking request is submitted with a certification that the information is true and that your principal authorized the booking. Its status then shows in Transactions.

More in Maritime and aviation

• Avinode Marketplace
• CAMP MTX
• MyBoeingFleet
• Satair Market
• IATA SIS
• Online Coordination System
• eGCA
• myWorld Web
• ILSmart
• Collins Aerospace Customer Portal
• Honeywell MyAerospace
• MARS
• LeShuttle Freight
• ABS MyFreedom
• ClassNK Customer Hub
• DNV Fleet Status
• LR Class Direct
• MOVE by Bureau Veritas
• myGEAerospace
• DFDS freight booking
• P&O Ferries Freight
• Stena Line Freight Portal
• EUROCONTROL NOP Portal
• Baltic Exchange
• 海事一网通办
• National Maritime Single Window
• Inaportnet
• DA-Desk
• Marine Department eBS
• DG Shipping e-Governance
• DMW Online Services
• OCIMF SIRE 2.0
• eNOAD
• Q88
• RightShip Platform

Other industries: Buildium, KinderConnect, myUNFI, REWE Group Supplier Portal, TD SYNNEX ECExpress, Checkatrade.