API · Reference

Customer API documentation

Integrate Zaga SMS into your own backend, bots, or automation tools.

Base URL https://oglogsms.com/api/v1
Auth Bearer token
Rate limit 60 req / min

Authentication

Send your API key as a Bearer token on every request. Keep it secret and call the API from your own server — never from browser-side JavaScript.

header
Authorization: Bearer <prefix>.<secret>

Rate limits

Each API key may make up to 60 requests per minute. Exceeding this returns a 429 response — back off and retry with the Retry-After header as your guide.

GET /activations

Returns a paginated list of activations tied to your account.

cURL
curl -s "https://oglogsms.com/api/v1/activations" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /activations

Purchases a new virtual number for the given service pricing option.

service_pricing_id integer · required ID of the service/country pricing tier to purchase.
cURL
curl -s -X POST "https://oglogsms.com/api/v1/activations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_pricing_id": 123}'
GET /activations/{'{uuid}'}

Fetches full details for a single activation, including any received messages.

cURL
curl -s "https://oglogsms.com/api/v1/activations/{uuid}" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /activations/{'{uuid}'}/refresh

Polls the provider for the latest status and messages on this activation.

cURL
curl -s -X POST "https://oglogsms.com/api/v1/activations/{uuid}/refresh" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /activations/{'{uuid}'}/complete

Marks an activation as completed once you've received the code you needed.

cURL
curl -s -X POST "https://oglogsms.com/api/v1/activations/{uuid}/complete" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST /activations/{'{uuid}'}/cancel

Cancels an activation. If eligible, the balance is refunded automatically.

cURL
curl -s -X POST "https://oglogsms.com/api/v1/activations/{uuid}/cancel" \
  -H "Authorization: Bearer YOUR_API_KEY"