ENTIA Systems API

openapi: 3.1.0
info:
  title: ENTIA Systems API
  version: '2026-11-06'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-06: 28 operation(s) read from 6 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; ENTIA Systems has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 6
    documentation: 22
    pages-with-code: 3
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-06'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://entia.systems/api-reference
  - https://entia.systems/developers
  - https://entia.systems/methodology
  - https://entia.systems/mcp-docs
  - https://entia.systems/mcp-setup
  - https://entia.systems/mcp-referral
servers:
- url: https://api.entia.systems
paths:
  /api/v1/audit:
    post:
      operationId: post_api_v1_audit
      tags:
      - Api
      summary: POST https://entia.systems/api/v1/audit
      description: Analyzes cognitive resistance for a domain, returning layer breakdown, risk level, and version.
      x-source: https://entia.systems/methodology
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1AuditRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1AuditResponse'
      x-evidence:
        kind: documentation
  /api/v1/corpus/bulk:
    get:
      operationId: get_api_v1_corpus_bulk
      tags:
      - Api
      summary: Descarga masiva. Exige licencia de corpus firmada, no un plan.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/corpus/license/offer:
    get:
      operationId: get_api_v1_corpus_license_offer
      tags:
      - Api
      summary: Oferta de licencia del corpus, legible por máquina.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/demo/lookup:
    get:
      operationId: get_api_v1_demo_lookup
      tags:
      - Api
      summary: GET /api/v1/demo/lookup
      x-source: https://entia.systems/api-reference
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s 'https://api.entia.systems/api/v1/demo/lookup?q=A28015865' \n Respuesta REAL medida el 2026-08-27 json {\n \"found\"\
          : true,\n \"query\": \"A28015865\",\n \"entity\": {\n \"name\": \"TELEFONICA SA\",\n \"legal_id\": \"A28015865\",\n \"country_code\"\
          : \"ES\",\n \"sector\": \"tecnologia\",\n \"city\": \"MADRID\"\n },\n \"access_level\": \"trace_preview\",\n \"gated_fields\": [\n \"\
          trust_score\",\n \"borme\",\n \"gleif\",\n \"signature\",\n \"full_doss"
  /api/v1/entitlement/classify:
    post:
      operationId: post_api_v1_entitlement_classify
      tags:
      - Api
      summary: Clasifica un acceso frente a la política.
      x-source: https://entia.systems/api-reference
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/entitlement/policy:
    get:
      operationId: get_api_v1_entitlement_policy
      tags:
      - Api
      summary: Política de acceso vigente y su modo de aplicación.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1EntitlementPolicyResponse'
      x-evidence:
        kind: documentation
  /api/v1/entitlement/status:
    get:
      operationId: get_api_v1_entitlement_status
      tags:
      - Api
      summary: Situación del llamante frente a esa política.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/evidence/index:
    get:
      operationId: get_api_v1_evidence_index
      tags:
      - Api
      summary: Índice del manifiesto de evidencia, redactado.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/mcp/checkout:
    get:
      operationId: get_api_v1_mcp_checkout
      tags:
      - Api
      summary: GET /api/v1/mcp/checkout
      x-source: https://entia.systems/api-reference
      parameters:
      - name: tier
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl -sI 'https://api.entia.systems/api/v1/mcp/checkout?tier=signal'
    post:
      operationId: post_api_v1_mcp_checkout
      tags:
      - Api
      summary: POST /api/v1/mcp/checkout
      x-source: https://entia.systems/mcp-docs
      parameters:
      - name: tier
        in: query
        required: false
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1McpCheckoutRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sI 'https://api.entia.systems/api/v1/mcp/checkout?tier=signal' \n Tras el pago, la clave se revela en /mcp-dashboard .\n\
          SCALE y ENTERPRISE no tienen checkout público: se contratan en\n fv@entia.systems . \n 07 Procedencia y límites De dónde sale cada dato\
          \ y qué es exactamente lo que ENTIA no afirma. \n El MCP es una proyección operativa del grafo canónico de identidad económica de ENTIA.\n\
          Cada res"
  /api/v1/mcp/enterprise/contact:
    post:
      operationId: post_api_v1_mcp_enterprise_contact
      tags:
      - Api
      summary: Contacto para SCALE y ENTERPRISE, que no tienen checkout público.
      x-source: https://entia.systems/api-reference
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1McpEnterpriseContactRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1McpEnterpriseContactResponse'
      x-evidence:
        kind: documentation
  /api/v1/mcp/key/validate:
    get:
      operationId: get_api_v1_mcp_key_validate
      tags:
      - Api
      summary: GET /api/v1/mcp/key/validate
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -s https://api.entia.systems/api/v1/mcp/key/validate -H \"x-entia-key: $ENTIA_KEY\" \n Tras el pago, la clave se revela\
          \ en /mcp-dashboard . Los planes\nSCALE y ENTERPRISE no tienen checkout público: se contratan por\n /api/v1/mcp/enterprise/contact o\
          \ en\n fv@entia.systems . \n Formas de mandarla \n Familia Formas aceptadas /api/v1/v3/* solo x-entia-key /v1/profile , /v1/verify/vat\
          \ x-entia-key , Autho"
  /api/v1/mcp/plans:
    get:
      operationId: get_api_v1_mcp_plans
      tags:
      - Api
      summary: Catálogo de planes con precio, cuota y si es self-serve.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1McpPlansResponse'
      x-evidence:
        kind: documentation
  /api/v1/mcp/referral/claim:
    post:
      operationId: post_api_v1_mcp_referral_claim
      tags:
      - Api
      summary: POST /api/v1/mcp/referral/claim
      x-source: https://entia.systems/mcp-referral
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1McpReferralClaimRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/mcp/register:
    post:
      operationId: post_api_v1_mcp_register
      tags:
      - Api
      summary: POST /api/v1/mcp/register
      x-source: https://entia.systems/api-reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1McpRegisterRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s -X POST https://api.entia.systems/api/v1/mcp/register  -H ''Content-Type: application/json''  -d ''{"email":"tu@empresa.com"}'''
  /api/v1/profile-store/{cc}/{sector}/{city}/{slug}/{profile}:
    get:
      operationId: get_api_v1_profile_store_cc_sector_city_slug_profile
      tags:
      - Api
      summary: Perfiles derivados de una ficha publicada, cobrados por petición contra saldo en euros, no contra la cuota de un plan.
      x-source: https://entia.systems/api-reference
      parameters:
      - name: cc
        in: path
        required: true
        schema:
          type: string
      - name: sector
        in: path
        required: true
        schema:
          type: string
      - name: city
        in: path
        required: true
        schema:
          type: string
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - name: profile
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/stats/live:
    get:
      operationId: get_api_v1_stats_live
      tags:
      - Api
      summary: 'Tamaño del corpus: entidades, países, fuentes y actos BORME.'
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1StatsLiveResponse'
      x-evidence:
        kind: documentation
  /api/v1/status:
    get:
      operationId: get_api_v1_status
      tags:
      - Api
      summary: Estado agregado de la plataforma.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1StatusResponse'
      x-evidence:
        kind: documentation
  /api/v1/v3/entity_lookup:
    get:
      operationId: get_api_v1_v3_entity_lookup
      tags:
      - Api
      summary: Endpoint Parámetros Tier mínimo Equivalente MCP /api/v1/v3/entity_lookup query , country TRACE+ entity_lookup
      x-source: https://entia.systems/api-reference
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
      - name: country
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /health:
    get:
      operationId: get_health
      tags:
      - Health
      summary: Estado del gateway. Sonda de disponibilidad.
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetHealthResponse'
      x-evidence:
        kind: documentation
  /mcp:
    get:
      operationId: get_mcp
      tags:
      - Mcp
      summary: GET /mcp
      x-source: https://entia.systems/mcp-setup
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \n Copy \n Mac: ~/Library/Application Support/Claude/claude_desktop_config.json \n   Windows: %APPDATA%\\Claude\\claude_desktop_config.json\
          \ \n — then restart Claude Desktop.\n Copy \n Cursor: ~/.cursor/mcp.json \n   Windsurf: ~/.codeium/windsurf/mcp_config.json \n — same\
          \ block in both.\n Copy \n One call, no client needed — verifies your key end to end. \n 11.3M Entities \n 10 Countries \n 13 Tools\
          \ \n 100/mo"
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: MCP endpoint for JSON‑RPC tools/list
      description: Streamable HTTP JSON‑RPC endpoint at https://mcp.entia.systems/mcp.
      x-source: https://entia.systems/developers
      parameters:
      - name: x-entia-key
        in: header
        required: true
        schema:
          type: string
        description: Customer authentication header.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/authorize:
    get:
      operationId: get_oauth_authorize
      tags:
      - Oauth
      summary: Autorización GET /oauth/authorize.
      x-source: https://entia.systems/mcp-docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/register:
    post:
      operationId: post_oauth_register
      tags:
      - Oauth
      summary: Registro dinámico POST /oauth/register (RFC 7591, abierto).
      x-source: https://entia.systems/mcp-docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /oauth/token:
    post:
      operationId: post_oauth_token
      tags:
      - Oauth
      summary: Token POST /oauth/token.
      x-source: https://entia.systems/mcp-docs
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/identity/es/dental/madrid/albus-dental-studio-dentista-en-mirasierra.jsonld:
    get:
      operationId: get_v1_identity_es_dental_madrid_albus_dental_studio_dentista_en_mirasierra_json
      tags:
      - Identity
      summary: 'Devuelve 200 con content-type: application/ld+json y un @graph de Schema.org con cuatro nodos.'
      x-source: https://entia.systems/api-reference
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/profile/{query}:
    get:
      operationId: get_v1_profile_query
      tags:
      - Profile
      summary: Perfil de entidad por nombre, CIF o identificador.
      x-source: https://entia.systems/api-reference
      parameters:
      - name: query
        in: path
        required: true
        schema:
          type: string
      - name: country
        in: query
        required: false
        schema:
          type: string
        description: Pista de país opcional.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ProfileQueryResponse'
      x-evidence:
        kind: documentation
  /v1/verify/vat/{vatId}:
    get:
      operationId: get_v1_verify_vat_vatId
      tags:
      - Verify
      summary: Validación de IVA europeo.
      x-source: https://entia.systems/api-reference
      parameters:
      - name: vatId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1VerifyVatVatidResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1AuditRequest:
      type: object
      properties:
        domain:
          type: string
          description: Domain to audit
        sector_id:
          type: string
          description: Sector identifier
        name:
          type: string
          description: Entity name
        telephone:
          type: string
          description: Telephone number
        ssl:
          type: boolean
          description: SSL presence flag
        vatID:
          type: string
          description: VAT identifier
      required:
      - domain
      - sector_id
      - name
    PostApiV1AuditResponse:
      type: object
      properties:
        cognitive_resistance:
          type: number
          description: Overall cognitive resistance score
        risk_level:
          type: string
          description: Risk level classification
        layer_breakdown:
          type: object
          description: Breakdown of scores per layer
        layer_breakdown.ontology:
          type: object
          description: Ontology layer details
        layer_breakdown.ontology.score:
          type: number
          description: Score for ontology layer
        layer_breakdown.ontology.weight:
          type: number
          description: Weight for ontology layer
        layer_breakdown.syntax:
          type: object
          description: Syntax layer details
        layer_breakdown.syntax.score:
          type: number
          description: Score for syntax layer
        layer_breakdown.syntax.weight:
          type: number
          description: Weight for syntax layer
        layer_breakdown.validation:
          type: object
          description: Validation layer details
        layer_breakdown.validation.score:
          type: number
          description: Score for validation layer
        layer_breakdown.validation.weight:
          type: number
          description: Weight for validation layer
        layer_breakdown.reputation:
          type: object
          description: Reputation layer details
        layer_breakdown.reputation.score:
          type: number
          description: Score for reputation layer
        layer_breakdown.reputation.weight:
          type: number
          description: Weight for reputation layer
        version:
          type: string
          description: Engine version
    GetApiV1EntitlementPolicyResponse:
      type: object
      properties:
        any:
          type: object
          description: Política de acceso actual.
    PostApiV1McpCheckoutRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            name:
              type: string
            arguments:
              type: object
    PostApiV1McpEnterpriseContactRequest:
      type: object
      properties:
        any:
          type: object
          description: Datos de contacto según formulario.
    PostApiV1McpEnterpriseContactResponse:
      type: object
      properties:
        any:
          type: object
          description: Respuesta de contacto.
    GetApiV1McpPlansResponse:
      type: object
      properties:
        any:
          type: array
          description: Lista de planes disponibles.
    PostApiV1McpReferralClaimRequest:
      type: object
      properties:
        email:
          type: string
          description: Your email address
        github_url:
          type: string
          description: Public GitHub repository URL
        ref:
          type: string
          description: Referral tag
        use_case:
          type: string
          description: Optional use‑case description
      required:
      - email
      - github_url
      - ref
    PostApiV1McpRegisterRequest:
      type: object
      properties:
        email:
          type: string
    GetApiV1StatsLiveResponse:
      type: object
      properties:
        any:
          type: object
          description: Datos estadísticos en tiempo real del corpus.
    GetApiV1StatusResponse:
      type: object
      properties:
        any:
          type: object
          description: Respuesta del estado de la plataforma sin credencial.
    GetHealthResponse:
      type: object
      properties:
        any:
          type: object
          description: Respuesta del gateway sin credencial.
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version, e.g., "2.0".
        id:
          type: integer
          description: Request identifier.
        method:
          type: string
          description: JSON‑RPC method name, e.g., "tools/list".
        params:
          type: object
          description: Method parameters (empty for tools/list).
      required:
      - jsonrpc
      - id
      - method
    GetV1ProfileQueryResponse:
      type: object
      properties:
        any:
          type: object
          description: Perfil de la entidad solicitado.
    GetV1VerifyVatVatidResponse:
      type: object
      properties:
        valid:
          type: boolean
          description: Indica si el VAT es válido.
        vat_id:
          type: string
          description: VAT normalizado.
        country_code:
          type: string
          description: Código de país del VAT.
        name:
          type: string
          description: Nombre del titular (según disponibilidad).
        address:
          type: string
          description: Dirección del titular (según disponibilidad).
        source:
          type: string
          description: Fuente de la información.
        _meta:
          type: object
          description: Metadatos de la respuesta.
tags:
- name: Api
- name: Health
- name: Identity
- name: Mcp
- name: Oauth
- name: Profile
- name: Verify