Enterprise-Grade API
Built for developers who need reliable, fast, and comprehensive maritime data
RESTful* API
Simple, modern REST API with JSON or XML responses: your choice.
* REpresentational State Transfer - a set of rules defining good API practices. More details here (Opens in a new browser window)
Documentation
Comprehensive API documentation with many examples.
Example source code is available. The web ap[plication is written in C# and runs under the Microsoft dotNet platform.
Global Availability
Connect from anywhere with public internet access.
BRL has a minimum 99.99% uptime service-level agreement with its hosting services provider.
Real-time Access
Direct access to our database with instant data retrieval for Pending Contracts, Newbuildings and fleet ships
Swagger Interface
Use Swagger to learn how to use and test the API without requirement for specialised software
Secure Authentication
Industry-standard API using twin (unguessable) key authentication over an encrypted connection.
RESTful API Endpoints
Access the latest BRL data through our comprehensive REST API. Simple, intuitive endpoints with powerful filtering, pagination, and search capabilities. APIs are designed to be accessed by programs, not humans. Your software team will be familiar with API methods and will appreciate the simplicity and power of the BRL API interface which conforms with REST standards.
/brl/v=1.0/f=JSON/Ship/Detailed
?Scope=fleet&kind=BulkCarrier
&incSales=true&incEngines=trueMeaning: List Fleet Bulk Carriers using JSON format and include engine details and sales events
/brl/v=1.0/f=XML/Ship/Detailed
?Scope=orderbook&kind=Tanker
&incEngines=true&paging=take:50Meaning: List 50 tankers under construction using XML format with engine details
/brl/v=1.0/f=JSON/Ship/Detailed
?imoList=7387122,601795,7024902,8214607,7928251Meaning: List details of the ships with IMO numbers in the list. Output using JSON format.
/brl/v=1.0/f=XML/Ship/Detailed
?Scope=fleet&kind=BulkCarrier
&filter=DWT|GT|275000&paging=take:100Meaning: List 100 fleet bulk carriers with DWT greater than 275,000 tonnes. Output is presented in XML format.
/brl/v=1.0/f=JSON/Ship/Detailed?Delivered=MO|3Meaning: List ships delivered in the past three months.
// Javascript Example: Fetch newbuilding orders:
// Include engines and gear, Output in json format.fetch('https://api.brldata.com
/brl/v=1.0/f=JSON/Ship/Detailed
?Scope=orderbook&kind=Tanker
&incEngines=true&incNotes=true&incGear=true'
{ // Security Headers
headers: {
'X-BRL_ACCESS_KEY': 'ABCDEF99-8E44-4095-9E25-6CE7BB50E825',
'X-BRL_SUBSCRIBER_KEY': '00FEDCBA-72B0-4AE3-AA57-DC3B54D9CFA5',
' X-BRL_VERSION': '1.0' })
// Get the data
.then(response => response.json())
.then(data => {
console.log(data.vessels);
});// C# Example: Fetch newbuilding orders:
// Include engines, notes and gear, Output in json format.{
// Security Headers
Headers.Add("X-BRL_ACCESS_KEY", "ABCDEF99-....-6CE7BB50E825");
Headers.Add("X-BRL_SUBSCRIBER_KEY", "00FEDCBA-....-DC3B54D9CFA5");
Headers.Add(" X-BRL_VERSION", "1.0"); };
url = "https://api.brldata.com ...
.../brl/v=1.0/f=JSON/Ship/Detailed?Scope=orderbook&kind=Tanker ...
...&incEngines=true&incNotes=true&incGear=true"
// Get the data
HttpResponseMessage? response = await client.GetAsync(url);
}// Curl Example: Fetch newbuilding orders:
// Include engines, notes, and gear, Output in json format.
C:\ > curl --location 'https://api.brldata.com ...
.../brl/v=1.0/f=JSON/Ship/Detailed?Scope=orderbook&kind=Tanker ...
...&incEngines=true&incNotes=true&incGear=true' \
--header 'X-BRL_ACCESS_KEY: ABCDEF99-....-6CE7BB50E825' \
--header 'X-BRL_SUBSCRIBER_KEY: BCDEF99-....-6CE7BB50E825' \
--header 'X-BRL_VERSION: 1.0'
Perfect For...
Custom Applications
Build custom dashboards and applications with direct access to maritime data
Workflow Automation
Automate data collection and analysis in your existing business processes
Data
Integration
Seamlessly integrate BRL data into your enterprise systems and data warehouses
Statistics Integration
Feed aggregated data directly into your documents and spreadsheets