Introduction

The SamaPrime API lets you read a user's wallet and place orders — SMS numbers, SMM services, card lookups — over plain HTTPS, using the exact same pricing and business logic the SamaPrime app itself uses.

Every response is JSON, wrapped in a consistent envelope: a successful call returns { "data": ..., "meta": { "request_id", "timestamp" } }, an error returns { "error": { "type", "message", "code", "request_id" } }.

This reference is grouped by resource — Wallet, SMS, SMM, Cards, Webhooks — plus a shared Overview section covering authentication, errors, rate limits, idempotency, and pagination, all of which apply across every endpoint.

Endpoints are rolling out gradually. Each endpoint page states its required scope so you can request only the access your integration needs.