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

# Gcore API overview

> Gcore REST endpoints share one base URL and token authentication, with quick start guides and SDKs for each product.

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)](/api-reference/iam) | `https://api.gcore.com/iam` | [IAM reseller](/api-reference/iam-resellers) |
| [Content Delivery Network (CDN)](/api-reference/cdn) | `https://api.gcore.com/cdn` | [CDN reseller](/api-reference/cdn-resellers) |
| [Managed DNS](/api-reference/dns) | `https://api.gcore.com/dns` | — |
| [Cloud, GPU Cloud & AI Inference](/api-reference/cloud) | `https://api.gcore.com/cloud` | [Cloud reseller](/api-reference/cloud-resellers) |
| [Object Storage](/api-reference/storage) | `https://api.gcore.com/storage` | — |
| [FastEdge (Edge Functions)](/api-reference/fastedge) | `https://api.gcore.com/fastedge` | [FastEdge reseller](/api-reference/fastedge-resellers) |
| [Video Streaming](/api-reference/streaming) | `https://api.gcore.com/streaming` | — |
| [DDoS](/api-reference/ddos-protection) | `https://api.gcore.com/security/iaas` | — |
| [WAAP](/api-reference/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.

## Rate limits

The API allows 100 requests per second from one IP address.

The [login](/api-reference/iam/account/login) endpoint accepts 5 requests per minute from one IP address. That address can fail login 5 times per hour, and a request over either login quota receives `429 Too Many Requests`.

## 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/).