Back to Home

API Documentation

Manage your own servers programmatically - list them, check live resource usage, run power actions, and manage backups.

Authentication

Create an API key from your dashboard's API tab. Every key is scoped to your own account - it can only see and control servers you own. Pass it as a bearer token on every request:

curl -X GET https://ngpcloud.in/api/v1/servers \
  -H "Authorization: Bearer ngp_your_key_here"

The raw key is only ever shown once, at creation. If you lose it, revoke it and create a new one.

Code Examples

Every example on this page - above and in the endpoint reference below - updates to match the language you pick here.

Base URL & Rate Limits

Base URL

https://ngpcloud.in/api/v1

Rate Limit

60 requests / minute per IP

Endpoints

GET/api/v1/servers

List every server on your account.

Request

curl -X GET https://ngpcloud.in/api/v1/servers \
  -H "Authorization: Bearer ngp_your_key_here"

Response

{
  "servers": [
    {
      "id": 42,
      "name": "My Minecraft Server",
      "status": "active",
      "pterodactyl_id": 85,
      "created_at": "2026-06-01T12:00:00.000Z",
      "plans": { "name": "Pro", "category": "Minecraft" }
    }
  ]
}
GET/api/v1/servers/:id/resources

Live CPU, memory, disk and network usage for one server.

Request

curl -X GET https://ngpcloud.in/api/v1/servers/42/resources \
  -H "Authorization: Bearer ngp_your_key_here"

Response

{
  "resources": {
    "state": "running",
    "resources": {
      "cpu_absolute": 12.4,
      "memory_bytes": 512000000,
      "disk_bytes": 1200000000,
      "network": { "rx_bytes": 10240, "tx_bytes": 20480 }
    }
  }
}
POST/api/v1/servers/:id/power

Start, stop, restart, or kill a server.

Request

curl -X POST https://ngpcloud.in/api/v1/servers/42/power \
  -H "Authorization: Bearer ngp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"action":"restart"}'

Response

{ "success": true }
GET/api/v1/servers/:id/backups

List backups for a server.

Request

curl -X GET https://ngpcloud.in/api/v1/servers/42/backups \
  -H "Authorization: Bearer ngp_your_key_here"

Response

{
  "backups": [
    { "uuid": "a1b2c3d4-...", "name": "backup-2026-09-14", "is_successful": true, "bytes": 104857600 }
  ]
}
POST/api/v1/servers/:id/backups

Create a new backup.

Request

curl -X POST https://ngpcloud.in/api/v1/servers/42/backups \
  -H "Authorization: Bearer ngp_your_key_here"

Response

{
  "backup": { "uuid": "e5f6g7h8-...", "name": "backup-2026-09-14", "is_successful": false }
}

Errors

Errors return a JSON body with an error field and an appropriate status code.

{ "error": "Server not found" }
401Missing, invalid, or revoked API key
404Server not found, or not owned by this key
429Rate limit exceeded
502The panel failed to respond - try again shortly

Ready to build?

Create your first API key from the dashboard.

Go to Dashboard