Skip to content
AccBoothAccBooth

// open_api

Open API reference

Buy accounts, read OTP mail, renew Graph tokens, and automate wallet checkout.

8 endpoints · reference & live tests

Walkthrough: Using the Open API on AccBooth

Authentication

Pass your API key in the X-API-Key header (or Authorization: Bearer). Do not put keys in query strings. Create keys in Account → API keys. Copy productId from any product card when calling buy or stock.

Success envelope

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": "…",
  "requestId": "a1b2c3d4"
}

Base URL: https://api.accbooth.com. Schema: https://api.accbooth.com/docs

Error codes

401Invalid or missing API key (X-API-Key / Bearer)
402Insufficient wallet balance, or renew to send / renew to refresh the token
404Product, order, or inbox not found
409None of the requested accounts were ready. Nothing is charged.
502Microsoft could not read or send for that inbox
01POST

Buy accounts

/open/buy

Buy accounts from wallet balance (any active floor product: hotmail, outlook, gmail, yahoo, gmx, aol, social, AI, games, …). Use POST (JSON body) only — GET /open/buy was removed so clientKey never lands in URLs or proxy logs. Sells however many are ready, up to quantity; 0 ready returns 409 and refunds. Premium is required for Microsoft Graph mail send after purchase.

Request URL

https://api.accbooth.com/open/buy?productId=%7BproductId%7D&quantity=1

Request parameters

NameTypeRequiredDescription
clientKeystringYesYour API key via X-API-Key or Authorization: Bearer (preferred). Body clientKey is a deprecated fallback.
productIdstringYesProduct id or slug (e.g. hotmail, outlook, gmail, yahoo, gmx, aol, chatgpt).
quantityintegerYesHow many to buy (≥ 1). You are charged only for the accounts that were ready.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "accounts": [
      "[email protected]:password:recovery:token…"
    ],
    "quantity": 2,
    "requestedQuantity": 5,
    "unspent": 0.06,
    "totalAmount": 0.04,
    "balance": 13.95
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer)) · 402 (Insufficient wallet balance, or renew to send / renew to refresh the token) · 404 (Product, order, or inbox not found) · 409 (None of the requested accounts were ready. Nothing is charged.)

POST/open/buy
curl -X POST 'https://api.accbooth.com/open/buy' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{
  "productId": "",
  "quantity": "1"
}'

Test interface

Run this endpoint against the live API.

02GET

Read OTP

/open/mail/latest

Read the latest verification code for a mailbox this key owns. Works for full bought Hotmail/Outlook, premium inboxes, and Email OTP leases. For OTP leases, only the purchased service’s code is returned (e.g. Facebook lease never returns Apple). Pass the email, or the account line from buy. Anyone else’s address is 404. Full Hotmail/Outlook accounts try Microsoft Graph first; when Graph fails and protocol (IMAP) tokens exist, AccBooth falls back to the Securer mailbox API. Full-account Graph refresh still follows Premium rules; OTP leases are read by the platform for that service only.

Request URL

https://api.accbooth.com/open/mail/latest?account=%7Baccount%7D

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.
accountstringYesEmail address, or the colon-joined account line from buy.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "address": "[email protected]",
    "code": "482901",
    "receivedAt": "2026-03-18T12:00:00Z",
    "subject": "Your verification code",
    "mailProvider": "graph"
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer)) · 402 (Insufficient wallet balance, or renew to send / renew to refresh the token) · 404 (Product, order, or inbox not found) · 502 (Microsoft could not read or send for that inbox)

GET/open/mail/latest
curl 'https://api.accbooth.com/open/mail/latest?account=%7Baccount%7D' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

03POST

Send mail

/open/mail/send

Send from a bought Hotmail or Outlook account. Requires an active Premium subscription on the shop account that owns this API key. Auth via X-API-Key header; JSON body: account (email), to, subject, text. A lapsed plan returns “Renew to send.” Tries Microsoft Graph first; on Graph failure AccBooth calls the Securer mailbox send API (SMTP protocol tokens when present). Response may include mailProvider (graph | smtp | ops_mailbox). See docs/MS_PROTOCOL_TOKENS.md.

Request URL

https://api.accbooth.com/open/mail/send?account=%7Baccount%7D&to=%7Bto%7D&text=%7Btext%7D

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.
accountstringYesEmail of the bought account.
tostringYesRecipient email. Separate several with commas.
subjectstringNoSubject line.
textstringYesPlain-text body.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "ok": true,
    "from": "[email protected]",
    "to": [
      "[email protected]"
    ],
    "mailProvider": "smtp"
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer)) · 402 (Insufficient wallet balance, or renew to send / renew to refresh the token) · 404 (Product, order, or inbox not found) · 502 (Microsoft could not read or send for that inbox)

