/v1/cp-warranty.json

GET

/v1/cp-warranty.json

Post Voyage CP Warranty Data

Item	Value
Format	JSON
Region	Global
Update	When Audit result is published in SeaNavigator
Max Results	2000 segments per request

System update — June 2026: The backend system for this API has been renewed.
The response structure (all field names) is unchanged, but the following fields are
no longer populated under the new system:
rpm and slip are returned as null; is_warranted, comment.red /
comment.yellow / comment.blue, and outside_eca.entire_perf_speed /
inside_eca.entire_perf_speed are returned as an empty string ("").
See the per-field notes below for the exact value of each.

Field definitions

Field Name	Description	Unit/Format	Type
ship_name	Ship name	-	String
imo_num	IMO number	-	String
voy_num	Voyage number	-	String
loading_condition	Loading condition: L = Laden, B = Ballast	-	String
eco_speed	Eco speed indicator: E = Eco speed operation, R = RPM-specified, U or empty = Unknown	-	String
seg	Segment number within the voyage (split voyages have multiple segments)	-	Integer
dep_port	Departure port (UN/LOCODE or port name)	-	String
atd	Actual time of departure	YYYY/MM/DDTHH:MM:SS	String
arr_port	Arrival port (UN/LOCODE or port name)	-	String
ata	Actual time of arrival	YYYY/MM/DDTHH:MM:SS	String
loss_saving.time	Time loss/saving vs CP schedule. Positive = time lost, Negative = time saved. null when not calculable	hours	String|null
loss_saving.fo	FO loss/saving vs CP. Positive = over-consumption (loss), Negative = under-consumption (saving)	MT	String
loss_saving.do	DO loss/saving vs CP. Positive = over-consumption (loss), Negative = under-consumption (saving)	MT	String
loss_saving.fuel_unit	[Fixed: "MT"] Fuel unit	MT	String
is_warranted	[Fixed: ""] Warranted flag — not available in current system	-	String
comment.red	[Fixed: ""] Red comment	-	String
comment.yellow	[Fixed: ""] Yellow comment	-	String
comment.blue	[Fixed: ""] Blue comment	-	String
outside_eca.goodwx_dist	Sailing distance during good weather, outside ECA	NM	String
outside_eca.goodwx_time	Sailing time during good weather, outside ECA	hours	String
outside_eca.goodwx_avg_speed	Average speed during good weather, outside ECA	knots	String
outside_eca.goodwx_current	Current factor (current speed effect) during good weather, outside ECA	knots	String
outside_eca.goodwx_perf_speed	Performance speed (current-corrected) during good weather, outside ECA	knots	String
outside_eca.goodwx_total_fo	Total FO consumption during good weather, outside ECA	MT	String
outside_eca.goodwx_total_do	Total DO consumption during good weather, outside ECA	MT	String
outside_eca.goodwx_daily_fo	Daily average FO consumption during good weather, outside ECA	MT/day	String
outside_eca.goodwx_daily_do	Daily average DO consumption during good weather, outside ECA	MT/day	String
outside_eca.entire_dist	Total sailing distance (all weather), outside ECA	NM	String
outside_eca.entire_time	Total sailing time (all weather), outside ECA	hours	String
outside_eca.entire_avg_speed	Average speed (all weather), outside ECA	knots	String
outside_eca.entire_current	Current factor (all weather), outside ECA	knots	String
outside_eca.entire_perf_speed	[Fixed: ""] Performance speed (all weather), outside ECA — not available in current system	knots	String
outside_eca.entire_total_fo	Total FO consumption (all weather), outside ECA	MT	String
outside_eca.entire_total_do	Total DO consumption (all weather), outside ECA	MT	String
outside_eca.entire_daily_fo	Daily average FO consumption (all weather), outside ECA	MT/day	String
outside_eca.entire_daily_do	Daily average DO consumption (all weather), outside ECA	MT/day	String
inside_eca.goodwx_dist	Sailing distance during good weather, inside ECA. "" when no ECA passage	NM	String
inside_eca.goodwx_time	Sailing time during good weather, inside ECA. "" when no ECA passage	hours	String
inside_eca.goodwx_avg_speed	Average speed during good weather, inside ECA	knots	String
inside_eca.goodwx_current	Current factor during good weather, inside ECA	knots	String
inside_eca.goodwx_perf_speed	Performance speed during good weather, inside ECA	knots	String
inside_eca.goodwx_total_fo	Total FO consumption during good weather, inside ECA	MT	String
inside_eca.goodwx_total_do	Total DO consumption during good weather, inside ECA	MT	String
inside_eca.goodwx_daily_fo	Daily average FO consumption during good weather, inside ECA	MT/day	String
inside_eca.goodwx_daily_do	Daily average DO consumption during good weather, inside ECA	MT/day	String
inside_eca.entire_dist	Total sailing distance (all weather), inside ECA. "" when no ECA passage	NM	String
inside_eca.entire_time	Total sailing time (all weather), inside ECA. "" when no ECA passage	hours	String
inside_eca.entire_avg_speed	Average speed (all weather), inside ECA	knots	String
inside_eca.entire_current	Current factor (all weather), inside ECA	knots	String
inside_eca.entire_perf_speed	[Fixed: ""] Performance speed (all weather), inside ECA — not available in current system	knots	String
inside_eca.entire_total_fo	Total FO consumption (all weather), inside ECA	MT	String
inside_eca.entire_total_do	Total DO consumption (all weather), inside ECA	MT	String
inside_eca.entire_daily_fo	Daily average FO consumption (all weather), inside ECA	MT/day	String
inside_eca.entire_daily_do	Daily average DO consumption (all weather), inside ECA	MT/day	String
goodwx_definition.goodwx_wind	Good weather wind speed threshold defined in the CP. Legacy field — prefer goodwx_windspeed	knots	String
goodwx_definition.goodwx_bf	Good weather Beaufort scale threshold defined in the CP. "" if not used as criterion	Beaufort	String
goodwx_definition.goodwx_windspeed	Good weather wind speed threshold defined in the CP. "" if not used as criterion	knots	String
goodwx_definition.goodwx_dss	Good weather Douglas Sea Scale threshold defined in the CP. "" if not used	-	String
goodwx_definition.goodwx_sigwave	Good weather significant wave height threshold defined in the CP. "" if not used	meter	String
goodwx_definition.goodwx_windsea	Good weather wind wave height threshold defined in the CP. "" if not used as criterion	meter	String
goodwx_definition.gooodwx_swell	Good weather swell height threshold defined in the CP. "" if not used. Note: field name has triple 'o' — intentional for backward compatibility	meter	String
goodwx_definition.goodwx_current	Current condition used for good weather assessment (e.g., "All" = all directions considered)	-	String
warranted.speed	CP-warranted speed	knots	String
warranted.fo	CP-warranted FO consumption	MT/day	String
warranted.do	CP-warranted DO consumption	MT/day	String
allowance.speed	Speed allowance (tolerance applied to warranted speed before judging performance)	knots	String
allowance.fo	FO allowance (tolerance applied to warranted FO). Unit is defined by fuel_unit	see fuel_unit	String
allowance.do	DO allowance (tolerance applied to warranted DO). Unit is defined by fuel_unit	see fuel_unit	String
allowance.speed_unit	Unit for speed allowance (typically "kts")	-	String
allowance.fuel_unit	Unit for fuel allowance: "%" = percentage of warranted value, "MT" = absolute tons	-	String
rpm	[Fixed: null] Engine RPM — not available in current system	-	null
slip	[Fixed: null] Propeller slip — not available in current system	%	null
co2_fo	CO2 from FO. Calculated as total FO consumption (outside_eca + inside_eca) × 3.1144. null if no data	mt-CO2	Number|null
co2_do	CO2 from DO. Calculated as total DO consumption (outside_eca + inside_eca) × 3.206. null if no data	mt-CO2	Number|null
id	Unique audit record ID. Identifies this specific CP warranty assessment result	-	String

