Blackkitetech Black Kite API

Name: Black Kite API
Brand: Black Kite API
Availability: InStock

✓ Official Vendor SpecSecurityComplianceoauth237 EndpointsREST

For Agents

Manage monitored companies in Black Kite, pull cyber risk scores and trends, and generate vendor risk reports. Useful for agents that automate third-party risk monitoring.

Install Jentic One Beta

Connect the Black Kite API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Black Kite API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Black Kite API.

Add, list, and remove companies in the Black Kite monitoring catalogue

Pull a company's technical, compliance, and financial risk score summary

Track monthly technical and financial risk trends per monitored company

GET STARTED

Start building with Black Kite API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Black Kite API for, with concrete tasks.

★ Third-Party Vendor Onboarding Risk Check

When procurement onboards a new supplier, the integration calls POST /api/v2/companies to add the vendor to the Black Kite watchlist, then GET /api/v2/companies/{id}/summary to pull the initial risk scores. Procurement and security review the technical, compliance, and financial dimensions before the contract is signed. Repeat the call monthly to detect drift.

Call POST /api/v2/companies with the new vendor name and primary domain, wait for the initial scan, then call GET /api/v2/companies/{id}/summary and report the technical and compliance scores.

Supply Chain Risk Monitoring Dashboard

Build a monitoring dashboard that pulls GET /api/v2/companies/{id}/trend/technical and /trend/financial for every monitored vendor on a monthly cadence. The dashboard highlights vendors whose technical or financial risk worsened month over month, which feeds the security and procurement risk reviews. Black Kite's 60 rpm limit is comfortable for portfolios in the low hundreds.

Iterate the company list from GET /api/v2/companies, call /trend/technical and /trend/financial for each, and emit a list of vendors with month-over-month deterioration above 5 points.

Automated Risk Report Generation

Compliance teams trigger a Black Kite report on a vendor, wait for it to be ready, and store the PDF or download link in their GRC system. The flow is POST /api/v2/companies/{id}/report-generate, poll GET /api/v2/companies/{id}/report-status, then GET /api/v2/companies/{id}/report-download or /report/{type}. This replaces the manual click-through in the Black Kite UI.

Call POST /api/v2/companies/{id}/report-generate, poll /report-status until done, then GET /report-download and store the link in the GRC system of record.

Attack Surface Inventory Sync

Sync the Black Kite-attributed assets for a vendor — domains, subdomains, IPs, IP blocks, ASNs, and cloud associations — into the in-house CMDB or ASM tool. Use the per-company asset endpoints (e.g. /api/v2/companies/{id}/domains, /subdomains, /ips, /ipblocks, /asn) to enumerate and reconcile differences. PATCH endpoints let the team mark false positives.

For a given vendor id, call GET /api/v2/companies/{id}/domains and /subdomains, diff against the CMDB, and PATCH the status of any asset the team has marked invalid.

Agent-Driven Vendor Risk Lookup via Jentic

An AI agent supporting the security team gets a question like 'what's the current cyber risk score for Acme Inc?' and uses Jentic to find the Black Kite summary operation. Jentic returns the schema, the agent calls /api/v2/companies/{id}/summary, and answers with the technical, compliance, and financial scores. The Black Kite OAuth credentials never enter the agent's prompt.

Use Jentic search for 'get the cyber risk summary for a monitored company', load the schema, then execute GET /api/v2/companies/{id}/summary and return the headline scores.

Key Endpoints

37 endpoints — the black kite api is the programmatic surface of black kite's cyber risk intelligence platform, used to assess third-party and supply chain risk from technical, compliance, and financial perspectives.

METHOD

PATH

DESCRIPTION

GET

/api/v2/companies

List monitored companies

POST

/api/v2/companies

Add a company for monitoring

GET

/api/v2/companies/{id}/summary

Get company risk score summary

GET

/api/v2/companies/{id}/trend/technical

Monthly technical risk trend

POST

/api/v2/companies/{id}/report-generate

Generate a company report

GET

/api/v2/companies/{id}/report-download

Download a generated report

GET

/api/v2/companies/{id}/domains

List domains attributed to a company

GET

/api/v2/companies

List monitored companies

POST

/api/v2/companies

Add a company for monitoring

GET

/api/v2/companies/{id}/summary

Get company risk score summary

GET

/api/v2/companies/{id}/trend/technical

Monthly technical risk trend

POST

/api/v2/companies/{id}/report-generate

Generate a company report

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Black Kite uses OAuth 2.0 client credentials. Jentic stores the client id and secret in the encrypted vault, mints and rotates short-lived bearer tokens, and exposes only a scoped Jentic token to the agent. This is important because the same OAuth client typically grants access to the entire monitored portfolio.

Intent-based discovery

Agents search Jentic with intents like 'get the cyber risk summary for a monitored company' or 'generate a Black Kite report' and Jentic returns the matching operation from the 37-endpoint spec with its input schema and OAuth requirements.

Time to first call

Direct integration: 2-3 days to wire OAuth client_credentials flow, the report-generation polling loop, and pagination. Through Jentic: under 2 hours — search, load schema, execute, with the OAuth lifecycle handled inside Jentic.

FAQs

Specific to using Black Kite API through Jentic.

What authentication does the Black Kite API use?

OAuth 2.0 with the client_credentials flow. Tokens are issued from https://app.blackkitetech.com/oauth/token. Through Jentic the OAuth client id and secret are stored in the encrypted vault, Jentic mints and rotates the bearer token, and the agent receives a scoped Jentic token instead of the raw client credentials.

Can I add a vendor for monitoring with the Black Kite API?

Yes. POST /api/v2/companies adds a company to your monitored catalogue. Once added, GET /api/v2/companies/{id}/summary returns the technical, compliance, and financial risk scores after the initial scan completes.

What are the rate limits for the Black Kite API?

60 requests per minute, as documented in the API description. For portfolio sweeps over more than a few dozen companies, throttle the loop or use the bulk-style search endpoint POST /api/v2/companies/search to reduce call counts.

How do I generate and download a Black Kite report through Jentic?

Install with pip install jentic, then use Jentic search with 'generate a Black Kite report for a third party'. Jentic resolves the three-step flow: POST /api/v2/companies/{id}/report-generate, poll /report-status, then GET /report-download. The OAuth token is managed inside Jentic.

Can I see the attack-surface assets attributed to a vendor?

Yes. Per-company endpoints like GET /api/v2/companies/{id}/domains, /subdomains, /ips, /ipblocks, /asn, and /clouds expose the assets Black Kite has attributed. PATCH variants let you correct false positives.

Is the Black Kite API free?

No. Black Kite is a paid platform — API access is included with active subscriptions. There is no public free tier; OAuth client credentials are issued to customer accounts only.

Blackkitetech Black Kite API

Connect the Black Kite API to your agent

Capabilities

Start building with Black Kite API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs