ImportYeti
Database
GET

Get when the database was last updated

Free

Returns the last-updated date for ImportYeti’s trade database. This call is free.

Parameters#

Query parameters

  • fieldsstringoptional

    Comma-separated list of fields to keep on each returned record, e.g. bol_number,arrival_date,supplier_name. Everything else is omitted. Names that the record does not carry are ignored. The envelope (requestCost, creditsRemaining, executionTime, totalCount) is always returned in full. Cannot be combined with exclude. Omit for the full record.

  • excludestringoptional

    Comma-separated list of fields to drop from each returned record, e.g. containers,shipping_rate. Every other field is kept. Cannot be combined with fields. Omit for the full record.

  • formatstringoptionaldefault json

    Response encoding. Defaults to json. Pass toon to receive TOON — the same data in a compact, token-efficient text form intended for LLM prompts. Error responses are always JSON.

    one ofjsontoon

fields, exclude, and format work the same way on every endpoint — Response shaping has worked examples.

Response#

The date ImportYeti’s trade database was last updated.

Response shape
{
  "requestCost": 0,
  "creditsRemaining": 9998.5,
  "data": "08/04/2026",
  "executionTime": "224ms"
}

Top-level fields#

  • data — the returned value itself
  • requestCost — Data credits used for this call (0 if none)
  • creditsRemaining — Your data credit balance after the call
  • executionTime — How long the request took

Errors#

Failures come back as JSON with a statusCode and message. The ones worth handling here are 401 (bad or missing key), 403 (out of credits), and 404 (no such record). See all error responses.