---
updatedAt: 2026-08-18T07:27:09.000Z
agentTools:
  projectIndex: https://docs.toqua.ai/llms.txt
---

# Retrieve the measured dual-fuel split vs load data for a ship

Returns the raw measured dual-fuel split per engine load: for every operational-data row within the selected period **start_datetime** to**end_datetime** (defaulting to the last 365 days) where both a fuel-oil(pilot) and a gas (main) fuel were in use, x = load (fraction of MCR) andy = the pilot fuel's share of total main engine fuel consumption (0-1).- **start_datetime**: ISO-8601 start of the period (default: 365 days ago).- **end_datetime**: ISO-8601 end of the period (default: now).This is the data behind a vessel's dual-fuel split tables; it is available before any split table has been configured.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Toqua API",
    "contact": {
      "name": "Toqua",
      "url": "https://toqua.ai/",
      "email": "admin@toqua.ai"
    },
    "version": "0.26"
  },
  "servers": [
    {
      "url": "https://api.toqua.ai",
      "description": "Toqua API"
    }
  ],
  "paths": {
    "/performance/{imo_number}/main-engine/fuel-split-vs-load": {
      "get": {
        "tags": [
          "Performance"
        ],
        "summary": "Retrieve the measured dual-fuel split vs load data for a ship",
        "description": "Returns the raw measured dual-fuel split per engine load: for every operational-data row within the selected period **start_datetime** to**end_datetime** (defaulting to the last 365 days) where both a fuel-oil(pilot) and a gas (main) fuel were in use, x = load (fraction of MCR) andy = the pilot fuel's share of total main engine fuel consumption (0-1).- **start_datetime**: ISO-8601 start of the period (default: 365 days ago).- **end_datetime**: ISO-8601 end of the period (default: now).This is the data behind a vessel's dual-fuel split tables; it is available before any split table has been configured.",
        "operationId": "get_main_engine_fuel_split_vs_load",
        "security": [
          {
            "APIKeyHeader": []
          },
          {
            "HTTPBearer": []
          }
        ],
        "parameters": [
          {
            "name": "imo_number",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Imo Number"
            }
          },
          {
            "name": "start_datetime",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Datetime"
            }
          },
          {
            "name": "end_datetime",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Datetime"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMainEngineFuelSplitVsLoadResponse"
                }
              }
            }
          },
          "404": {
            "description": "Not Found"
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          },
          "501": {
            "description": "Not Implemented"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "GetMainEngineFuelSplitVsLoadResponse": {
        "properties": {
          "sensor_fuel_split_vs_load": {
            "items": {
              "$ref": "#/components/schemas/GraphDataPoint_float_float_"
            },
            "type": "array",
            "title": "Sensor Fuel Split vs Load",
            "description": "From sensor data: x = load (fraction of MCR, 0-1), y = pilot fuel share of total main engine fuel consumption (mass fraction, 0-1)."
          },
          "nr_fuel_split_vs_load": {
            "items": {
              "$ref": "#/components/schemas/GraphDataPoint_float_float_"
            },
            "type": "array",
            "title": "NR Fuel Split vs Load",
            "description": "From noon report data: x = load (fraction of MCR, 0-1), y = pilot fuel share of total main engine fuel consumption (mass fraction, 0-1)."
          },
          "pilot_fuel_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pilot Fuel Type",
            "description": "Most frequently reported main engine (pilot) fuel type in the period."
          },
          "main_fuel_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Main Fuel Type",
            "description": "Most frequently reported main engine gas (main) fuel type in the period."
          }
        },
        "type": "object",
        "required": [
          "sensor_fuel_split_vs_load",
          "nr_fuel_split_vs_load",
          "pilot_fuel_type",
          "main_fuel_type"
        ],
        "title": "GetMainEngineFuelSplitVsLoadResponse",
        "description": "Raw measured dual-fuel split data: the pilot fuel's share of total main\nengine fuel consumption per engine load, from operational data rows where\nboth a fuel-oil and a gas consumption were reported."
      },
      "GraphDataPoint_float_float_": {
        "properties": {
          "x": {
            "type": "number",
            "title": "X",
            "description": "The x-value of the data point."
          },
          "y": {
            "type": "number",
            "title": "Y",
            "description": "The y-value of the data point."
          }
        },
        "type": "object",
        "required": [
          "x",
          "y"
        ],
        "title": "GraphDataPoint[float, float]"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "APIKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      },
      "HTTPBearer": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "externalDocs": {
    "description": "API Documentation",
    "url": "https://docs.toqua.ai"
  }
}
```