{"openapi":"3.1.0","info":{"title":"Nordax AI Entity Network API","version":"1.0.0","description":"Public REST API for the Nordax AI entity network. Query verified, machine-readable business entity profiles with trust tier, AI visibility scores, and W3C Verifiable Credentials.","contact":{"name":"Nordax AI","url":"https://nordax.ai","email":"info@nordax.ai"},"termsOfService":"https://nordax.ai/terms"},"servers":[{"url":"https://api.nordax.ai","description":"Production API"}],"paths":{"/api/v1/entities":{"get":{"operationId":"listEntities","summary":"Search and list published entities","description":"Search, filter, and paginate published entity profiles in the Nordax AI network.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text search query (name, description, services)"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Entity type filter (LocalBusiness, Restaurant, MedicalBusiness, LegalService, etc.)"},{"name":"city","in":"query","schema":{"type":"string"},"description":"Filter by city name"},{"name":"state","in":"query","schema":{"type":"string"},"description":"US state abbreviation (e.g. TX, CA, NY)"},{"name":"tier","in":"query","schema":{"type":"string","enum":["free","basic","verified","authority","gold"]},"description":"Filter by trust tier"},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Results per page"}],"responses":{"200":{"description":"Paginated list of entities","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/EntitySummary"}},"total":{"type":"integer"},"page":{"type":"integer"},"limit":{"type":"integer"}}}}}}}}},"/api/v1/entities/{slug}":{"get":{"operationId":"getEntity","summary":"Get full entity profile","description":"Retrieve complete entity data including metadata, relationships, score, and structured outputs.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Entity slug identifier"}],"responses":{"200":{"description":"Full entity profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityProfile"}}}},"404":{"description":"Entity not found"}}}},"/api/v1/categories":{"get":{"operationId":"listCategories","summary":"List entity categories","description":"All entity categories with counts.","responses":{"200":{"description":"Category list","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"count":{"type":"integer"}}}}}}}}}},"/api/v1/stats":{"get":{"operationId":"getNetworkStats","summary":"Network statistics","description":"Aggregate statistics for the Nordax AI entity network.","responses":{"200":{"description":"Network stats","content":{"application/json":{"schema":{"type":"object","properties":{"totalEntities":{"type":"integer"},"verifiedCount":{"type":"integer"},"categories":{"type":"integer"},"cities":{"type":"integer"},"states":{"type":"integer"}}}}}}}}},"/api/netp/attest/{slug}":{"get":{"operationId":"attestEntity","summary":"Get entity trust attestation","description":"Real-time, cryptographically signed attestation of an entity's trust status. Returns Trust Quotient score, verification level, active credential status, and Ed25519 proof.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Entity slug"},{"name":"sign","in":"query","schema":{"type":"boolean","default":true},"description":"Include cryptographic signature (default true for Verified+)"}],"responses":{"200":{"description":"Trust attestation with optional cryptographic proof","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Attestation"}}}}}}},"/api/netp/credentials/{slug}":{"get":{"operationId":"getEntityCredential","summary":"Get W3C Verifiable Credential","description":"Retrieve the active W3C Verifiable Entity Credential for a business.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Entity slug"}],"responses":{"200":{"description":"W3C Verifiable Credential","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifiableCredential"}}}}}}},"/api/netp/resolve":{"post":{"operationId":"resolveEntity","summary":"Resolve ambiguous entity reference","description":"Input any signals (name, URL, phone, location) and get the best-matching verified entity with confidence score.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Business name"},"url":{"type":"string","description":"Business website URL"},"phone":{"type":"string","description":"Phone number"},"city":{"type":"string"},"state":{"type":"string"},"query":{"type":"string","description":"Free-text search"}}}}}},"responses":{"200":{"description":"Resolution result with confidence score","content":{"application/json":{"schema":{"type":"object","properties":{"resolved":{"type":"boolean"},"confidence":{"type":"number"},"entity":{"$ref":"#/components/schemas/EntitySummary"},"inputSignals":{"type":"array","items":{"type":"string"}}}}}}}}}}},"components":{"schemas":{"EntitySummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"entityName":{"type":"string"},"entityType":{"type":"string"},"shortDescription":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"tier":{"type":"string","enum":["free","basic","verified","authority","gold"]},"verificationStatus":{"type":"string"},"visibilityScore":{"type":"integer","nullable":true},"url":{"type":"string","nullable":true}}},"EntityProfile":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"entityName":{"type":"string"},"entityType":{"type":"string"},"description":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"tier":{"type":"string"},"verificationStatus":{"type":"string"},"visibilityScore":{"type":"integer","nullable":true},"url":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"services":{"type":"array","items":{"type":"string"},"nullable":true},"relationships":{"type":"array","items":{"type":"object","properties":{"targetSlug":{"type":"string"},"targetName":{"type":"string"},"relationshipType":{"type":"string"}}}}}},"Attestation":{"type":"object","properties":{"entity":{"type":"object","properties":{"name":{"type":"string"},"did":{"type":"string"},"tier":{"type":"string"}}},"trustQuotient":{"type":"object","properties":{"score":{"type":"integer"},"version":{"type":"string"}}},"credential":{"type":"object","properties":{"active":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"}}},"proof":{"type":"object","nullable":true,"description":"Ed25519 cryptographic proof (Verified+ only)"},"timestamp":{"type":"string","format":"date-time"}}},"VerifiableCredential":{"type":"object","description":"W3C Verifiable Credential 2.0 with DataIntegrityProof","properties":{"@context":{"type":"array","items":{"type":"string"}},"type":{"type":"array","items":{"type":"string"}},"issuer":{"type":"string"},"credentialSubject":{"type":"object"},"proof":{"type":"object"},"issuanceDate":{"type":"string","format":"date-time"},"expirationDate":{"type":"string","format":"date-time"}}}}}}