Parameters

Query Parameters

ships

Comma-separated IMO numbers (7 digits each, max 20). Omit to return all ships for your account.

Typestring

Example9453810,9882994

start_time

Start date (YYYYMMDD). Default: 12 months ago.

Typestring

Example20260101

end_time

End date (YYYYMMDD). Default: today.

Typestring

Example20260601

last_x_months

Return data for the last N months (1–48). Default: 12. Cannot be used together with start_time/end_time.

Typeinteger

Example6

minimum1

maximum48

Responses

Success

Content-Type

application/json

[

{

"ship_name": "PACIFIC STAR",

"imo_num": "9453810",

"voy_num": "024N",

"loading_condition": "L",

"eco_speed": "U",

"seg": 1,

"dep_port": "JPYOK",

"atd": "2024/01/03T08:42:00",

"arr_port": "USLAX",

"ata": "2024/01/18T14:17:00",

"loss_saving": {

"time": "24.07",

"fo": "35.71",

"do": "0",

"fuel_unit": "MT"

},

"is_warranted": "",

"comment": {

"red": "",

"yellow": "",

"blue": ""

},

"outside_eca": {

"goodwx_dist": "3412",

"goodwx_time": "231.7",

"goodwx_avg_speed": "14.73",

"goodwx_current": "0.21",

"goodwx_perf_speed": "14.52",

"goodwx_total_fo": "412.3",

"goodwx_total_do": "13.8",

"goodwx_daily_fo": "42.69",

"goodwx_daily_do": "1.43",

"entire_dist": "3687",

"entire_time": "362.4",

"entire_avg_speed": "13.31",

"entire_current": "0.16",

"entire_perf_speed": "",

"entire_total_fo": "596.1",

"entire_total_do": "19.4",

"entire_daily_fo": "39.42",

"entire_daily_do": "1.28"

},

"inside_eca": {

"goodwx_dist": "",

"goodwx_time": "",

"goodwx_avg_speed": "",

"goodwx_current": "",

"goodwx_perf_speed": "",

"goodwx_total_fo": "",

"goodwx_total_do": "",

"goodwx_daily_fo": "",

"goodwx_daily_do": "",

"entire_dist": "",

"entire_time": "",

"entire_avg_speed": "",

"entire_current": "",

"entire_perf_speed": "",

"entire_total_fo": "",

"entire_total_do": "",

"entire_daily_fo": "",

"entire_daily_do": ""

},

"goodwx_definition": {

"goodwx_wind": "",

"goodwx_bf": "4",

"goodwx_windspeed": "",

"goodwx_dss": "3",

"goodwx_sigwave": "2",

"goodwx_windsea": "",

"gooodwx_swell": "",

"goodwx_current": "All"

},

"warranted": {

"speed": "14.5",

"fo": "45",

"do": "1.5"

},

"allowance": {

"speed": "0.5",

"fo": "5",

"do": "0",

"speed_unit": "kts",

"fuel_unit": "%"

},

"rpm": null,

"slip": null,

"co2_fo": 1856.033,

"co2_do": null,

"id": "sid20240103_000312_1"

}

]

GET

/v1/cp-warranty.json

Playground

Variables

Key

Value

ships

start_time

end_time

last_x_months

Samples