# Rtr Pbs — 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.

> Check real-time road conditions across Taiwan's highways and regions to plan safer routes and avoid traffic disruptions. Get live updates on accidents, congestion, and hazardous conditions reported by the Police Broadcasting Service.

**Category:** Maps & Geospatial | **Website:** [rtr.pbs.gov.tw/](https://rtr.pbs.gov.tw/) | **Docs:** [parse.bot/marketplace/9b9cf401-3557-4c48-8b58-ef0373088edd/rtr-pbs-gov-tw-api](https://parse.bot/marketplace/9b9cf401-3557-4c48-8b58-ef0373088edd/rtr-pbs-gov-tw-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/rtr-pbs/`
**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 road conditions

Fetches all real-time road conditions from the Police Broadcasting Service. Returns records ordered by most recent update time. The limit parameter caps total items returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/rtr-pbs/get-road-conditions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### Get road conditions by highway

Fetches road conditions filtered by a specific highway name via keyword search. Returns records whose location or info fields match the highway name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `highway` | string | Yes | Highway name to search for (e.g. 國道1號, 國道3號). |
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/rtr-pbs/get-road-conditions-by-highway \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"highway":"<string>","limit":"<integer>"}'
```

### Get road conditions by region

Fetches road conditions filtered by region. Returns records for the specified area of Taiwan. Supports both Chinese region names and single-letter codes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `region` | string | Yes | Region name or code. Accepted values: 北部, 中部, 南部, 東部, 國道, 全區, N, M, S, E, F. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/rtr-pbs/get-road-conditions-by-region \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","region":"<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.