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

> Search and retrieve detailed information about Swiss patents, including their full specifications, publication history, and related targets directly from the official Swiss patent registry. Access comprehensive patent data through simple lookups or broad searches to track innovations and filing details in Switzerland.

**Category:** Government & Public Data | **Website:** [swissreg.ch/](https://swissreg.ch/) | **Docs:** [parse.bot/marketplace/6284d740-df19-4588-9e2c-fa600c66f1c2/swissreg-ch-api](https://parse.bot/marketplace/6284d740-df19-4588-9e2c-fa600c66f1c2/swissreg-ch-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/swissreg/`
**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 patent detail

Retrieve full detail for a single patent record by its internal numeric ID. Returns title, numbers, dates, status, holder, inventor, IPC/CPC classifications, publication references, and priority data. The ID is the internal Swissreg numeric identifier visible in patent URNs. Returns input_not_found if the patent ID does not exist.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `patent_id` | string | Yes | Internal numeric ID of the patent (e.g., 1207223855, 31221348). |

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

### Get publication detail

Retrieve detail for a publication record (part of patent history). Returns publication text in multiple languages, the change reason, publication date, and the associated parent patent reference. Publication IDs can be found in the publikationRefs array of a patent detail response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `publication_id` | string | Yes | Internal numeric ID of the publication (e.g., 7377553, 10239520). Found in patent detail publikationRefs URNs. |

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

### Get targets

Get the list of available database targets supported by the Swissreg registry (e.g., patent, design, chmarke, esz). Each target object contains a name field. Useful for understanding what record types are available in the system.

**Estimated cost:** Metered

_No parameters required._

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

### Search patents

Search for patents. NOTE: Currently blocked by site's F5 BIG-IP protection for POST requests. Returns 403.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search keyword. |

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