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

# list hosts

`GET /hosts`

## Request

- Base URL: `https://repos.ecosyste.ms/api/v1`
- URL: `https://repos.ecosyste.ms/api/v1/hosts`
- Auth: none declared

## 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

## Changes

- **2026-07-20** (v1) `791f49c6a3cc`: 1 info
  - api operation id `getRegistries` removed and replaced with `getHosts`
- **2025-07-21** (v1) `dca49000770b`: 9 info
  - added the optional property `items/can_crawl_api` to the response with the `200` status
  - added the optional property `items/last_error` to the response with the `200` status
  - added the optional property `items/online` to the response with the `200` status
  - added the optional property `items/response_time` to the response with the `200` status
  - …5 more
- **2023-12-02** (v1) `d423597079cc`: 3 info
  - added the optional property `items/created_at` to the response with the `200` status
  - added the optional property `items/updated_at` to the response with the `200` status
  - added the optional property `items/version` to the response with the `200` status
- **2023-04-24** (v1) `778b8d06fcf1`: 3 info
  - added the optional property `items/icon_url` to the response with the `200` status
  - added the optional property `items/owners_count` to the response with the `200` status
  - added the optional property `items/owners_url` to the response with the `200` status
- **2022-10-03** (v1) `168843b542ab`: 3 info
  - added the optional property `items/host_url` to the response with the `200` status
  - added the optional property `items/repositoris_url` to the response with the `200` status
  - added the optional property `items/repository_names_url` to the response with the `200` status

[Operation history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/changes/hosts/get.md)

---

[API](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos.md) - [All operations](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/llms.txt) - [OpenAPI document](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/revisions/dae497f2cdf7?raw)