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

# Introduction

# Gcore API overview

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

## Use cases

Gcore's API covers provisioning, configuration changes, and event-driven automation, as well as read operations:

* 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`. Requests use HTTPS on TCP port 443, which means a firewall that allows outbound HTTPS already covers the API.

| 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) is required, so generate one in the Customer Portal and 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`, [gcore-python](https://github.com/G-Core/gcore-python)                                                              |
| Go SDK             | `go get github.com/G-Core/gcore-go`, [gcore-go](https://github.com/G-Core/gcore-go)                                                      |
| Terraform Provider | `required_providers { gcore = { source = "G-Core/gcore" } }`, [Terraform Registry](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/).