Server-side automation for one Phylex account. Internal numeric IDs are never accepted; list and detail operations use stable public references.
Base URL: https://billing.phylex.net/api/proxy/account-api/v1
| Method | Path | Required scope | Description |
|---|---|---|---|
| GET | /me | account:read | Account identity, locale, country, and account currency. |
| GET | /balance | balance:read | Current balance in the account currency with server time. |
| GET | /invoices | finance:read | Bounded invoice history with ownership-checked public references. |
| GET | /orders | finance:read | Canonical service orders and linked public references. |
| POST | /orders | orders:write | Atomically buy one Atlas service from the authoritative account balance. |
| GET | /transactions | finance:read | Bounded account ledger with redacted descriptions. |
| GET | /services | services:read | Bounded owned service inventory with type and status filters. |
| GET | /services/stats | services:read | Counts across every owned service type and lifecycle status. |
| GET | /services/{service_ref} | services:read | One owned service; missing and cross-account references both return 404. |
| PUT | /services/{service_ref}/auto-renew | services:write | Idempotently set automatic renewal after lifecycle revalidation. |
| POST | /services/{service_ref}/power | services:power | Start, stop, or reboot supported KVM with an Idempotency-Key. |
| GET | /services/{service_ref}/shield | shield:read | Advanced-only Shield entitlement, safe presets, and owned rules for one direct KVM service. |
| GET | /services/{service_ref}/shield/capabilities | shield:read | Current Advanced limits and versioned safe preset descriptors. |
| GET | /services/{service_ref}/shield/rules | shield:read | Sanitized Atlas rule state without provider identifiers. |
| POST | /services/{service_ref}/shield/rules | shield:write | Queue a validated custom rule with an Idempotency-Key; Atlas selects the owned destination IP. |
| DELETE | /services/{service_ref}/shield/rules/{rule_id} | shield:write | Queue rollback of a rule or its complete profile bundle. |
| POST | /services/{service_ref}/shield/presets/{preset_code} | shield:write | Queue a versioned safe preset with durable idempotency. |
| POST | /services/{service_ref}/shield/profiles/{profile_code} | shield:write | Atomically apply off, low, default, or strict protection profiles. |
| GET | /services/{service_ref}/shield/traffic | shield:read | Bounded 30-day traffic aggregates with server-side ownership checks. |
| GET | /services/{service_ref}/shield/protection-activity | shield:read | Normalized protection verdict aggregates; not attack classification. |
| GET | /services/{service_ref}/shield/rules/{rule_id}/evidence | shield:read | Bounded extended metadata for one owned rule; never packet payloads. |
| GET | /plans | catalog:read | Saleable catalog with account-currency prices, optional display conversion, and purchase URLs. |
'%3e%3cpath fill='%23012169' d='M0 0v30h60V0z'/%3e%3cpath stroke='%23fff' stroke-width='6' d='m0 0 60 30m0-30L0 30'/%3e%3cpath stroke='%23C8102E' stroke-width='4' d='m0 0 60 30m0-30L0 30' clip-path='url(%23b)'/%3e%3cpath stroke='%23fff' stroke-width='10' d='M30 0v30M0 15h60'/%3e%3cpath stroke='%23C8102E' stroke-width='6' d='M30 0v30M0 15h60'/%3e%3c/g%3e%3c/svg%3e)
'/%3e%3cuse xlink:href='%23a' transform='scale(-1 1)'/%3e%3c/g%3e%3cg id='c'%3e%3cuse xlink:href='%23b' transform='rotate(72)'/%3e%3cuse xlink:href='%23b' transform='rotate(144)'/%3e%3c/g%3e%3cuse xlink:href='%23c' transform='scale(-1 1)'/%3e%3c/g%3e%3c/defs%3e%3cpath fill='%23039' d='M0 0h810v540H0z'/%3e%3cg fill='%23fc0' transform='matrix(30 0 0 30 405 270)'%3e%3cuse xlink:href='%23d' y='-6'/%3e%3cuse xlink:href='%23d' y='6'/%3e%3cg id='e'%3e%3cuse xlink:href='%23d' x='-6'/%3e%3cuse xlink:href='%23d' transform='rotate(-144 -2.344 -2.11)'/%3e%3cuse xlink:href='%23d' transform='rotate(144 -2.11 -2.344)'/%3e%3cuse xlink:href='%23d' transform='rotate(72 -4.663 -2.076)'/%3e%3cuse xlink:href='%23d' transform='rotate(72 -5.076 .534)'/%3e%3c/g%3e%3cuse xlink:href='%23e' transform='scale(-1 1)'/%3e%3c/g%3e%3c/svg%3e)
curl --request POST https://billing.phylex.net/api/proxy/account-api/v1/orders --header 'Authorization: Bearer phxak_REPLACE_WITH_YOUR_KEY' --header 'Idempotency-Key: purchase-0191b9d0-example' --header 'Content-Type: application/json' --data '{"type":"kvm","plan_code":"epc_1","os_name":"Alma Linux 8","period_ref":"PHX-PERIOD-00000001","region_ref":"PHX-REGION-00000001"}'curl --request POST https://billing.phylex.net/api/proxy/account-api/v1/services/PHX-SVC-0000002A/power --header 'Authorization: Bearer phxak_REPLACE_WITH_YOUR_KEY' --header 'Idempotency-Key: 0191b9d0-example' --header 'Content-Type: application/json' --data '{"action":"reboot"}'