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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-swissreg-ch-api-6284d740/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-swissreg-ch-api-6284d740/get_patent_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-swissreg-ch-api-6284d740/get_publication_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-swissreg-ch-api-6284d740/get_targets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-swissreg-ch-api-6284d740/search_patents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```