---
title: "get a host by name"
method: GET
path: "/hosts/{hostName}"
---

# get a host by name

`GET /hosts/{hostName}`

## Request

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

## Path parameters

- `hostName` string, required

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

- **2025-07-21** (v1) `dca49000770b`: 9 info
  - added the optional property `can_crawl_api` to the response with the `200` status
  - added the optional property `last_error` to the response with the `200` status
  - added the optional property `online` to the response with the `200` status
  - added the optional property `response_time` to the response with the `200` status
  - …5 more
- **2023-12-02** (v1) `d423597079cc`: 3 info
  - added the optional property `created_at` to the response with the `200` status
  - added the optional property `updated_at` to the response with the `200` status
  - added the optional property `version` to the response with the `200` status
- **2023-04-24** (v1) `778b8d06fcf1`: 3 info
  - added the optional property `icon_url` to the response with the `200` status
  - added the optional property `owners_count` to the response with the `200` status
  - added the optional property `owners_url` to the response with the `200` status
- **2022-10-03** (v1) `168843b542ab`: 3 info
  - added the optional property `host_url` to the response with the `200` status
  - added the optional property `repositoris_url` to the response with the `200` status
  - added the optional property `repository_names_url` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/ecosyste-ms/apis/ecosyste-ms-repos/changes/hosts/:hostName/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)