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

## Authentication

An [API token](https://docs.gcore.com/account-settings/api-tokens.md) 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](https://docs.gcore.com/reseller-support/api.md) authenticate with a separate Admin Portal token.

## Rate limits

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

The [login](https://docs.gcore.com/api-reference/iam/account/login.md) 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.

Sending a request from the browser UI is shown in [Use the reference](https://docs.gcore.com/developer-tools/rest-api/use-the-api-reference.md).

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