Register
Register to the developer portal to use the Echo API
Get your API key
Use your API key to authenticate and report the calls you make
Create your app
Start coding and create awesome applications with the Echo API
Why use
our portal?
With our APIs, you can easily integrate your applications with Panama Canal services.
Explore our Data
Maritime Operations API
Retrieve historical operational records related to vessel transits through the Panama Canal. This API supports queries on transit counts, arrival records, and estimated transit times, based on vessel type, size, and date ranges.
Hydrology API
Access hydrological monitoring data from the Canal?s watershed system. This includes precipitation and temperature records from environmental monitoring stations. The API enables querying by location and time range for analytical use.
Meteorology API
Retrieve atmospheric condition data relevant to Canal operations. This includes temperature and humidity values, structured by station location and measurement metadata.
Commercial Info API
Get aggregated commercial data related to cargo traffic through the Panama Canal. Designed for economic analysis, this API provides volume insights segmented by vessel characteristics and transit filters.
Robust and Secure APIs
Our APIs are designed to simplify integration with authoritative Panama Canal data.
Whether you're building analytics platforms, logistic solutions, or new digital services, our APIs offer consistent access to curated datasets with a high degree of reliability.
- Why it matters:
-
- Built and maintained by the Canal?s own integration experts
- High availability through a modern cloud-based platform
- Designed for seamless connectivity with your applications
Focus on building value ? we take care of the plumbing.
Detailed and Updated Documentation
Every API product comes with clear, concise, and continuously updated documentation to accelerate your development.
We include real-world examples, request and response templates, and step-by-step usage guides ? no guesswork involved.
- You'll get:
-
- Clear descriptions of available datasets
- Sample requests and responses
- Downloadable Postman collections
- ?Try it out? options available in our Developer Portal
Everything you need to start building ? without delays.
Sepecialized Technical Support
We offer personalized onboarding and support to ensure your success with our APIs.
From first-time developers to enterprise clients, our support team helps you understand how to use our data effectively.
- What we offer:
-
- Direct assistance from our API experts
- Onboarding sessions for enterprise integrations
- Best practices and integration examples
- Support in both English and Spanish
We?re here to help you go from idea to implementation ? faster.
Maritime Operations API - How it Works
- Step-by-step guide to retrieve operational insights:
-
- Access the Developer Portal and subscribe to the Operations API
- Generate your
Client IDandClient Secretwithin your app - Obtain a bearer token via our OpenID Connect
/tokenendpoint - Use this token to authenticate your requests
- Available endpoints:
/operations/v1/vessel-arrivals: Historical ETA and vessel info/operations/v1/transit-count: Daily number of transits/operations/v1/transit-times: Estimated durations per transit route
- Include headers:
Authorization: Bearer {access_token}Content-Type: application/json
- Structure your POST body with required parameters like
start_date,vessel_type,originPort,destinationPort, etc.
Useful for logistics optimization, forecasting, and maritime analytics.
Hydrology API - How it Works
- Accessing Panama Canal watershed data in 7 steps:
-
- Sign into the Developer Portal and select the Hydrology API
- Register your application to obtain credentials
- Use your credentials to get an OAuth2 bearer token
- Make authenticated requests to:
/hydrology/v1/precipitation/hydrology/v1/temperature
- POST body must include:
locationId,startTime,endTime, and measurement details
- The
headerRequestobject must be populated (example provided in documentation) - Results include timestamps, location metadata, and measurement units
All data reflects historical measurements and is suitable for research, environmental analysis, or water resource management.
Meteorology API - How it Works
- Steps to consume historical meteorological data:
-
- Join the Developer Portal and subscribe to the Meteorology API
- Retrieve your app credentials (Client ID & Secret)
- Generate an access token via our authentication endpoint
- Call one of the available endpoints:
/meteorology/v1/temperature/meteorology/v1/humidity
- Your POST body must include device and location metadata:
locationId,measurementTime,measurementUnit, etc.
- Use a valid bearer token in the
Authorizationheader - All responses return structured meteorological readings
Designed to support impact assessments, planning, and environmental studies.
Commercial Info API - How it Works
- Step-by-step guide to access cargo volume data:
-
- Log in to the Panama Canal Developer Portal
- Subscribe to the Commercial Info API product and select a plan (Free, Basic, or Premium)
- Copy your Client ID and Client Secret from your registered application
- Get an access token using the
/tokenendpoint from our Keycloak identity provider - Use the token to authenticate your requests (Bearer token)
- Call the
/commercial/v1/cargo-volumesendpoint using thePOSTmethod - Filter your query using parameters like:
transitDateFrom/transitDateTovesselSize,vesselTypelockageType
All responses are returned in JSON format. Ensure your application handles authentication token refresh logic as needed.
Hits