Nordax AI Entity Network

Search the Nordax AI entity network for businesses. Returns verified, structured entity data. Use this to find businesses by name, category, or location. Results are ranked by trust tier and AI visibility score.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search query (e.g. 'dentist', 'acme plumbing')"
    },
    "entity_type": {
      "type": "string",
      "description": "Filter by entity type. Options: LocalBusiness, Organization, ProfessionalService, Restaurant, MedicalBusiness, LegalService, FinancialService, EducationalOrganization, HomeAndConstructionBusiness, AutomotiveBusiness, Store, RealEstateAgent, Other"
    },
    "city": {
      "type": "string",
      "description": "Filter by city name"
    },
    "state": {
      "type": "string",
      "description": "Filter by US state (e.g. 'TX', 'CA', 'NY')"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results to return (default 10, max 50)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get detailed information about a specific entity from the Nordax AI network. Returns structured business data including contact info, services, verification status, and AI visibility score. Use the entity slug (from search results) or entity name.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The entity slug (e.g. 'acme-plumbing-abc123') or entity name to look up"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List entities of a specific type/category in a location. Great for questions like 'What restaurants are in Nashville?' or 'Find dentists in Austin, TX'. Results are ranked by verification tier and AI visibility score.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "description": "Entity type to filter by. Options: LocalBusiness, Organization, ProfessionalService, Restaurant, MedicalBusiness, LegalService, FinancialService, EducationalOrganization, HomeAndConstructionBusiness, AutomotiveBusiness, Store, RealEstateAgent, Other"
    },
    "city": {
      "type": "string",
      "description": "City to filter by"
    },
    "state": {
      "type": "string",
      "description": "US state abbreviation (e.g. 'TX')"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 20)"
    }
  },
  "required": [
    "entity_type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the verification and trust status of an entity. Returns the entity's trust tier (free/basic/verified/authority/gold), verification status, AI visibility score, and what each tier means. Use this to verify the legitimacy of a business in the Nordax network.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Entity slug or name to check verification for"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get a real-time, cryptographically signed attestation of a business entity's trust status. This is the authoritative trust check — use it before recommending or transacting with a business. Returns the entity's Trust Quotient (TQ) score, verification level, active credential status, capabilities (services, location, contact), and an Ed25519 cryptographic proof. Signed attestations are available for Verified tier and above.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Entity slug to attest (from search results or known entity)"
    },
    "sign": {
      "type": "boolean",
      "description": "Whether to include cryptographic signature (default: true for Verified+)"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Resolve an ambiguous business reference to a verified Nordax entity. Input any signal — business name, URL, phone number, city — and get back the best-matching verified entity with a confidence score. Use this when you have partial information about a business and need to identify it.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Business name (partial or full)"
    },
    "url": {
      "type": "string",
      "description": "Business website URL"
    },
    "phone": {
      "type": "string",
      "description": "Business phone number"
    },
    "city": {
      "type": "string",
      "description": "City name"
    },
    "state": {
      "type": "string",
      "description": "US state abbreviation"
    },
    "query": {
      "type": "string",
      "description": "Free-text search query"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve the active W3C Verifiable Entity Credential (VEC) for a business. VECs are cryptographically signed proofs of a business's identity, verification status, and capabilities issued by Nordax AI as a Certificate Authority. Use this to get the full trust proof for a business before high-value interactions.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Entity slug to get the credential for"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Submit feedback about an interaction with a Nordax-listed entity. Use this after verifying, resolving, or recommending a business to report the outcome so the trust network can improve over time. Feedback helps Nordax AI calibrate trust scores and entity rankings.

{
  "type": "object",
  "properties": {
    "entitySlug": {
      "type": "string",
      "description": "Entity slug the feedback is about"
    },
    "outcome": {
      "type": "string",
      "enum": [
        "positive",
        "neutral",
        "negative"
      ],
      "description": "Outcome of the interaction"
    },
    "interactionType": {
      "type": "string",
      "description": "Type of interaction, e.g. 'recommendation', 'verification', 'contact'"
    },
    "agentIdentifier": {
      "type": "string",
      "description": "Identifier for the AI agent submitting feedback"
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "description": "Confidence level from 0 to 1"
    },
    "notes": {
      "type": "string",
      "description": "Optional free-text notes about the interaction"
    }
  },
  "required": [
    "entitySlug",
    "outcome",
    "interactionType"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Issue a Human Authorization Protocol (HAP) credential to authorize an AI agent to act on a human's behalf. Creates a W3C Verifiable Credential 2.0 with scoped permissions, time-bounded validity, and a DataIntegrityProof signature. Requires authentication — the authenticated user becomes the credential owner.

{
  "type": "object",
  "properties": {
    "agentId": {
      "type": "string",
      "description": "DID of the agent being authorized (e.g. 'did:web:agent.example.com')"
    },
    "agentType": {
      "type": "string",
      "enum": [
        "ai_assistant",
        "api_client",
        "automation",
        "service_agent"
      ],
      "description": "Type of agent"
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Permitted actions (e.g. ['read', 'recommend', 'transact', 'purchase', 'book'])"
    },
    "verificationLevel": {
      "type": "string",
      "enum": [
        "basic",
        "enhanced",
        "full"
      ],
      "description": "Verification level — basic (7d default), enhanced (30d), full (90d)"
    },
    "principalIdentity": {
      "type": "string",
      "description": "Identity of the authorizing human (email, user ID) — will be SHA-256 hashed, never stored raw"
    },
    "validityDays": {
      "type": "number",
      "minimum": 1,
      "maximum": 365,
      "description": "Custom validity period in days (overrides verification level default, max 365)"
    },
    "entityId": {
      "type": "string",
      "description": "Optional entity ID to scope the authorization to a specific business"
    }
  },
  "required": [
    "agentId",
    "agentType",
    "actions",
    "verificationLevel",
    "principalIdentity"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Verify an HAP authorization credential. Checks the cryptographic signature, expiration, and real-time revocation status. Use this before honoring an agent's request to act on a human's behalf. Submit the full credential JSON and get back a verification result.

{
  "type": "object",
  "properties": {
    "credential": {
      "type": "string",
      "description": "The full HAP credential as a JSON string"
    }
  },
  "required": [
    "credential"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the real-time status of an HAP authorization credential. Returns whether the credential is active, expired, revoked, or suspended. Use this for lightweight status checks without submitting the full credential.

{
  "type": "object",
  "properties": {
    "authId": {
      "type": "string",
      "description": "The credential's authId (urn:uuid:... format)"
    }
  },
  "required": [
    "authId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search the Nordax AI entity network. Returns verified, structured business entity data ranked by trust tier and AI visibility score. Supports free-text queries, category filtering (LocalBusiness, Restaurant, MedicalBusiness, etc.), and location filtering.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query — business name, category, or description"
    },
    "location": {
      "type": "string",
      "description": "Location filter (e.g. 'Austin, TX' or 'Nashville')"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 10)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch detailed data about a specific Nordax AI entity by URL or slug. Returns the full entity profile including verification status, trust tier, contact info, services, AI visibility score, and llms.txt summary (if available). Use this after search to get complete entity details.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Entity URL (e.g. 'https://nordax.ai/entities/acme-plumbing-abc123') or entity slug"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}