EvoHub DocsEvoHub Docs Sign in

Get the commitment

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs.evohub.io/mcp

Add to CursorAdd to VS Code

Claude Code

claude mcp add --transport http evohub-docs https://docs.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs": {
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs": {
      "type": "http",
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

llms.txtllms-full.txt

GET/api/v1/billing/commitment

What is on offer and what is running: the agreement (terms, left out while commitments are not offered), the commitment in force (active, left out when there is none), when a commitment agreed today would start (starts_on, the first day of next month), the commitment and on-demand prices per EHU for the organization, what ending the active commitment today would cost (estimated_clawback_usd), and the last 24 commitments.

Requires the billing:usage:read scope.

Authorization

Any one of:

Responses

200

The commitment state.

Content type: application/json

Type: object

  • data CommitmentState
    Show CommitmentState properties
    • terms CommitmentTerms
      Show CommitmentTerms properties
      • version integer
      • body string
        The full text of the agreement.
      • body_sha256 string
      • term_months integer
      • published_at string (date-time)
    • active Commitment
      Show Commitment properties
      • id integer
      • org_id string
      • ehu_per_month number
      • starts_on string (date-time)
        The first day of the first committed month.
      • ends_on string (date-time)
        The first day after the term (exclusive).
      • status string
        One of: active completed terminated
      • terms_version integer
      • terms_sha256 string
        The hash of the agreement text that was accepted.
      • accepted_at string (date-time)
      • accepted_by string
        The person, or the organization key, that accepted.
      • accepted_ip string
      • terminated_at string (date-time)
      • terminated_from string (date-time)
        The first month no longer committed, for an ended commitment.
      • terminated_by string
      • clawback_usd number
        The early-termination charge.
      • clawback_invoice_id string
      • clawback_invoice_url string (uri)
      • clawback_invoice_pdf_url string (uri)
      • clawback_invoiced_at string (date-time)
      • ending_notice_at string (date-time)
        When the organization was told the term is nearly over.
      • created_at string (date-time)
    • starts_on string (date-time)
      When a commitment agreed now would start.
    • estimated_clawback_usd number
      What ending the active commitment today would cost; 0 without one.
    • commitment_usd_per_ehu number
    • on_demand_usd_per_ehu number
    • history array of Commitment
      The last 24 commitments.
      Show Commitment properties
      • id integer
      • org_id string
      • ehu_per_month number
      • starts_on string (date-time)
        The first day of the first committed month.
      • ends_on string (date-time)
        The first day after the term (exclusive).
      • status string
        One of: active completed terminated
      • terms_version integer
      • terms_sha256 string
        The hash of the agreement text that was accepted.
      • accepted_at string (date-time)
      • accepted_by string
        The person, or the organization key, that accepted.
      • accepted_ip string
      • terminated_at string (date-time)
      • terminated_from string (date-time)
        The first month no longer committed, for an ended commitment.
      • terminated_by string
      • clawback_usd number
        The early-termination charge.
      • clawback_invoice_id string
      • clawback_invoice_url string (uri)
      • clawback_invoice_pdf_url string (uri)
      • clawback_invoiced_at string (date-time)
      • ending_notice_at string (date-time)
        When the organization was told the term is nearly over.
      • created_at string (date-time)

401

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: STATEMENT_NOT_FOUND
    • message string required
      Example: No statement for that period.
    • request_id string

403

The key lacks the scope this endpoint needs (FORBIDDEN).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: STATEMENT_NOT_FOUND
    • message string required
      Example: No statement for that period.
    • request_id string

429

Too many requests (RATE_LIMITED). Wait for Retry-After seconds.

Headers

  • Retry-After integer
    Seconds to wait before retrying.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: STATEMENT_NOT_FOUND
    • message string required
      Example: No statement for that period.
    • request_id string

500

The commitment could not be loaded (COMMITMENT_UNAVAILABLE). Retry later.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Example: STATEMENT_NOT_FOUND
    • message string required
      Example: No statement for that period.
    • request_id string

Example request

curl -X GET 'https://evohub.io/api/v1/billing/commitment' \
  -H 'Authorization: Bearer <TOKEN>'