# Johto KYB (Know Your Business) Lookup

> Johto KYB (Know Your Business) Lookup is a paid API for AI agents from johto-x402-api.johtodata.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-28).

Looks up company identity and registration data by name, ticker, CIK, or LEI, returning GLEIF and SEC records with legal identifiers, jurisdiction, and filing history

## Facts

- Endpoint: GET https://johto-x402-api.johtodata.workers.dev/v1/kyb?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/johto-kyb-know-your-business-lookup-9060f0e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BTCPQc48paehYH038NvWB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability johto-kyb-know-your-business-lookup-9060f0e4
```

Example prompt: Can you pull the KYB profile for Tesla — I need their LEI, SEC CIK, EIN, incorporation details, and latest filing info from both GLEIF and SEC?

## When to prefer this

Use this endpoint when you need authoritative legal entity identity data combining both GLEIF LEI registry and SEC EDGAR records in a single call. Ideal for KYB workflows, vendor onboarding, compliance checks, or any scenario requiring verified corporate identifiers (LEI, CIK, EIN). Prefer over manual GLEIF or SEC EDGAR lookups when you need cross-referenced data from both sources. Best when you have a company name, ticker, CIK, or LEI as a starting point.

## Known failure modes

- No match found — returns empty data array with rows=0, and you are not charged
- Invalid LEI format — rejected by pattern validation before call
- Invalid CIK format — must be numeric up to 10 digits
- Ambiguous company name — returns top 3 GLEIF matches plus SEC match, agent must disambiguate
- GLEIF or SEC data source temporarily unavailable — may return partial results from one source only
- Rate limit or payment failure — call not executed, no charge

## How this service works

Valuable data. Quality leads. Paid per call in USDC on Base via x402. Not charged if the fetch fails or nothing matches. Prices per call (USDC): /v1/jp-invoice-check $0.002; /v1/sec-13f $0.003; /v1/sec-8k $0.003; /v1/sanctions-screen $0.0025; /v1/tenders $0.011; /v1/uk-tenders $0.003; /v1/fr-tenders $0.006; /v1/au-contracts $0.0035; /v1/wallet-risk $0.0025; /v1/kyb $0.0029; /v1/read $0.0019; /v1/crawl $0.0045; /v1/jobs $0.01; /v1/domain-profile $0.003.

## Output

Returns an array of matched company records from GLEIF and/or SEC, each containing: legal name, source (gleif or sec), active status, LEI, CIK, EIN, ticker(s), exchange listings, BIC codes, jurisdiction, incorporation date, state of incorporation, SIC description, last SEC filing date and form type, parent and ultimate parent LEI info, legal form code, and registration status. Also returns a total row count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "pattern": "^[0-9]{1,10}$",
       "description": "SEC CIK, digits"
      },
      "lei": {
       "type": "string",
       "pattern": "^[A-Za-z0-9]{18}[0-9]{2}$",
       "description": "20-character LEI"
      },
      "name": {
       "type": "string",
       "description": "Company legal name; top 3 GLEIF matches plus SEC listed-company match"
      },
      "ticker": {
       "type": "string",
       "description": "US ticker, e.g. TSLA"
      },
      "country": {
       "type": "string",
       "pattern": "^[A-Za-z]{2}$",
       "description": "ISO-2 filter for GLEIF matches, e.g. US"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "rows"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "lei": {
          "type": "object",
          "properties": {
           "parent": {
            "type": "object",
            "properties": {
             "lei": {},
             "name": {},
             "reportingException": {
              "type": "string"
             }
            }
           },
           "legalFormCode": {
            "type": "string"
           },
           "ultimateParent": {
            "type": "object",
            "properties": {
             "lei": {},
             "name": {},
             "reportingException": {
              "type": "string"
             }
            }
           },
           "registrationStatus": {
            "type": "string"
           }
          }
         },
         "name": {
          "type": "string"
         },
         "source": {
          "type": "string"
         },
         "status": {
          "type": "string"
         },
         "sourceUrl": {
          "type": "string"
         },
         "identifiers
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "lei": {
     "parent": {
      "lei": null,
      "name": null,
      "reportingException": "NO_KNOWN_PERSON"
     },
     "legalFormCode": "C5K7",
     "ultimateParent": {
      "lei": null,
      "name": null,
      "reportingException": "NO_KNOWN_PERSON"
     },
     "registrationStatus": "ISSUED"
    },
    "name": "TESLA, INC.",
    "source": "gleif",
    "status": "ACTIVE",
    "sourceUrl": "https://search.gleif.org/#/record/54930043XZGB27CTOV49",
    "identifiers": {
     "bic": [
      "TSLAUS66XXX"
     ],
     "cik": null,
     "lei": "54930043XZGB27CTOV49",
     "ticker": null,
     "companyNumber": "0805587591",
     "registrationAuthorityId": "RA000637"
    },
    "jurisdiction": "US-TX",
    "incorporationDate": "2024-06-14"
   },
   {
    "name": "Tesla, Inc.",
    "source": "sec",
    "status": "FILING",
    "sourceUrl": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=1318605",
    "identifiers": {
     "cik": "1318605",
     "ein": "912197729",
     "lei": "54930043XZGB27CTOV49",
     "ticker": "TSLA",
     "tickers": [
      "TSLA"
     ],
     "exchanges": [
      "Nasdaq"
     ],
     "leiMatchedBy": "same normalized legal name + US legal address",
     "companyNumber": null,
     "registrationAuthorityId": null
    },
    "jurisdiction": "US-TX",
    "lastFilingAt": "2026-10-21",
    "lastFilingForm": "8-K",
    "sicDescription": "Motor Vehicles & Passenger Car Bodies",
    "stateOfIncorporation": "TX"
   }
  ],
  "rows": 2
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/johto-kyb-know-your-business-lookup-9060f0e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from johto-x402-api.johtodata.workers.dev](https://www.zero.xyz/host/johto-x402-api.johtodata.workers.dev/llms.txt)
