---
title: "list hosts"
method: GET
path: "/hosts"
---

# list hosts

`GET /hosts`

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

OK

- Host[]
  - `name` string
  - `url` string
  - `kind` string
  - `repositories_count` integer
  - `owners_count` integer
  - `icon_url` string
  - `host_url` string
  - `repositoris_url` string
  - `repository_names_url` string
  - `owners_url` string
  - `version` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `status` 'online' | 'timeout' | 'connection_failed' | 'http_error' | 'ssl_error' | 'error' — Current status of the host
  - `status_checked_at` string, date-time — Timestamp when status was last checked
  - `response_time` integer, nullable — Response time in milliseconds (null if host is offline)
  - `last_error` string, nullable — Last error message encountered
  - `robots_txt_status` 'success' | 'not_found' | 'error_404' | 'error_500' | 'error_timeout' — Status of robots.txt fetch
  - `robots_txt_updated_at` string, date-time, nullable — Timestamp when robots.txt was last fetched
  - `robots_txt_url` string — URL to the host's robots.txt file
  - `online` boolean — Whether the host is currently online
  - `can_crawl_api` boolean — Whether API crawling is allowed by robots.txt

---

[API](https://skmtc.net/ecosyste-ms/apis/ecosyste-ms-repos.md) · [All operations](https://skmtc.net/ecosyste-ms/apis/ecosyste-ms-repos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ecosyste-ms/ecosyste-ms-repos/revisions/791f49c6a3cc/schema)