Dedicated server API quickstart

Inspect dedicated server services and trigger power actions programmatically. Bare metal in Romania, IPMI included.

1. List dedicated servers

curl -X GET https://www.pidginhost.com/api/v1/dedicated/servers/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN"

2. Inspect a server

curl -X GET https://www.pidginhost.com/api/v1/dedicated/servers/<id>/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN"

Returns hostname, service status, IPs, operating system, billing cycle, and next invoice date.

3. Restart a server

curl -X POST https://www.pidginhost.com/api/v1/dedicated/servers/<id>/power/ \
  -H "Authorization: Token $PIDGINHOST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

Power operations require the service to be active and a backend server to be available.

phctl CLI

phctl dedicated server list
phctl dedicated server get <id>
phctl dedicated server power <id> --action restart

Need the full reference?

Every endpoint with Python, JavaScript, PHP, Go, Rust, CLI, and curl examples.

Open full API docs OpenAPI / Swagger UI

Ready to launch your infrastructure?

Create an account in minutes. The free cloud tier includes one server per customer after at least €10 in confirmed account deposits. Money-back eligibility varies by service.

Create your account or talk to our team