# Nexxt Change — 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 browse company sales listings, buyer requests, and regional business partners on Germany's leading business succession marketplace. Access detailed information about available businesses for sale, acquisition opportunities, and local expertise to support your business succession needs.

**Category:** Marketplaces | **Website:** [nexxt-change.org/](https://nexxt-change.org/) | **Docs:** [parse.bot/marketplace/eafb9852-3c34-4826-b3c9-7ad177eb64f2/nexxt-change-org-api](https://parse.bot/marketplace/eafb9852-3c34-4826-b3c9-7ad177eb64f2/nexxt-change-org-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/nexxt-change/`
**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 buy request detail

Retrieve the full detail page for a buy request by its ID. Returns title and structured metadata including investor type, target location, sector, and budget.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ad_id` | string | Yes | Buy request ID from search_buy_requests results. |

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

### Get regional partner detail

Retrieve the full profile of a regional partner including organizational description, contact information (address, phone, email, website), and any structured metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `rp_id` | string | Yes | Regional partner ID from search_regional_partners results. |

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

### Get sale listing detail

Retrieve the full detail page for a company sale listing by its ID. Returns the listing title, full description text, and structured metadata fields including location, sector, employees, revenue, and asking price.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ad_id` | string | Yes | Sale listing ID from search_sale_listings results. |

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

### Get sector options

Get the hierarchical list of sectors (Branchen) available for filtering sale listing searches. Each option has a human-readable label and a bracket-encoded value string that can be passed as the sector parameter to search_sale_listings. The list is static and reflects the site's NACE-based classification tree.

**Estimated cost:** Metered

_No parameters required._

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

### Search buy requests

Search for buyer/investor requests (Kaufgesuche). Returns listings of investors seeking to acquire companies. Each result includes an id usable with get_buy_request_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bundesland` | string | No | Region/state filter value (bracket-encoded, e.g. '[2]'). |
| `query` | string | No | Free-text search keyword. |

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

### Search regional partners

Search for regional partner organizations (IHKs, chambers of commerce, Handwerkskammern) that support business succession processes. Each result includes an id usable with get_regional_partner_detail.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bundesland` | string | No | Region/state filter value (bracket-encoded, e.g. '[2]'). |
| `query` | string | No | Search keyword (city or partner name). |

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

### Search sale listings

Search for company sale listings (Verkaufsangebote) with optional keyword, sector, and region filters. Returns paginated results ordered by date descending. Filters combine with AND logic. Each result includes an id usable with get_sale_listing_detail for the full description and structured metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bundesland` | string | No | Region/state filter value (bracket-encoded, e.g. '[2]' for Bayern). |
| `page` | integer | No | Page number for pagination (1-based). |
| `query` | string | No | Free-text search keyword matched against listing title and description. |
| `sector` | string | No | Sector filter value from get_sector_options (bracket-encoded, e.g. '[1]', '[4,24]'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/nexxt-change/search-sale-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"bundesland":"<string>","page":"<integer>","query":"<string>","sector":"<string>"}'
```

## Next steps

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