# Sham VPN Proxy API

> Sham VPN Proxy API is an HTTPS proxy gateway with Syrian exit IP addresses for developers, automation and testing. Connect to vpn.syrabit.sy on TLS port 2053 with Basic auth: username pk_xxxxxxxx plus optional options (region, sid, ttl), password is the secret key. Price: 4 USD per 1 GB, valid 30 days. Arabic-language product.

Key facts:
- Proxy type: HTTPS proxy (use the https:// scheme). Host vpn.syrabit.sy, TLS port 2053.
- Username format: pk_xxxxxxxx[-region-<damascus|rif-dimashq|homs|latakia|tartus|random>][-sid-<1-16 alphanumerics>][-ttl-<1-240>m]
- Sticky session: add sid (name you choose) and ttl (minutes, 1 to 240, default 10) to keep the same exit IP.
- Allowed destination ports: 80, 443, 8000, 8008, 8080, 8081, 8443, 8888. Private and local addresses are refused.
- Errors are returned as HTTP status plus the X-Sham-Error header (AUTH_REQUIRED, BAD_CREDENTIALS, PRO_REQUIRED, QUOTA_EXHAUSTED, PORT_NOT_ALLOWED, PRIVATE_ADDRESS, RATE_LIMITED, UPSTREAM_ERROR ...).
- Usage REST API: GET https://vpn.syrabit.sy/v1/usage with Authorization: Bearer <secret key>.
- Requires an active Sham VPN subscription. Data, balance and keys are shared with the Sham VPN Android app (same Google account).
- Independent service, not affiliated with Sham Cash or any payment provider.

## Pages

- [Dashboard and sign-in](https://proxy.syrabit.sy/): keys, usage, purchases, connection builder.
- [Full documentation (PDF, Arabic)](https://proxy.syrabit.sy/Sham-VPN-Proxy-API-Docs.pdf)
- [Sham VPN app and download](https://vpn.syrabit.sy/)