---
title: "BSI Category Stats"
method: GET
path: "/v3/bsi/category"
tags: ["Business Service Intelligence"]
---

# BSI Category Stats

`GET /v3/bsi/category`

Returns counts of BSI IPs and CIDRs grouped by category.
Use `date=now` for current information or
`date=YYYY-MM-DD` for historical information.

This endpoint requires the proper BSI entitlements.

## Query parameters

- `date` string

## Response `200`

OK - request successful.

- BSICategoryResponse
  - `date` string
  - `source` string
  - `stats` object
    - `categories` object[]
      - `category` string
      - `ip_count` integer
      - `cidr_count` integer

## Other responses

- `400` — Bad request - request syntax is invalid for the specified endpoint. Verify request syntax and try again.
- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to an invalid API key or plan limitations. If due to plan limitations, contact sales@greynoise.io to upgrade your plan and unlock full results.
- `404` — Resource not found.
- `500` — Unexpected error

---

[API](https://skmtc.dev/greynoise/apis/greynoise-api.md) · [All operations](https://skmtc.dev/greynoise/apis/greynoise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greynoise/greynoise-api/revisions/30942574656d/schema)
