# KFC Australia — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Find KFC Australia locations near you, browse the complete menu, search for specific items, and get detailed information about pricing, nutrition, and allergens for any product. Easily discover what's available at your nearest restaurant and make informed choices about what to order.

**Category:** Food & Dining | **Website:** [kfc.com.au/](https://kfc.com.au/) | **Docs:** [parse.bot/marketplace/d4bef629-5a6b-40d1-9e94-8d2e11a389ac/kfc-com-au-api](https://parse.bot/marketplace/d4bef629-5a6b-40d1-9e94-8d2e11a389ac/kfc-com-au-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/kfc-australia/`
**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 menu

Get the full menu for a specific KFC Australia store including all categories and items with prices and availability. The menu structure is largely shared nationally across stores. Returns deeply nested categories with products and item variants.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_id` | string | No | The store ID from get_stores results (e.g. '866', '802'). |

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

### Get product detail

Get detailed information for a specific menu item including nutritional information, allergens, modifiers, and pricing. Returns the full item catalog entry with all customization options. Accepts item-level IDs (format 'I-XXXXX-X') from the items array within get_menu products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The item ID from get_menu results items array (format 'I-XXXXX-X', e.g. 'I-33580-0', 'I-31963'). |
| `store_id` | string | No | The store ID from get_stores results. |

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

### Get stores

Get nearby KFC stores by location query (suburb, city, or postcode). Returns up to 15 stores sorted by proximity to the geocoded location. Geo-lookup is proximity-based, so postcode inputs may return nearby stores outside that exact postcode.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | No | Suburb, city, or postcode in Australia. |

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

### Search menu

Search for items in a store's menu by keyword. Returns matching products with name, price, category, and image. Results may contain duplicates where the same product appears in multiple categories. Searches product names case-insensitively.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against product names (e.g. 'burger', 'zinger', 'chicken'). |
| `store_id` | string | No | The store ID from get_stores results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kfc-australia/search-menu \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","store_id":"<string>"}'
```

## Next steps

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