API v2

The REST API v2 is currently in beta. Endpoints and behavior may change before general availability.

The Runpod REST API v2 provides programmatic access to your Runpod resources over standard HTTP. Use it to create and manage Pods, query Serverless endpoints, provision storage, and retrieve billing data — without using the console.

Base URL

https://api.runpod.io/v2

The Runpod REST API v2 provides programmatic access to all Runpod compute resources. Integrate GPU infrastructure into your applications, workflows, and automation systems.

Available resources

Pods: Create and manage persistent GPU instances for development, training, and long-running workloads.
Serverless: Deploy and scale containerized applications with autoscaling and job monitoring.
Templates: Save and reuse Pod and endpoint configurations.
Network volumes: Create persistent storage attachable to multiple resources.
Container registry auth: Connect to private Docker registries.
Catalog: Browse available GPU types, CPU types, and data centers.
Billing: Access usage metrics and billing information.

Authentication

All requests require a Runpod API key in the request headers. The API uses standard HTTP methods and returns JSON responses.

OpenAPI schema

Retrieve the complete OpenAPI specification for client generation, request validation, or tooling integration.

curl --request GET \
  --url https://api.runpod.io/v2/openapi.json \
  --header 'Authorization: Bearer RUNPOD_API_KEY'

import requests

url = "https://api.runpod.io/v2/openapi.json"
headers = {"Authorization": "Bearer RUNPOD_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())

List podsReturns all pods owned by the authenticated user.

Pods

Serverless

Templates

Network Volumes

Registries

Catalog

Billing

API v2

Base URL

Available resources

Authentication

OpenAPI schema

​Base URL

​Available resources

​Authentication

​OpenAPI schema

Base URL

Available resources

Authentication

OpenAPI schema