# OSF Identity Entity Lookup

> OSF Identity Entity Lookup 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-10-11).

Looks up a legal entity or individual across public registries (GLEIF LEI, US CMS NPI, FDIC, SEC EDGAR) and returns verified identity matches with provenance links and audit receipts.

## Facts

- Endpoint: GET https://api.osf-master-server.com/x402/identity/entity/%7Bquery%7D?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/osf-identity-entity-lookup-ae7e3095
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zkfdaPqf9ljbcxjpEScWe

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-identity-entity-lookup-ae7e3095
```

Example prompt: Can you look up the entity with LEI code 254900C6J3WN4F1AU607 in the OSF identity registry and tell me its official name, jurisdiction, and the provenance URL from GLEIF — I need the result in JSON format?

## When to prefer this

Choose this endpoint when you need to resolve a legal entity identifier (LEI, NPI, FDIC, SEC EDGAR) or name against authoritative public registries with a verifiable provenance link and audit receipt. Prefer it over unverified web searches when traceability and compliance signaling matter, or when building KYB/KYC workflows that require stamped public-record evidence. It is ideal for autonomous agents that need pay-per-record, micropayment-gated access to identity data without a subscription.

## Known failure modes

- NOT_FOUND returned when the entity does not appear in any covered registry (GLEIF, NPI, FDIC, EDGAR)
- INVALID_INPUT returned when the query string is malformed or empty
- 402 Payment Required if micropayment via x402 is not completed before the call
- Partial coverage: registries are limited to GLEIF LEI, US CMS NPI, FDIC, and SEC EDGAR — global or non-US entities outside these registries will not be found
- Rate limiting or network errors from the upstream OSF server

## How this service works

OSF is a live marketplace of provenance stamped public domain government and scientific data, built for autonomous agents that pay per record over x402 micropayments on Base. A paid MCP server in the official MCP Registry, discoverable on the Coinbase CDP Bazaar.

## Output

Returns a JSON object with the query string, a result status (FOUND, NOT_FOUND, or INVALID_INPUT), an array of matches each containing entity name, registry source, identifier, entity type, match basis, jurisdiction, provenance URL, and identifier type, plus a match count, audit receipt with a lookup UUID and result hash, a coverage note explaining registry scope, and a compliance note about due diligence requirements.

## 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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "254900C6J3WN4F1AU607",
  "result": "FOUND",
  "matches": [
   {
    "name": "Defiance KSM TipRanks Analyst ETF",
    "registry": "GLEIF",
    "identifier": "254900C6J3WN4F1AU607",
    "entity_type": "legal_entity",
    "match_basis": "identifier",
    "jurisdiction": "US-DE",
    "provenance_url": "https://search.gleif.org/#/record/254900C6J3WN4F1AU607",
    "identifier_type": "LEI"
   }
  ],
  "service": "OSF Identity - Entity Lookup",
  "match_count": 1,
  "audit_receipt": {
   "lookup_id": "uuid",
   "result_sha256": "..."
  },
  "coverage_note": "Resolved against US CMS NPI (healthcare providers), GLEIF LEI (global legal entities), FDIC (US insured banks), SEC EDGAR (US filers), and the IRS EO BMF (US tax exempt organizations) only. This is not a complete global registry of all businesses or individuals; absence here does not mean an entity does not exist.",
  "compliance_note": "A registry match is an identity SIGNAL, not a full due-diligence determination. Confirm against the linked official source and follow your institution's onboarding/KYB process before acting."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/osf-identity-entity-lookup-ae7e3095/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)