# Starken — 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.

> Get Starken Chile shipping reference data including Tarifa Simple rate tables, available shipping localities, branch/PUDO locations with hours and capabilities, and a UUID to start a new quote session.

**Category:** E-commerce | **Website:** [starken.cl/](https://starken.cl/) | **Docs:** [parse.bot/marketplace/4c0dbcdb-a668-464f-8586-a59d5035ad55/starken-cl-api](https://parse.bot/marketplace/4c0dbcdb-a668-464f-8586-a59d5035ad55/starken-cl-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-starken-cl-api-4c0dbcdb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_branches

Get all Starken branch locations with addresses, operating hours, pickup/dropoff capabilities, and dimension limits. Returns a flattened list of all branches across all regions in Chile. No parameters required — returns the complete branch catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-starken-cl-api-4c0dbcdb/get_branches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_locations

Get all available localities for shipping in Chile with service level information. Returns over 2000 locations grouped by region, including agency codes, delivery types, payment methods, and service tier levels (mini/big/giga). No parameters required — returns the complete locality catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-starken-cl-api-4c0dbcdb/get_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_quote_uuid

Generate a UUID for starting a new shipping quote session. Returns a unique identifier that can be used to track quote requests. Each call returns a fresh UUID; no parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-starken-cl-api-4c0dbcdb/get_quote_uuid \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_simple_rates

Get simple flat shipping rates (Tarifa Simple) for all combinations of delivery type, zone tier, destination area, and package size. Returns pricing in Chilean pesos. Two delivery types (sucursal for branch pickup, domicilio for home delivery), four zone tiers (persona/colina/montana/cordillera reflecting volume discounts), four destination areas (misma_ciudad/norte/centro_sur/austral), and four package sizes (xs/s/m/l). No parameters required — returns the full rate matrix in one call.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-starken-cl-api-4c0dbcdb/get_simple_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
