Logo

Developer Documentation

Endpoint Reference
Ready to start building?
To execute API requests, you need a valid key. Get started in two steps:
  1. Create a free account and log in to eLoadcontrol.
  2. Navigate to Settings > Developer to enable developer access and generate your free test key.

Integrate the eLoadcontrol Weight & Balance engine directly into your Virtual Airline or dispatch tool.

Architecture: "Bring Your Own Key" (BYOK)

eLoadcontrol operates on a decentralized BYOK model, meaning your Virtual Airline does not pay for API usage.

1. Development: Use your personal Developer Sandbox key (above) to build and test your integration.
2. Production: Create a text field in your dispatch UI for your pilots. They simply paste their personal Pro License Key into your system, and you pass that key dynamically in the headers below.

Authentication (Required Headers)

  • Content-Type: application/json
  • x-api-key: <PILOT_PRO_KEY>
1. Database & Reference Endpoints

GET https://eloadcontrol.com/api/v1/airlines

Returns a list of all supported airlines and their associated IATA/ICAO codes.

GET https://eloadcontrol.com/api/v1/formats

Returns a list of available visual loadsheet templates. Use the templateId in your core requests.

GET https://eloadcontrol.com/api/v1/aircraft

Returns your entire available fleet. Each aircraft includes a nested array of its valid availableCabinConfigs.

Query Parameters

Parameter Description
identifier
Optional (String) 		Filter the fleet to retrieve configurations for a specific aircraft type (ICAO or IATA).
Example: https://eloadcontrol.com/api/v1/aircraft?identifier=B738

Example JSON Response

{
  "success": true,
  "count": 1,
  "data": [
    {
      "icao": "B738",
      "iata": "737",
      "type": "Boeing 737-800",
      "model": "737-800",
      "availableCabinConfigs": [
        "F12Y148",
        "Y184",
        "Y189"
      ]
    }
  ]
}
2. Core Engine Endpoints
Highly Recommended Integration Instead of mapping weights manually, pass the pilot's SimBrief username. The eLoadcontrol server will automatically fetch the OFP, parse all weights, apply dynamic performance limits, and generate the loadsheet instantly.

POST https://eloadcontrol.com/api/v1/generate-from-simbrief

The premium automated engine shortcut.

Example JSON Request Body

{
  "simbriefUsername": "SimBriefUser123",
  "cabinConfig": "Y189", 
  "loadsheetFormat": "standard_iata"
}

POST https://eloadcontrol.com/api/v1/generate-loadsheet

The raw dispatch engine. Use this if your Virtual Airline utilizes a custom dispatch system rather than SimBrief. You must manually map and provide all flight weights.

Example JSON Request Body

{
  "airline": "RYR",
  "flightNumber": "1942",
  "departure": "EHAM",
  "destination": "EGLL",
  "type": "B738",
  "aircraftReg": "EI-DCL",
  "cabinConfig": "Y189", 
  "loadsheetFormat": "standard_iata",
  "BOW": 42264,
  "cargo": 2100,
  "paxY": 140,
  "paxWeight": 86,
  "crewAmount": "02/04",
  "blockFuel": 7500,
  "taxiFuel": 200,
  "tripFuel": 4100,
  "tripTime": "0130",
  "taxiTime": "0020",
  "date": "28MAR26",
  "departureTime": "1200",
  "editionNumber": 1
}

POST https://eloadcontrol.com/api/v1/calculate-cg

A lightweight engine. Provide flight weights, and the API returns the precise Center of Gravity (CG) percentages for ZFW, TOW, and LDW, along with the structural envelope coordinates. Ideal for drawing interactive charts.

3. Dispatch & Connectivity

POST https://eloadcontrol.com/api/v1/send-acars

Dispatches an ACARS telex message directly to an aircraft in the simulator via the Hoppie network. Note: The API intelligently looks up the correct ICAO routing code based on the operator and flight number you provide.

Example JSON Request Body

{
  "logonCode": "your_hoppie_code",
  "operator": "RYR",
  "flightNumber": "1942",
  "acarsMessage": "The raw telex string received from the generate endpoint"
}

Example JSON Response (Success)

{
  "success": true,
  "message": "ACARS message dispatched to Hoppie network.",
  "hoppieResponse": "ok"
}