---
title: "Get statistics around registered bulk hostnames"
method: GET
path: "/bulk/hostnames/stats"
tags: ["bulk"]
---

# Get statistics around registered bulk hostnames

`GET /bulk/hostnames/stats`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/bulk/hostnames/stats`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/bulk/hostnames/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Get statistics for the registered hostnames. This will return the number of registered hostnames, the number of
remaining slots and the number of active and inactive hostnames

This is an add-on endpoint not available to all accounts. Please contact support for information about bulk endpoints and how to upgrade your account.

Required API key permissions: `Admin` (select when creating API key in Account Settings)

## Response `200`

Returns the statistics for the registered hostnames.

- BulkGetHostnamesStatsV1ResponseBody
  - `active` integer: The number of active hostnames.
  - `inactive` integer: The number of inactive hostnames.
  - `registered` integer: The number of registered hostnames.
  - `remaining` integer: The number of remaining available slots.

## Other responses

- `403`: Your API key does not have permission to perform this action.
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)