Koskamo
Navigation

Identify the time zone.

Retrieve a named IANA time zone and its source. Use a time zone library for date-specific offset calculations.

Connect your agent Explore knowledge

Look up the identifier

Scope the request to time-zones and search for America/Phoenix. Check the returned zone name, country codes, and backward-compatible names. An alias and a canonical identifier can refer to the same zone; preserve the distinction reported by the source.

Keep identification separate from conversion

This catalog record is not a current-offset service. A zone identifier represents rules, not a fixed number of hours. To convert a timestamp, use the relevant date and a time zone library with an appropriate IANA database release.

Check the passage before citing

The example below is a recorded lookup, not a live response. Verify that the returned identifier answers your question and retain its source and document version. If the question needs a current offset, this record alone does not supply the answer.

Try the lookup

Run this in a POSIX shell with curl. Public reads need no account or API key.

Lookup command
curl --fail-with-body 'https://koskamo.com/api/v1/retrieve' -H 'Content-Type: application/json' --data-raw '{"query":"America/Phoenix","dataset":"time-zones","top_k":3}'
Try in your browserBrowse the dataset

Read the returned evidence

Selected fields from the first passage returned on 2026-10-08. This is a recorded example; current versions and ranking may change. A response can contain other matches, so check the title and text before using a passage.

Recorded passage
{
  "text": "America/Phoenix is a canonical time zone in the IANA Time Zone Database covering these ISO 3166-1 alpha-2 countries: US, CA.\n\n- Zone name: America/Phoenix\n- Countries (ISO 3166-1 alpha-2): US, CA\n- Coordinates (ISO 6709): +332654-1120424\n- Coordinates (decimal degrees): 33.4483° N, 112.0733° W\n- Comment: MST - AZ (most areas), Creston BC\n- Backward-compatible names: America/Creston; MST; US/Arizona\n- tz database release: 2026e (2026-09-29 17:14:38 -0700)",
  "datasetSlug": "time-zones",
  "datasetVersion": 313,
  "documentId": "da2b1a45-943b-493f-9377-bfa8f76d2d2d",
  "documentTitle": "America/Phoenix",
  "documentVersion": 1,
  "sourceUrl": "https://www.iana.org/time-zones"
}

Keep the citation with the answer

Keep documentId and documentVersion together with the dataset slug, document title, and original source URL. The dataset version describes the collection; it is not the document version. Preserve this evidence through summarization and show it with the final answer.

Versioned citation
America/Phoenix, document v1, time-zones. https://koskamo.com/data/datasets/time-zones/documents/da2b1a45-943b-493f-9377-bfa8f76d2d2d?version=1 Source: https://www.iana.org/time-zones
Read the cited versionRead the original source

An empty passages array means there is no returned evidence to cite. An HTTP error is a failed lookup, not an empty result. On 429, respect Retry-After; on other failures, report the failure instead of inventing a source.

Frequently asked questions

Does this API calculate the current UTC offset?
No. It retrieves reference records. Use a time zone library and the relevant timestamp for offset calculations.
Can I query an alias?
Records include backward-compatible names where supplied. Check which canonical identifier the returned passage names before storing or citing it.
Do public lookups require credentials?
No. Use POST /api/v1/retrieve or the koskamo_retrieve MCP tool without a key for public datasets.