Skip to main content
Skip table of contents

Ship Historic Valuation Endpoint

Receive historic valuation data about a specific set of vessels.

Endpoint

/ship/valuation/historic

Request Example

https://api.vesselsvalue.com/ship/valuation/historic?token=<your_token>&format=<format>

Parameters

Parameter

Values

Required?

Notes

?token=

<your token>

Yes

Your API authorization token.

&format=

json
csv

No

Sets output format.
Defaults to json if not provided.

&output=

ftp

No

Forces format to csv and saves output to your VesselsValue FTP account.

?ship=id

<ship id>

No

&from=

YYYY-MM-DD

No

Sets the date you wish to have valuations from.
Defaults to 1992-01-01 if not provided.

&to=

YYYY-MM-DD

No

Sets the date you wish to have valuations up until.
Defaults to current day if not provided.

&weekly=

true

false

No

By default the endpoint will be set to false i.e. it will return daily values. Setting to true limits output to weekly (sunday) values

&clear_cache=

true

false

No

Defaults to false.

This option clears the cache as valuations are large datasets. We cache our results to increase speed efficiency.

The cache is based on input so changing “to” by a single day will cause a new query but going back will give instant results.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.