> For the complete documentation index, see [llms.txt](https://docs.ai.neevcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ai.neevcloud.com/api-reference/billing/pricing.md).

# Pricing

## List all products in the catalog

> Retrieve a paginated list of products with optional filtering by name

```json
{"openapi":"3.0.3","info":{"title":"Billing Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/billing","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token for authentication"}},"schemas":{"ProductListResponse":{"type":"object","description":"Paginated list of products","required":["products","pagination"],"properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ProductResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}}},"ProductResponse":{"type":"object","description":"Product information with timestamps","required":["product_id","name","unit","created_at","updated_at"],"properties":{"product_id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"unit":{"type":"string"},"category":{"type":"string"},"product_type":{"type":"string"},"attributes":{"type":"object","additionalProperties":true,"nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"PaginationResponse":{"type":"object","description":"Pagination metadata","required":["total_items","total_pages","current_page","items_per_page"],"properties":{"total_items":{"type":"integer","description":"Total number of items across all pages","minimum":0},"total_pages":{"type":"integer","description":"Total number of pages","minimum":0},"current_page":{"type":"integer","description":"Current page number","minimum":1},"items_per_page":{"type":"integer","description":"Number of items per page","minimum":1,"maximum":100}}},"ErrorResponse":{"type":"object","description":"A standard format for error responses.","properties":{"code":{"type":"string","description":"A machine-readable error code."},"message":{"type":"string","description":"A human-readable message providing details about the error."}},"required":["code","message"]}}},"paths":{"/api/v1/pricing/products":{"get":{"tags":["Pricing"],"summary":"List all products in the catalog","description":"Retrieve a paginated list of products with optional filtering by name","operationId":"listProducts","parameters":[{"name":"page","in":"query","description":"Page number for pagination","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Number of items per page","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"name","in":"query","description":"Filter products by name (case-insensitive partial match)","required":false,"schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Products retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductListResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## List AI models for inference

> Retrieve a paginated list of AI models with pricing information and technical attributes. Supports search across model name, description, tags, and features.

```json
{"openapi":"3.0.3","info":{"title":"Billing Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/billing","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token for authentication"}},"schemas":{"TaskType":{"type":"string","enum":["chat","embeddings","image-generation"],"description":"Task type filter for AI models"},"OrderBy":{"type":"string","enum":["most_recent","name_asc","name_desc"],"description":"Sort order for listing models","default":"most_recent"},"ModelListResponse":{"type":"object","required":["products","pagination"],"properties":{"products":{"type":"array","items":{"$ref":"#/components/schemas/ModelProductResponse"}},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}}},"ModelProductResponse":{"type":"object","required":["product_id","model_id","name","product_type","unit","attributes","input_token_price","output_token_price","currency"],"properties":{"product_id":{"type":"string","description":"Unique product identifier"},"model_id":{"type":"string","description":"Model identifier in provider format (provider/model)"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"product_type":{"type":"string"},"unit":{"type":"string"},"attributes":{"$ref":"#/components/schemas/ModelAttributes"},"input_token_price":{"type":"number","format":"float","description":"Price per input token"},"output_token_price":{"type":"number","format":"float","description":"Price per output token"},"currency":{"type":"string"}}},"ModelAttributes":{"type":"object","required":["provider","task_type","context_window"],"properties":{"provider":{"type":"string"},"task_type":{"type":"string"},"context_window":{"type":"integer"},"parameters":{"type":"string","nullable":true},"tags":{"type":"array","description":"Labels for the model (e.g., Reasoning, Fast)","items":{"type":"string"}},"features":{"type":"array","description":"Feature list or selling points","items":{"type":"string"}}}},"PaginationResponse":{"type":"object","description":"Pagination metadata","required":["total_items","total_pages","current_page","items_per_page"],"properties":{"total_items":{"type":"integer","description":"Total number of items across all pages","minimum":0},"total_pages":{"type":"integer","description":"Total number of pages","minimum":0},"current_page":{"type":"integer","description":"Current page number","minimum":1},"items_per_page":{"type":"integer","description":"Number of items per page","minimum":1,"maximum":100}}},"ErrorResponse":{"type":"object","description":"A standard format for error responses.","properties":{"code":{"type":"string","description":"A machine-readable error code."},"message":{"type":"string","description":"A human-readable message providing details about the error."}},"required":["code","message"]}}},"paths":{"/api/v1/products/models-api":{"get":{"tags":["Pricing"],"summary":"List AI models for inference","description":"Retrieve a paginated list of AI models with pricing information and technical attributes. Supports search across model name, description, tags, and features.","operationId":"listModelsAPI","parameters":[{"name":"search","in":"query","description":"Search query to filter models by name, description, tags, or features (case-insensitive partial match)","required":false,"schema":{"type":"string"}},{"name":"task_type","in":"query","description":"Filter by task type (e.g., chat, embeddings, image-generation)","required":false,"schema":{"$ref":"#/components/schemas/TaskType"}},{"name":"provider","in":"query","description":"Filter by provider (e.g., openai, anthropic). Searches within the providers array in attributes.","required":false,"schema":{"type":"string"}},{"name":"order_by","in":"query","description":"Sort order","required":false,"schema":{"$ref":"#/components/schemas/OrderBy"}},{"name":"page","in":"query","description":"Page number","required":false,"schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Items per page","required":false,"schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"Models retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelListResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## List price definitions with product information

> Retrieve currently effective price definitions with joined product information, supporting filters for product\_id(s), region\_id, plan\_id, currency, plan\_type, and resource\_type

```json
{"openapi":"3.0.3","info":{"title":"Billing Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/billing","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token for authentication"}},"schemas":{"PriceListResponse":{"type":"object","description":"Paginated list of price definitions with product information","required":["prices","pagination"],"properties":{"prices":{"type":"array","items":{"$ref":"#/components/schemas/PriceDefinitionWithProduct"}},"pagination":{"$ref":"#/components/schemas/PaginationResponse"}}},"PriceDefinitionWithProduct":{"type":"object","description":"Price definition with joined product information","required":["price_id","price_plan_id","product_id","price_type","currency","effective_from","version","created_at","updated_at","product_name","product_unit","is_active","plan_type"],"properties":{"price_id":{"type":"string"},"price_plan_id":{"type":"string"},"product_id":{"type":"string"},"price_type":{"type":"string","enum":["flat","tiered","volume"]},"unit_price":{"type":"number","format":"double","nullable":true,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"region_id":{"type":"string","nullable":true},"effective_from":{"type":"string","format":"date-time"},"effective_until":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"product_name":{"type":"string","description":"Product name from joined products table"},"product_description":{"type":"string","description":"Product description from joined products table","nullable":true},"product_unit":{"type":"string","description":"Product unit from joined products table"},"is_active":{"type":"boolean","description":"Whether the associated pricing plan is active"},"plan_type":{"type":"string","description":"Type of the associated pricing plan","enum":["ondemand","reserved"]},"off_percent":{"type":"number","format":"double","description":"Percentage discount compared to on-demand pricing (0-100)","minimum":0,"maximum":100,"nullable":true},"amount_saved":{"type":"number","format":"double","description":"Absolute amount saved compared to on-demand unit price; only for reserved plans","nullable":true},"metadata":{"type":"object","additionalProperties":true,"description":"Additional metadata for the pricing (e.g., free_usage_quantity and free_usage_unit for storage plans)","nullable":true}}},"PaginationResponse":{"type":"object","description":"Pagination metadata","required":["total_items","total_pages","current_page","items_per_page"],"properties":{"total_items":{"type":"integer","description":"Total number of items across all pages","minimum":0},"total_pages":{"type":"integer","description":"Total number of pages","minimum":0},"current_page":{"type":"integer","description":"Current page number","minimum":1},"items_per_page":{"type":"integer","description":"Number of items per page","minimum":1,"maximum":100}}},"ErrorResponse":{"type":"object","description":"A standard format for error responses.","properties":{"code":{"type":"string","description":"A machine-readable error code."},"message":{"type":"string","description":"A human-readable message providing details about the error."}},"required":["code","message"]}}},"paths":{"/api/v1/pricing/plans":{"get":{"tags":["Pricing"],"summary":"List price definitions with product information","description":"Retrieve currently effective price definitions with joined product information, supporting filters for product_id(s), region_id, plan_id, currency, plan_type, and resource_type","operationId":"listPlans","parameters":[{"name":"product_id","in":"query","description":"Filter by product ID(s) - comma-separated list","required":false,"schema":{"type":"string"}},{"name":"region_id","in":"query","description":"Filter by region ID","required":false,"schema":{"type":"string"}},{"name":"plan_id","in":"query","description":"Filter by pricing plan ID","required":false,"schema":{"type":"string"}},{"name":"currency","in":"query","description":"Filter by currency","required":false,"schema":{"type":"string","enum":["USD","INR","EUR"]}},{"name":"plan_type","in":"query","description":"Filter by pricing plan type","required":false,"schema":{"type":"string","enum":["ondemand","reserved"]}},{"name":"resource_type","in":"query","description":"Filter by resource type. Supports both prefix matching (e.g., 'gpu' matches product_ids starting with 'gpu-') and category matching (e.g., 'llm_inference', 'storage'). Common prefix values: gpu, storage, network, cpu, airuntime","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","description":"Page number for pagination","required":false,"schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","description":"Number of items per page","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Price definitions retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PriceListResponse"}}}},"400":{"description":"Invalid request parameters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Retrieve details of a specific pricing plan

> Get detailed information about a pricing plan including its price definitions

```json
{"openapi":"3.0.3","info":{"title":"Billing Service API","version":"0.1.0"},"servers":[{"url":"https://api.ai.neevcloud.com/billing","description":"Consolidated public API gateway"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token for authentication"}},"schemas":{"PricePlanDetailResponse":{"type":"object","description":"Detailed pricing plan information with price definitions","required":["id","description","plan_type","is_active","created_at","updated_at","price_definitions"],"properties":{"id":{"type":"string"},"description":{"type":"string"},"plan_type":{"type":"string"},"commitment_duration":{"type":"string","nullable":true},"is_active":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"price_definitions":{"type":"array","items":{"$ref":"#/components/schemas/PriceDefinition"}}}},"PriceDefinition":{"type":"object","description":"Price definition for a specific product and plan","required":["price_id","price_plan_id","product_id","price_type","currency","effective_from","version","created_at","updated_at"],"properties":{"price_id":{"type":"string"},"price_plan_id":{"type":"string"},"product_id":{"type":"string"},"price_type":{"type":"string","enum":["flat","tiered","volume"]},"unit_price":{"type":"number","format":"double","nullable":true,"minimum":0},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"region_id":{"type":"string","nullable":true},"effective_from":{"type":"string","format":"date-time"},"effective_until":{"type":"string","format":"date-time","nullable":true},"version":{"type":"integer"},"metadata":{"type":"object","additionalProperties":true,"nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","description":"A standard format for error responses.","properties":{"code":{"type":"string","description":"A machine-readable error code."},"message":{"type":"string","description":"A human-readable message providing details about the error."}},"required":["code","message"]}}},"paths":{"/api/v1/pricing/plans/{plan_id}":{"get":{"tags":["Pricing"],"summary":"Retrieve details of a specific pricing plan","description":"Get detailed information about a pricing plan including its price definitions","operationId":"getPricePlanByID","parameters":[{"name":"plan_id","in":"path","required":true,"description":"The unique identifier of the pricing plan","schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"Pricing plan details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PricePlanDetailResponse"}}}},"404":{"description":"Pricing plan not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.ai.neevcloud.com/api-reference/billing/pricing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.