# Pingy API overview

Source and full request/response reference: https://pingy.io/api

Base URL: https://pingy.io/api/v1

- GET /status/{host}: public last-known status. Does not start a new check. Unknown hosts return known: false.
- POST /checks: start a live check, subject to the shared free-check allowance and rate limits.
- GET /monitors: list the authenticated account's monitors.
- POST /monitors: create a monitor for the authenticated account. Paid plans require active billing or complimentary coverage.
- GET /monitors/{monitor}: retrieve the authenticated account's monitor details.

Account endpoints require an API key sent as Authorization: Bearer YOUR_API_KEY. Create keys in account settings. Read endpoints are limited to 15 requests per minute per key, or per IP without a key. Anonymous live checks share the website's 3-per-24-hours allowance. Never include credentials in public URLs or reports. See the full reference for parameters, responses and errors.