> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.lumiweb.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# API — Domains

> Domains bot REST API: account, domain check and registration, prices, orders, deposits

Base URL: `https://scamprojecttest.xyz/api/v1`. Shared rules (auth, limits, errors, idempotency) are in the [overview](/en/api).

## Account

| Method | Path                       | Scope          | Description                           |
| ------ | -------------------------- | -------------- | ------------------------------------- |
| GET    | `/users/me`                | `domains:read` | Key & user profile                    |
| GET    | `/users/{user_id}/balance` | `domains:read` | Balance                               |
| GET    | `/transactions`            | `domains:read` | Transactions (paginated, `?user_id=`) |
| GET    | `/referrals`               | `domains:read` | Referral stats                        |

```bash theme={"system"}
curl https://scamprojecttest.xyz/api/v1/users/me -H "Authorization: Bearer $KEY"
```

```json theme={"system"}
{
  "principal": { "key_id": 3, "name": "reseller acme", "role": "reseller", "scopes": ["domains:read","domains:buy"], "user_id": 42 },
  "user": { "id": 42, "telegram_id": 666971555, "balance_usd": "12.50", "is_banned": false }
}
```

## Domains

### List domains

`GET /domains` · scope `domains:read` · paginated · `?user_id=` (operator)

### Domain card

`GET /domains/{domain_id}` · scope `domains:read`. A reseller only sees its own; a foreign id → `404`.

### Availability check

`GET /domains/check?names=a.com,b.net` · scope `domains:read` · up to 50 names

```json theme={"system"}
{ "results": [ { "domain": "a.com", "available": false, "price_usd": "17.00", "error": null } ] }
```

### TLD price

`GET /domains/price?tld=com` · scope `domains:read`

```json theme={"system"}
{ "tld": "com", "price_usd": "17.00", "supported": true }
```

### Bulk check

`POST /domains/check:bulk` · scope `domains:read` · body `{ "names": ["a.com","b.net"] }` → bulk envelope.

## Buying (money)

<Warning>
  Money endpoints require `API_MONEY_ENABLED`, scope `domains:buy`, an `Idempotency-Key` header, and (if enabled) an `X-Signature`.
</Warning>

### Bulk registration

`POST /domains/register:bulk` · scope `domains:buy` · **money** · async → `202`

```bash theme={"system"}
curl -X POST "https://scamprojecttest.xyz/api/v1/domains/register:bulk" \
  -H "Authorization: Bearer $KEY" \
  -H "Idempotency-Key: reg-2026-06-09-001" \
  -H "Content-Type: application/json" \
  -d '{"names":["example-store-1.com","example-store-2.net"]}'
```

```json theme={"system"}
{ "batch_id": "checkout:1234", "accepted": 2, "status": "pending" }
```

Operator must name the buyer: `?user_id=42`. Registration runs in the background; poll `GET /batches/checkout:1234`. Invalid rows → `422` with per-row detail; nothing is charged. Premium (registry-priced) names are unavailable and never enter registration.

### Order status

`POST /orders/status:bulk` · scope `domains:read` · body `{ "ids": [101,102] }`.

### Batch status

`GET /batches/{batch_id}` · scope `domains:read`.

## Deposits (money)

### Create invoice

`POST /deposits` · scope `deposits:write` · **money** → `201`

| Field        | Type              | Description                                             |
| ------------ | ----------------- | ------------------------------------------------------- |
| `amount_usd` | string/number > 0 | Amount to credit (1–1000)                               |
| `provider`   | string            | `cryptobot` · `xrocket` · `lava` · `p2328` · `lolzteam` |
| `asset`      | string            | (optional) coin for CryptoBot                           |
| `user_id`    | number            | Required for an operator key                            |

```json theme={"system"}
{ "provider":"cryptobot","external_id":"inv_123","pay_url":"https://...","amount_usd":"5","pay_usd":"5.15" }
```

The balance is credited after payment — via the provider's signed webhook, not this request.

### Invoice status

`GET /deposits/{provider}/{external_id}` · scope `domains:read`.

## Operator endpoints

Operator key only (scope `admin:*`). Money ones require `Idempotency-Key`.

| Method | Path                                              | Description                                  |
| ------ | ------------------------------------------------- | -------------------------------------------- |
| POST   | `/admin/users/{user_id}/balance`                  | Adjust balance `{delta_usd, reason}` (money) |
| POST   | `/admin/users/{user_id}/ban`                      | Ban/unban `{banned, reason}`                 |
| POST   | `/admin/deposits/{transaction_id}/mark-completed` | Manually complete a deposit (money)          |
| POST   | `/admin/deposits/{transaction_id}/mark-failed`    | Mark a deposit failed                        |