# OSF Entity & Counterparty Verification (NPI / LEI / FDIC / EDGAR)

> OSF Entity & Counterparty Verification (NPI / LEI / FDIC / EDGAR) is a paid API for AI agents from api.osf-master-server.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Resolves a US healthcare provider, global legal entity, US insured bank, or SEC filer by identifier or name, returning legal name, status, jurisdiction, and a provenance URL to the official source.

## Facts

- Endpoint: GET https://api.osf-master-server.com/x402/identity/entity/:query
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/osf-entity-counterparty-verification-npi-lei-fdic-edgar-40b2497d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vJ0rMOsSik3Zw5RWs6t6N

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 osf-entity-counterparty-verification-npi-lei-fdic-edgar-40b2497d
```

Example prompt: Can you verify the legal name, active status, and jurisdiction for NPI 1234567890 — I need the provenance URL back to the official CMS registry for our KYB onboarding file.

## When to prefer this

Choose this endpoint when you need a single API call that cross-covers US healthcare providers (CMS NPI), global legal entities (GLEIF LEI), US insured banks (FDIC), and SEC filers (EDGAR CIK) with provenance-stamped, audit-ready results. Ideal for KYC, KYB, due diligence, or onboarding agent workflows where you need an official source URL alongside the structured data. Prefer over ad-hoc web search when you need machine-readable compliance artifacts.

## Known failure modes

- NOT_FOUND result when the identifier or name has no match in the covered registries
- INVALID_INPUT result when the query string is malformed or ambiguous
- Payment failure (402) if the $0.01 USDC x402 payment is not included or rejected
- Registry unavailability if upstream CMS/GLEIF/FDIC/EDGAR sources are temporarily down
- Ambiguous name queries returning multiple partial matches requiring disambiguation

## How this service works

Entity and counterparty verification by identifier or name. Resolves US healthcare providers (CMS NPI), legal entities (GLEIF LEI), US banks (FDIC), SEC filers (EDGAR CIK or ticker), and US tax exempt orgs (IRS EIN). Returns legal name, status, jurisdiction, identifiers, and a provenance URL to the official source. For KYC, KYB, due diligence, and onboarding agent workflows.

## Output

Returns a JSON object with service name, the original query, a result code (FOUND / NOT_FOUND / INVALID_INPUT), match count, an array of matched entity records (each with legal name, status, jurisdiction, and cross-registry identifiers), a compliance note, and a signed audit receipt with a provenance URL pointing to the authoritative official source.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "format"
     ],
     "properties": {
      "format": {
       "type": "string",
       "description": "Response format (json)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "service",
      "query",
      "result",
      "match_count",
      "matches",
      "compliance_note",
      "audit_receipt"
     ],
     "properties": {
      "query": {
       "type": "string"
      },
      "result": {
       "type": "string",
       "description": "FOUND, NOT_FOUND, LOOKUP_UNAVAILABLE, or INVALID_INPUT"
      },
      "matches": {
       "type": "array"
      },
      "service": {
       "type": "string"
      },
      "match_count": {
       "type": "integer"
      },
      "audit_receipt": {
       "type": "object"
      },
      "coverage_note": {
       "type": "string"
      },
      "compliance_note": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/osf-entity-counterparty-verification-npi-lei-fdic-edgar-40b2497d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.osf-master-server.com](https://www.zero.xyz/host/api.osf-master-server.com/llms.txt)