---
title: "BSI Single-IP Lookup"
method: GET
path: "/v3/bsi/lookup"
tags: ["Business Service Intelligence"]
---

# BSI Single-IP Lookup

`GET /v3/bsi/lookup`

Returns every BSI provider whose CIDR(s) contain the queried IPv4
address, ordered by ascending precedence (lower precedence = higher
priority). An empty `matches` array means the IP is not in BSI.

IPv6 addresses are rejected with HTTP 400. Lookups are served from
an in-memory index that refreshes from the daily bulk-data
partition; staleness may be up to ~30 minutes after a partition
rolls.

_License: This endpoint requires an additional subscription
license to use._

## Query parameters

- `ip` string, required

## Response `200`

OK — request successful.

- BSILookupResponse
  - `ip` string
  - `matches` BSILookupMatch[] — Providers whose CIDR(s) contain the queried IP, in ascending precedence order. Empty if the IP is not in BSI.
    - `cidr` string
    - `name` string
    - `category` string
    - `trust_level` string
    - `precedence` 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.
- `500` — Unexpected error
- `503` — Service Unavailable — BSI index not yet built.

---

[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)