Official API v1

Boosting API

List available boosting services, calculate wallet-backed pricing, place orders, and track delivery through this API.

Start integrating Markdown reference
POST https://logsdomain.com/api/v1/boost/orders 
{
  "service_id": "101",
  "link": "https://instagram.com/p/example",
  "quantity": 1000,
  "idempotency_key": "boost-order-20260502-0001"
}

Documentation Hub

API Collections

Official guides for building with your wallet-backed services.
Available Logs API Browse categories, buy logs, and review orders. Available Numbers API Phone number catalog, purchase, and activation workflows. Available Boosting API Social boosting products, checkout, and order tracking.

Base URL

Production Endpoint

All paths in this guide are relative to the current API base URL. Protected endpoints require bearer authentication.

https://logsdomain.com/api/v1

Security

Authentication

Bearer API Key

Generate your API key from API Access. Copy it immediately; it is displayed only once. Generating a new key revokes the previous key.

Required headers 
Accept: application/json
Authorization: Bearer YOUR_API_KEY_HERE
401 Response
{
  "success": false,
  "status": 401,
  "message": "Unauthenticated. Please provide a valid bearer token.",
  "code": "UNAUTHENTICATED"
}
GET

Wallet Balance

/wallet

Returns the authenticated user's wallet balance. Requires bearer authentication.

cURL Request 
curl -X GET "https://logsdomain.com/api/v1/wallet" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200 Response
{
  "success": true,
  "data": {
    "balance": "12500.00",
    "currency": "NGN"
  }
}

Production Flow

Boosting Checkout

Send the service, target link, quantity, and idempotency key. The API calculates the final NGN price, validates wallet balance, creates the order, stores the record, and returns a stable JSON response.

Live catalog Wallet-backed Idempotent checkout Status tracking
GET

List Boost Categories

/boost/categories

Returns unique boost categories. Use these values to filter the services endpoint. Requires bearer authentication.

cURL Request 
curl -X GET "https://logsdomain.com/api/v1/boost/categories" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200 Response
{
  "success": true,
  "data": [
    { "name": "Instagram Followers" },
    { "name": "TikTok Views" }
  ]
}
GET

List Boost Services

/boost/services

Fetches available boost services and returns final wallet prices in NGN. Requires bearer authentication.

Query Type Description
category string Optional. Exact category name from /boost/categories.
cURL Request 
curl -G "https://logsdomain.com/api/v1/boost/services" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  --data-urlencode "category=Instagram Followers"
200 Response
{
  "success": true,
  "data": [
    {
      "service_id": "101",
      "service_name": "Instagram Followers",
      "category": "Instagram Followers",
      "type": "Default",
      "rate_per_1000": "1500.00",
      "currency": "NGN",
      "min": 100,
      "max": 10000,
      "refill": false,
      "cancel": false
    }
  ]
}
GET

Get Service Details

/boost/services/{service_id}

Returns a single service with price, min/max quantity, category, and service type. Use this before checkout to build the correct request body.

cURL Request 
curl -X GET "https://logsdomain.com/api/v1/boost/services/101" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200 Response
{
  "success": true,
  "data": {
    "service_id": "101",
    "service_name": "Instagram Followers",
    "category": "Instagram Followers",
    "type": "Default",
    "rate_per_1000": "1500.00",
    "currency": "NGN",
    "min": 100,
    "max": 10000,
    "refill": false,
    "cancel": true
  }
}
POST

Purchase Boost

/boost/orders

Creates a boost order and deducts the authenticated user's wallet. Requires bearer authentication.

Do not send prices from your integration. The API calculates the charge from the current service rate. Use a unique idempotency_key for every checkout attempt.
Body Type Description
service_id string Required. Service ID from the services endpoint.
link string Required for most service types. Target URL or profile link.
quantity integer Required for quantity-based services. Must be within service min/max.
idempotency_key string Required. Unique key for this checkout attempt.
cURL Request 
curl -X POST "https://logsdomain.com/api/v1/boost/orders" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "101",
    "link": "https://instagram.com/p/example",
    "quantity": 1000,
    "idempotency_key": "boost-order-20260502-0001"
  }'
201 Response
{
  "success": true,
  "data": {
    "order_id": "987654321",
    "status": "pending",
    "service_id": "101",
    "service_name": "Instagram Followers",
    "category": "Instagram Followers",
    "type": "Default",
    "link": "https://instagram.com/p/example",
    "quantity": 1000,
    "price": "1500.00",
    "currency": "NGN",
    "cancel": true,
    "balance_after": "8500.00"
  }
}
GET

