canonical: https://jentic.com/apis/eckari.com/eckari

# Eckari capability API

The Eckari capability API serves a provider-neutral set of read-only lookups that agents can call directly. It profiles UK companies from Companies House (directors, charges, filings, beneficial owners, and status) and US public companies from SEC EDGAR, resolves legal entities by LEI from the GLEIF register, runs domain WHOIS and RDAP checks, returns official ECB reference exchange rates, geocodes US addresses against Census TIGER data, detects parcel carriers from a tracking number, and reports US weather forecasts, observations, and alerts from the NWS.

## For AI agents

Call a provider-neutral set of read-only lookups: UK and US company profiles, directors, filings and charges, GLEIF legal-entity records, domain WHOIS, ECB FX reference rates, US geocoding, carrier detection, and US weather.

## Scope

Does not create or modify records, settle payments, or store your data. Use for read-only company, entity, FX, location, and reference lookups only.

## Capabilities

- Search and profile UK companies from Companies House, including directors, charges, filings, and beneficial owners
- Profile US public companies from SEC EDGAR and resolve a company name to its CIK and ticker
- Look up legal entities by LEI from the GLEIF register
- Run WHOIS and RDAP checks for domain registration and expiry
- Fetch official ECB reference exchange rates for a currency pair
- Geocode US addresses, detect parcel carriers, and read NWS weather forecasts, observations, and alerts

## Use cases

### Agent-run company due diligence

An agent researching a UK company searches Companies House by name through Eckari, pulls the company profile, then reads its directors, charges, and filing history to build a due-diligence summary. Each capability is discovered through Jentic by intent, so the agent calls the right lookup with the company number without reading the reference docs.

Example prompt: Search Companies House for a company by name, then retrieve its profile, directors, and latest filings and summarise the result

### Entity resolution with LEI and SEC data

Resolve a counterparty to canonical identifiers by combining the GLEIF LEI lookup with SEC EDGAR profiles. An agent can take a company name, resolve it to a US CIK and ticker, and attach the matching GLEIF legal-entity record so downstream systems key on stable identifiers.

Example prompt: Resolve a company name to its SEC CIK and ticker, then fetch the matching GLEIF legal-entity profile by LEI

### Domain, FX, and location reference checks

Enrich a record with reference data by chaining Eckari's domain, foreign-exchange, and location lookups. An agent can verify a domain's registration and expiry, convert amounts with the official ECB reference rate, and geocode a US address to coordinates and Census geographies in one pass.

Example prompt: Check a domain's registration and expiry, fetch the ECB reference rate for a currency pair, then geocode a US street address

### US weather and logistics context

Add operational context to a workflow using the NWS weather and carrier-detection lookups. An agent can detect the carrier behind a tracking number and read the current US forecast, latest observation, and any active alerts for a set of coordinates before routing a decision.

Example prompt: Detect the carrier for a tracking number, then read the US forecast and active alerts for the destination coordinates

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/companies/uk/search` | Search Companies House for UK companies by name |
| GET | `/v1/companies/uk/{company_number}` | Get a UK company profile |
| GET | `/v1/companies/us/{id}` | US public company profile from SEC EDGAR |
| GET | `/v1/entities/lei/{lei}` | Legal entity profile by LEI from GLEIF |
| GET | `/v1/domains/{domain}/registration` | WHOIS/RDAP domain registration |
| GET | `/v1/fx/reference-rate` | ECB reference exchange rate for a pair |
| GET | `/v1/locations/us/geocode` | Geocode a US street address |
| GET | `/v1/weather/us/forecast` | US weather forecast for coordinates |

## Key resources

- **Company information** — Search and profile UK and US companies, with directors, charges, filings, owners, and status
- **Domain intelligence** — WHOIS and RDAP lookups for domain registration and expiry
- **Foreign exchange** — Official ECB reference exchange rates for a currency pair
- **Location** — Geocode US addresses and return Census geographies for coordinates
- **Logistics** — Detect the carrier behind a parcel tracking number
- **Weather** — US forecasts, latest observations, and active alerts from the NWS

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 66 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 99 / 100
  - Developer Experience & Jentic Compatibility: 44 / 100
  - AI-Readiness & Agent Experience: 59 / 100
  - Agent Usability: 94 / 100
  - Security: 55 / 100
  - AI Discoverability: 100 / 100
- **View full report:** https://jentic.com/apis/eckari.com/eckari/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Eckari capability API by hand means handling its bearer account key or the x402 accountless payment flow, and normalising responses drawn from Companies House, SEC EDGAR, GLEIF, RDAP, the ECB, Census, and the NWS yourself. Through Jentic you install once, import the Eckari capability API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Eckari groups its surface into distinct capability operations like UK company lookups, US SEC profiles, LEI entity search, domain WHOIS, FX rates, geocoding, and weather, so a rule bounds which of those operations your agent may call. You choose the operations it may call, so unrelated capabilities stay off unless you add them.
- **Credential handling:** Your Eckari key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'profile a UK company' or 'get the ECB reference rate', and Jentic returns the matching Eckari operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **OpenCorporates** — Open company register data across many jurisdictions
- **Clearbit** — Firmographic and technographic company enrichment
- **SEC EDGAR** — Full-text access to US SEC filings and disclosures

## FAQ

### What authentication does the Eckari capability API use?

Per its OpenAPI spec, the Eckari capability API accepts a bearer account key (shaped ek_live_ or ek_test_) and also supports x402 accountless payment, where an unpaid request returns HTTP 402 and is retried with a PAYMENT-SIGNATURE header. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's context.

### Can I look up UK company directors with the Eckari capability API?

Yes. The UK directors operation returns the officers register for a company from Companies House, and sibling operations cover charges, filings, beneficial owners, registered office, and company status for the same company number.

### What are the rate limits for the Eckari capability API?

The OpenAPI spec does not state a fixed request rate limit; usage is metered and billed in arrears per successful request. Check the Eckari documentation at https://eckari.com for current limits and per-capability pricing.

### Is there an Eckari MCP server?

You don't need an MCP server to give your agent the Eckari capability API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the company, entity, FX, location, and weather lookups it needs.

### Can I limit what my agent is allowed to do with the Eckari capability API?

Yes. Eckari is split into distinct capability operations, so you scope by operation: write a rule that allows just the lookups the task needs, such as UK company search and profile, and leave FX, weather, domain, and location lookups off. The agent can then call only those operations, and each request is logged.

### How do I profile a company through Jentic?

Search Jentic for 'profile a UK company', and it returns the Eckari company-profile operation with its input schema; your agent supplies the company number and calls it. To run it on your own infrastructure, install Jentic One from its GitHub repo.