API Overview

Programmatic access to manage your Pinguzo servers and monitors via REST API.

Introduction

The Pinguzo REST API allows you to manage your servers and monitors programmatically. All requests are made to a single endpoint and authenticated with your API key. The API returns JSON responses with consistent success and error formats.

Base URL

https://cp.pinguzo.com/api/v1/rest.php

All API requests are made to this URL, with the resource query parameter determining which entity you are working with (servers, monitors, or incidents).

Rate Limiting

Each API key is limited to 1000 requests per hour. If you exceed this limit, you will receive a 429 Too Many Requests response. The rate limit window resets every hour.

Rate limit headers The rate limit is tracked per API key using a sliding 1-hour window. If you need a higher limit for your use case, contact support.

Plan Limits & API Access

API access is available on all paid plans. The Free plan does not include API access. The number of servers and monitors you can create depends on your plan:

Plan	Servers	Monitors	Min Check Interval	API Access
Free	1	5	300s (5 min)	No
Personal	1	20	60s (1 min)	Yes
Mini	2	40	60s (1 min)	Yes
Professional	10	200	60s (1 min)	Yes
Business	100	2000	60s (1 min)	Yes

Plan expiry If your paid plan expires, API access is paused until you renew. You will receive a 403 response with the error code PLAN_EXPIRED.

Getting Your API Key

Log in to your Pinguzo dashboard
Click API in the left sidebar
Your API key is displayed (masked by default). Click View Key to reveal it
Use the Copy button to copy it to your clipboard

Keep your key secret Anyone with your API key can access your Pinguzo account via the API. If your key is compromised, click Regenerate API Key on the API page — the old key will stop working immediately.

Available Resources

Resource	Methods	Description
`servers`	GET, POST, PUT, DELETE	Manage your monitored servers
`monitors`	GET, POST, PUT, DELETE	Manage uptime monitors (HTTP, HTTPS, Ping, Port, Keyword, DNS, SSL)
`incidents`	GET	List and filter incidents (read-only)

Next Steps

Authentication — learn how to pass your API key
Response Format — understand success and error responses
Servers API — manage servers programmatically
Monitors API — create and manage monitors
Code Examples — ready-to-use snippets in PHP, Python, and JavaScript