---
title: "Hostname History"
method: GET
path: "/api/v1/hostname/{hostname}"
tags: ["Hostnames"]
---

# Hostname History

`GET /api/v1/hostname/{hostname}`

Get the historical observations for a specific hostname in the "Hostnames" data source.

## Path parameters

- `hostname` string, required

## Query parameters

- `limit` integer
- `pageState` string

## Response `200`

Successful response

- HostnameHistorySchema
  - `pageState` string — If the pageState field is set then there are additional results available. Repeat the API call with the pageState value to get the next batch of results.
  - `results` object[]
    - `seen_on` string, date — Date in YYYY-MM-DD format
    - `source` 'ct' | 'scan' | 'pdns' | 'zonefile' | 'scan-link' | 'scan-cert-subject' — The source of the observation
    - `sub_id` string — Observation value, can be empty.
    - `first_seen` string, date — First-seen timestamp, ISO8601
    - `last_seen` string, date — Last-seen timestamp, ISO8601
    - `data_type` 'json' — Indicates if there is additional data in the `data` field.
    - `data` object — Additional JSON content for this record.

---

[API](https://skmtc.net/urlscan/apis/urlscan-io-apis.md) · [All operations](https://skmtc.net/urlscan/apis/urlscan-io-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/urlscan/urlscan-io-apis/versions/5d97b31afd68/schema)