List Boost Orders

/boost/orders

Returns boost orders owned by the authenticated account.

cURL Request 
curl -X GET "https://logsdomain.com/api/v1/boost/orders?per_page=25" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
GET

Get Boost Order

/boost/orders/{order_id}

Returns the latest stored boost order status without running a live status refresh.

200 Response
{
  "success": true,
  "data": {
    "order_id": "987654321",
    "status": "processing",
    "service_id": "101",
    "service_name": "Instagram Followers",
    "link": "https://instagram.com/p/example",
    "quantity": 1000,
    "price": "1500.00",
    "currency": "NGN",
    "start_count": 120,
    "remains": 350,
    "refunded": false,
    "cancel": true,
    "created_at": "2026-05-02T12:00:00.000000Z"
  }
}
POST

Check Boost Status

/boost/orders/{order_id}/check

Runs a live status refresh for the boost order and returns the updated local record. If the order is cancelled, the refund-safe processor marks it refunded and credits the user wallet once.

cURL Request 
curl -X POST "https://logsdomain.com/api/v1/boost/orders/987654321/check" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
POST

Cancel Boost Order

/boost/orders/{order_id}/cancel

Submits a cancellation request for an eligible boost order. Refunds are completed only after the order status confirms as cancelled, then the refund-safe processor credits the wallet once.

cURL Request 
curl -X POST "https://logsdomain.com/api/v1/boost/orders/987654321/cancel" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"
200 Response
{
  "success": true,
  "message": "Cancellation request submitted.",
  "data": {
    "order_id": "987654321",
    "status": "canceling",
    "service_id": "101",
    "service_name": "Instagram Followers",
    "link": "https://instagram.com/p/example",
    "quantity": 1000,
    "price": "1500.00",
    "currency": "NGN",
    "start_count": null,
    "remains": null,
    "refunded": false,
    "cancel": false,
    "created_at": "2026-05-02T12:00:00.000000Z"
  }
}

Request Body Rules

Supported Service Types

Cancellation supported

The Boosting API supports the same service types used by the web checkout. Include only the fields required by the selected service type.

Type Required Notes
Defaultlink, quantityOptional runs and interval.
Custom Commentslink, commentsBillable quantity is the number of non-empty comment lines.
Mentions with Hashtagslink, quantity, usernames, hashtagsPass newline-separated usernames and hashtags if needed.
Mentions Custom Listlink, usernamesBillable quantity is the number of non-empty username lines.
Mentions Hashtaglink, quantity, hashtagSend the hashtag value required for the selected service.
Mentions User Followerslink, quantity, usernameTarget a specific username's followers.
Mentions Media Likerslink, quantity, mediaTarget likers of a media item.
PackagelinkCharged as one package at the displayed service rate.
Subscriptionsusername, min, max, delayOptional posts and expiry.
Comment Likeslink, quantity, usernameLikes on comments for a target username.
Polllink, quantity, answer_numberAnswer number must match the selected poll option.
Comment Replieslink, username, commentsBillable quantity is the number of non-empty comment lines.
Invites from Groupsquantity, groupsGroups should match the accepted format for the selected service.

Failure Handling

Error Format

JSON errors
Error Response
{
  "success": false,
  "status": 402,
  "message": "Insufficient wallet balance.",
  "code": "INSUFFICIENT_BALANCE"
}
UNAUTHENTICATEDThe bearer token is missing, invalid, or revoked.
VALIDATION_FAILEDOne or more request fields are missing or invalid.
IDEMPOTENCY_KEY_REUSEDThe key was used for a different request body.
IDEMPOTENCY_KEY_IN_PROGRESSThe same key is still processing. Retry shortly.
BOOST_SERVICE_NOT_FOUNDThe service ID does not exist in the boosting catalog.
BOOST_QUANTITY_REQUIREDThe selected service type requires a billable quantity.
BOOST_QUANTITY_OUT_OF_RANGEThe quantity is outside the service min/max range.
BOOST_LINK_REQUIREDThe selected service type requires a target link.
BOOST_ORDER_NOT_FOUNDThe order ID does not belong to the authenticated account.
BOOST_CANCEL_UNAVAILABLEThe order is not eligible for cancellation.
BOOST_CANCEL_REJECTEDThe order cannot be cancelled at the moment.
INSUFFICIENT_BALANCEThe wallet balance cannot cover the calculated price.