# Shop Boeing — 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.

> Browse and search Boeing's online parts catalog. Retrieve product details, technical specifications, shipping attributes (hazmat, ITAR, ECCN), categories, brands, and suppliers for parts available on shop.boeing.com.

**Category:** E-commerce | **Website:** [shop.boeing.com/](https://shop.boeing.com/) | **Docs:** [parse.bot/marketplace/e363f8b5-4d3d-4f72-93bb-6eb6e11af02e/shop-boeing-com-api](https://parse.bot/marketplace/e363f8b5-4d3d-4f72-93bb-6eb6e11af02e/shop-boeing-com-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/shop-boeing/`
**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

Get category details including subcategories and total product count. Returns the category name, slug, subcategory list, and total number of products within the category hierarchy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category slug identifying the top-level category |

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

### Get homepage

Retrieve the Shop Boeing homepage content including top-level navigation categories. Returns the same data as list_product_categories.

**Estimated cost:** Metered

_No parameters required._

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

### Get overstock parts

Return parts tagged as overstock (excess inventory) including products, pagination info, and facets for filtering. Overstock parts are available at reduced lead times.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shop-boeing/get-overstock-parts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get part details

Retrieve full product details for a part identifier. Returns comprehensive metadata including classifications, breadcrumbs, stock information, certifications, and shipping flags. The part_id format is SUPPLIER_PARTNUMBER where supplier prefix is one of BDI, BDSIS4, or BPP. Discoverable via search_parts results code field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1', 'BDI_AN6237-1=20'). Discoverable via search_parts results code field. |

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

### Get part shipping details

Extract shipping and export control details for a part including hazmat classification, ITAR control status, ECCN (Export Control Classification Number), and dry ice shipping requirements. A focused subset of the full product details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1'). Discoverable via search_parts results code field. |

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

### Get part technical info

Extract technical information for a part including lead time in days, ATA chapter and number, manufacturer certification status, and aircraft compatibility (makes and models). A focused subset of the full product details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `part_id` | string | Yes | Part identifier in format SUPPLIER_PARTNUMBER (e.g. 'BDSIS4_3039524-1'). Discoverable via search_parts results code field. |

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

### Get search autocomplete

Retrieve search autocomplete suggestions for a partial term. Returns up to 6 suggestion objects, each with a value field containing the suggested search term.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Partial search term to autocomplete (e.g. 'bolt', 'hydraulic', 'seal') |

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

### Get subcategory

Get subcategory details given parent category and subcategory slugs. Returns the subcategory name, parent reference, total product count, and any sub-subcategories available for further drill-down.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Parent category slug (e.g. 'airframe-parts') |
| `subcategory_id` | string | Yes | Subcategory slug within the parent category (e.g. 'filters', 'aircraft-doors', 'aviation-fuel-systems') |

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

### List brands

List all available brands in the Boeing parts catalog. Each brand includes a display name, product count, and query string for filtering search results by that brand.

**Estimated cost:** Metered

_No parameters required._

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

### List product categories

Return all top-level product categories available in the Boeing parts catalog. Each category includes a display name, product count, and query string usable for filtering.

**Estimated cost:** Metered

_No parameters required._

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

### List suppliers

List all available suppliers in the Boeing parts catalog. Returns supplier names with product counts and query strings for filtering. The three main suppliers are Boeing Distribution (formerly Aviall), Commercial Spares, and Boeing Distribution Services.

**Estimated cost:** Metered

_No parameters required._

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

### Search parts

Search the Boeing parts catalog by keyword. Returns matching products with full metadata, pagination info, and facets for filtering. Some broad queries may time out upstream; use specific terms when possible. Each product includes code (the part identifier), name, description, stock info, and category assignments.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (0-indexed) |
| `page_size` | integer | No | Results per page |
| `query` | string | Yes | Search keyword (e.g. 'filter', 'hydraulic', 'seal') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/shop-boeing/search-parts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","page_size":"<integer>","query":"<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.