---
title: "Get Comprehensive Pricing Details"
method: GET
path: "/v1/usage/costs"
tags: ["Pricing"]
---

# Get Comprehensive Pricing Details

`GET /v1/usage/costs`

Retrieves comprehensive pricing details for all API features including usage costs, service costs, and special pricing features.

## Headers

- `x-api-key` string, required

## Response `200`

Successful Response

- PricingDetailsOutput — Comprehensive pricing details for all API features. Includes usage costs for all API operations and additional service costs.
  - `usage_pricing` UsagePricingModel, required — Unified pricing model for all API usage costs. Captures input and output token costs, agent costs, and additional fees for different cost structures.
    - `swarm_completions_agent_cost` number — Cost per agent in swarm completions (USD).
    - `swarm_completions_input_cost_per_1m` number — Cost per 1 million input tokens for swarm completions (USD).
    - `swarm_completions_output_cost_per_1m` number — Cost per 1 million output tokens for swarm completions (USD).
    - `agent_completions_input_cost_per_1m` number — Cost per 1 million input tokens for agent completions (USD).
    - `agent_completions_output_cost_per_1m` number — Cost per 1 million output tokens for agent completions (USD).
    - `agent_completions_img_cost` number — Cost per image for agent completions (USD).
    - `agent_completions_mcp_cost` number — Cost per MCP call for agent completions (USD).
    - `search_cost` number — Cost per search operation in dollars (USD).
    - `scrape_cost` number — Cost per scrape operation in dollars (USD).
    - `night_time_discount` number — Discount multiplier for night time usage (0.50 = 50% discount).
  - `timestamp` string, nullable — ISO timestamp when the pricing information was retrieved.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/swarms/apis/swarms-api.md) · [All operations](https://skmtc.net/swarms/apis/swarms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swarms/swarms-api/revisions/2575bd7539ca/schema)