EntRoute API

openapi: 3.1.0
info:
  title: EntRoute API
  version: '2026-11-06'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-06: 6 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; EntRoute has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 4
    pages-with-code: 2
    pages-read: 3
  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://entroute.com/docs/api
  - https://api.entroute.com
  - https://entroute.com/docs/quickstart
paths:
  /capabilities:
    get:
      operationId: get_capabilities
      tags:
      - Capabilities
      summary: GET /capabilities
      x-source: https://entroute.com/docs/api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCapabilitiesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://api.entroute.com/capabilities POST /discover Discover ranked endpoints for a capability. Accepts either a capability_id\
          \ or\n a natural language intent . Request body: {\n \"capability_id\" : \"defi.token_price\" , //or use \"intent\" \n \"intent\" :\
          \ \"get the price of ETH\" , //natural language \n \"constraints\" : {\n \"max_price\" : 0.01 ,\n \"network\" : \"base\" ,\n \"verified_only\"\
          \ : true \n },\n \"preferenc"
    post:
      operationId: post_capabilities
      tags:
      - Capabilities
      summary: POST /capabilities
      x-source: https://entroute.com/docs/quickstart
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCapabilitiesRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl TypeScript SDK MCP Server Using cURL The simplest way to test EntRoute is with cURL. No authentication required for basic
          discovery. 1. List Capabilities curl https://api.entroute.com/capabilities | jq 2. Discover Endpoints by Capability ID curl -X POST
          https://api.entroute.com/discover  -H "Content-Type: application/json"  -d ''{"capability_id": "defi.token_price"}'' 3. Discover Endpoints
          by I'
  /discover:
    post:
      operationId: post_discover
      tags:
      - Discover
      summary: Discover ranked endpoints for a capability.
      x-source: https://entroute.com/docs/api
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostDiscoverRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDiscoverResponse'
      x-evidence:
        kind: documentation
  /report_outcome:
    post:
      operationId: post_report_outcome
      tags:
      - Report Outcome
      summary: Report the outcome of calling an endpoint.
      x-source: https://entroute.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostReportOutcomeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /stats:
    get:
      operationId: get_stats
      tags:
      - Stats
      summary: Public network statistics
      x-source: https://api.entroute.com
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /submit:
    post:
      operationId: post_submit
      tags:
      - Submit
      summary: Submit a new endpoint for listing.
      x-source: https://entroute.com/docs/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostSubmitRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetCapabilitiesResponse:
      type: object
      properties:
        resolved:
          type: object
          properties:
            capability_id:
              type: string
            confidence:
              type: number
        ranked_endpoints:
          type: array
          items:
            type: object
            properties:
              provider_name:
                type: string
              url:
                type: string
              method:
                type: string
              score:
                type: number
              payment:
                type: object
                properties:
                  type:
                    type: string
                  price_per_call:
                    type: number
                  network:
                    type: string
                  accepted_assets:
                    type: array
                    items:
                      type: string
              observed:
                type: object
                properties:
                  success_rate_7d:
                    type: number
                  p95_latency_ms:
                    type: integer
        fallback_endpoints:
          type: array
          items: {}
        ttl_seconds:
          type: integer
    PostCapabilitiesRequest:
      type: object
      properties:
        capability_id:
          type: string
    PostDiscoverRequest:
      type: object
      properties:
        capability_id:
          type: string
          description: Capability identifier
        intent:
          type: string
          description: Natural language intent
        constraints:
          type: object
          description: Constraints for discovery
        preferences:
          type: object
          description: Preferences for ranking
    PostDiscoverResponse:
      type: object
      properties:
        resolved:
          type: object
          description: Resolved capability information
        ranked_endpoints:
          type: array
          description: List of ranked endpoints
        fallback_endpoints:
          type: array
          description: Fallback endpoints
        ttl_seconds:
          type: integer
          description: Time‑to‑live in seconds
    PostReportOutcomeRequest:
      type: object
      properties:
        endpoint_id:
          type: string
          description: Endpoint identifier (uuid)
        success:
          type: boolean
          description: Whether the call succeeded
        latency_ms:
          type: integer
          description: Latency in milliseconds
        status_code:
          type: integer
          description: HTTP status code
      required:
      - endpoint_id
      - success
      - latency_ms
      - status_code
    PostSubmitRequest:
      type: object
      properties:
        endpoint_url:
          type: string
          description: URL of the endpoint
        capability_id:
          type: string
          description: Capability identifier
        contact_email:
          type: string
          description: Contact email
        provider_name:
          type: string
          description: Name of the provider
        price_per_call:
          type: number
          description: Price per call
      required:
      - endpoint_url
      - capability_id
      - contact_email
      - provider_name
      - price_per_call
tags:
- name: Capabilities
- name: Discover
- name: Report Outcome
- name: Stats
- name: Submit