# Ibox — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse Apple products available at iBox Indonesia with detailed information on variants, pricing, stock availability, and current promotions. Check installment payment options and explore the complete product catalog organized by categories.

**Category:** E-commerce | **Website:** [ibox.co.id/](https://ibox.co.id/) | **Docs:** [parse.bot/marketplace/4649890c-1d03-47b3-afbe-fb8914b27480/ibox-co-id-api](https://parse.bot/marketplace/4649890c-1d03-47b3-afbe-fb8914b27480/ibox-co-id-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/ibox/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get category catalog

Browse products within a specific category by numeric category ID. Returns paginated product listings and category metadata (name, url_key). Category IDs are obtained from list_categories. Pagination advances via page counter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Numeric category ID (e.g., '810' for iPhone, '757' for Mac, '770' for iPad). Obtain IDs from the list_categories endpoint. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/get-category-catalog \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","limit":"<integer>","page":"<integer>"}'
```

### Get installment options

Get available installment and financing categories offered by iBox. Returns credit card installment, non-credit installment, and paylater options with their descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/get-installment-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get product detail

Fetch comprehensive detail for a single product by its URL slug (url_key from search or category results). Returns full specs, media galleries, filterable attributes, variant information, and HTML description. A separate internal call fetches the description body and merges it into the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id_or_slug` | string | Yes | Product URL slug (url_key from search_products or get_category_catalog results, e.g., 'apple-iphone-16-128gb-ultramarine'). Numeric IDs are not supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/get-product-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product_id_or_slug":"<string>"}'
```

### Get promotions

Get current promotional banners displayed on the iBox homepage slider. Returns active promotions with titles, image URLs, link targets, and validity periods. Only the 'main' section is supported.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `section` | string | No | Banner section. Only 'main' is supported. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/get-promotions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"section":"<string>"}'
```

### List categories

List all top-level product categories and their subcategory hierarchies. Returns a tree where each category has children_data containing subcategories (or null for leaf nodes). Use category IDs from this response to call get_category_catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/list-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search products

Full-text search over iBox product catalog by keyword. Returns paginated results with product summaries including pricing, stock, thumbnails, and URL slugs for detail lookups. Sorting controls result ordering; pagination advances via the page counter. Each item carries a url_key suitable for get_product_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g., 'iphone 16', 'macbook air', 'airpods'). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/ibox/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.