POST/open/mail/send
curl -X POST 'https://api.accbooth.com/open/mail/send' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{
  "account": "",
  "to": "",
  "subject": "",
  "text": ""
}'

Test interface

Run this endpoint against the live API.

04GET

Query balance

/open/balance

Return wallet balance, VIP level, discount rate, and 7-day deposit volume for the authenticated customer.

Request URL

https://api.accbooth.com/open/balance

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "email": "[email protected]",
    "balance": 42.5,
    "vipLevel": 1,
    "vipName": "VIP 1",
    "discountRate": 5,
    "totalDeposit": 210
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer))

GET/open/balance
curl 'https://api.accbooth.com/open/balance' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

05GET

Product stock

/open/stock

List live stock and list prices for active floor products (mail, social, AI, games). Optionally filter by productId (Mongo id or slug). Optional auth via X-API-Key / Bearer; if provided it must be valid.

Request URL

https://api.accbooth.com/open/stock

Request parameters

NameTypeRequiredDescription
productIdstringNoFilter to one product. Copy the short numeric ID from the product card (e.g. 3), or use the product slug.
clientKeystringNoOptional. When set, send via X-API-Key / Bearer (not query string).

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": [
    {
      "productId": 3,
      "name": "Hotmail Trusted Graph",
      "mailType": "hotmail",
      "stock": 12840,
      "price": 0.35
    }
  ],
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer))

GET/open/stock
curl 'https://api.accbooth.com/open/stock' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

06GET

Renew Outlook token

/open/token/renew

Refresh Microsoft tokens for a Hotmail/Outlook mailbox this key bought (Securer Ops remint: Graph, and when enabled IMAP/SMTP protocol grants). AccBooth persists imap_token_status / smtp_token_status server-side; buyers never receive IMAP/SMTP refresh tokens. Any other address returns Account not found. A lapsed key gets “Renew to send.” Nothing is charged while Premium is active. See docs/MS_PROTOCOL_TOKENS.md.

Request URL

https://api.accbooth.com/open/token/renew?account=%7Baccount%7D

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.
accountstringYesColon-joined account line from a mailbox you bought.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "account": "[email protected]:pass:NEW_REFRESH:clientId",
    "email": "[email protected]",
    "expires_in": 3600,
    "renewed_at": "2026-03-18T12:00:00+00:00",
    "charged": "0",
    "method": "subscription",
    "balance_after": "42.5",
    "free": true
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer)) · 402 (Insufficient wallet balance, or renew to send / renew to refresh the token) · 400 · 404 (Product, order, or inbox not found) · 429

GET/open/token/renew
curl 'https://api.accbooth.com/open/token/renew?account=%7Baccount%7D' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

07GET

Orders

/open/orders

Paginated order history for the API key owner. Status filter uses hotmail007-style ints: 0 pending, 1 paid, 2 delivered, 4 failed, 5 refunded.

Request URL

https://api.accbooth.com/open/orders?pageNum=1&pageSize=10

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.
pageNumintegerNoPage number (1-based).
pageSizeintegerNoPage size (1–100).
statusintegerNoOptional status filter: 0, 1, 2, 4, or 5.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": [
    {
      "orderNo": "HMS-A1B2C3D4",
      "productId": 0,
      "productName": "Hotmail Trusted Graph",
      "quantity": 2,
      "unitPrice": 0.35,
      "totalAmount": 0.7,
      "status": 2,
      "createTime": "2026-03-18 12:00:00"
    }
  ],
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer))

GET/open/orders
curl 'https://api.accbooth.com/open/orders?pageNum=1&pageSize=10' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

08GET

Order detail

/open/order/detail

Fetch a single order by orderNo. Credentials are only returned from /open/buy — detail does not re-emit account lines.

Request URL

https://api.accbooth.com/open/order/detail?orderNo=%7BorderNo%7D

Request parameters

NameTypeRequiredDescription
clientKeystringYesSend as X-API-Key or Authorization: Bearer header. Do not put keys in query strings.
orderNostringYesOrder number, e.g. HMS-A1B2C3D4.

Sample response

{
  "code": 0,
  "success": true,
  "message": "success",
  "data": {
    "orderNo": "HMS-A1B2C3D4",
    "productId": 0,
    "productName": "Hotmail Trusted Graph",
    "quantity": 2,
    "unitPrice": 0.35,
    "totalAmount": 0.7,
    "status": 2,
    "createTime": "2026-03-18 12:00:00"
  },
  "requestId": "a1b2c3d4"
}

Common failures: 401 (Invalid or missing API key (X-API-Key / Bearer)) · 404 (Product, order, or inbox not found)

GET/open/order/detail
curl 'https://api.accbooth.com/open/order/detail?orderNo=%7BorderNo%7D' \
  -H 'X-API-Key: YOUR_API_KEY'

Test interface

Run this endpoint against the live API.

Search

Search listings, pages and actions