Authentication

All authenticated API requests use Bearer Token authentication.

Getting Your Token

1. Log in to the Merchant Dashboard
2. Navigate to Settings → Tokens → Public Token
3. Copy your publicToken

Using the Token

Include the token in the Authorization header of every API request: Authorization: Bearer YOUR_PUBLIC_TOKEN

Authentication Requirements

Most endpoints require authentication. Each endpoint page indicates whether authentication is Required, Optional, or Not Required at the top of the page next to the method and path.

Content Type Convention

All API requests use application/json as the content type. This applies to every endpoint and is not repeated on each endpoint page.

tip

Keep your public token secure. Do not expose it in client-side code or public repositories.

EXAMPLE REQUEST

curl -X POST https://my.paidlys.com/api/invoices/v1/unlimited \
  -H "Authorization: Bearer YOUR_PUBLIC_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"name": "Product"}]}'