Authentication

All API requests require authentication via API key and store ID headers.

Getting an API Key

API keys are managed in your Printago dashboard under Settings → Integrations → API Keys, or directly at app.printago.io/api.

When you create a new API key, it will only be shown once. Store it securely as it grants full access to your account data and printers.

Required Headers

authorization

Your API key, prefixed with ApiKey

x-printago-storeid

Your store ID (found in your dashboard URL or settings)

Example Request

HTTP Headers

authorization: ApiKey pk_live_abc123...
x-printago-storeid: store_xyz789...

Error Responses

401 Unauthorized

Missing or invalid API key; Store ID mismatch

429 Too Many Requests

Rate limit exceeded, wait for the time window to reset

Rate Limits

API access is rate-limited across two buckets:

Per Minute

60 requests

Rolling 1-minute window

Per Hour

600 requests

Rolling 1-hour window

If you exceed these limits, requests will fail with HTTP 429 until the time window resets. If the rate limits are too restrictive for your use case, please contact us to discuss.