> ## Documentation Index
> Fetch the complete documentation index at: https://gcore.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Learn how to start building with Gcore's REST APIs.

# Gcore API Overview

Every Gcore product is backed by a public REST API — the same API used by the Customer Portal and the official SDKs. All product APIs are available under the same base URL: `https://api.gcore.com`.

## Use cases

Gcore's API covers the full operational lifecycle — not just read operations, but provisioning, configuration changes, and event-driven automation. Common use cases include:

* Automating CDN cache purges, DNS record updates, and VM provisioning.
* Integrating Gcore services into CI/CD pipelines, Terraform workflows, Kubernetes Operators, and custom back-office tools.
* Reacting to real-time metrics and keeping infrastructure in a desired state without manual intervention.

## Base URLs by product

Each Gcore product has its own path prefix on the shared base `https://api.gcore.com`:

| Service                            | Base URL                              | Reseller API                                           |
| ---------------------------------- | ------------------------------------- | ------------------------------------------------------ |
| Identity & Access Management (IAM) | `https://api.gcore.com/iam`           | [IAM reseller](/api-reference/iam-resellers)           |
| Content Delivery Network (CDN)     | `https://api.gcore.com/cdn`           | [CDN reseller](/api-reference/cdn-resellers)           |
| Managed DNS                        | `https://api.gcore.com/dns`           | —                                                      |
| Cloud, GPU Cloud & AI Inference    | `https://api.gcore.com/cloud`         | [Cloud reseller](/api-reference/cloud-resellers)       |
| Object Storage                     | `https://api.gcore.com/storage`       | —                                                      |
| FastEdge (Edge Functions)          | `https://api.gcore.com/fastedge`      | [FastEdge reseller](/api-reference/fastedge-resellers) |
| Video Streaming                    | `https://api.gcore.com/streaming`     | —                                                      |
| DDoS                               | `https://api.gcore.com/security/iaas` | —                                                      |
| WAAP                               | `https://api.gcore.com/waap`          | [WAAP reseller](/api-reference/waap-resellers)         |
| Billing                            | —                                     | [Billing reseller](/api-reference/billing)             |

## Authentication

An [API token](/account-settings/api-tokens#create-a-permanent-api-token) is required — generate one in **Customer Portal → [API tokens](https://portal.gcore.com/accounts/profile/api-tokens)**, then pass it as an `APIKey` value in the `Authorization` header:

```http theme={null}
GET https://api.gcore.com/iam/clients/me
Authorization: APIKey <YOUR_TOKEN>
```

The `Authorization` header is case-insensitive. The same API token works across all Gcore product APIs. [Reseller accounts](/reseller-support/api) authenticate with a separate Admin Portal token.

## Quick start

Verify the token by fetching account details:

```bash theme={null}
curl -H "Authorization: APIKey $GCORE_TOKEN" "https://api.gcore.com/iam/clients/me"
```

A `200 OK` response confirms the token is valid.

## SDKs and Terraform

Three official clients cover the most common languages and infrastructure workflows:

| Tool               | Install                                                                                                                                      |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Python SDK         | `pip install gcore` — [github.com/G-Core/gcore-python](https://github.com/G-Core/gcore-python)                                               |
| Go SDK             | `go get github.com/G-Core/gcore-go` — [github.com/G-Core/gcore-go](https://github.com/G-Core/gcore-go)                                       |
| Terraform Provider | `required_providers { gcore = { source = "G-Core/gcore" } }` — [registry.terraform.io](https://registry.terraform.io/providers/G-Core/gcore) |

## Support

For production incidents, check [status.gcore.com](https://status.gcore.com). Developer questions go to GitHub Discussions in the relevant SDK repo or to [support@gcore.com](mailto:support@gcore.com). Feature requests and bugs are tracked on [Gcore Roadmap](https://roadmap.gcore.com/).