# Spheriq — 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 browse Swiss foundations, non-profit organizations, and their projects through an organized database, filtering by category and reading detailed descriptions to find organizations aligned with your interests. Discover charitable entities and their initiatives across Switzerland all in one searchable platform.

**Category:** Business Directories | **Website:** [app.spheriq.ch/suche](https://app.spheriq.ch/suche) | **Docs:** [parse.bot/marketplace/d8cc6103-445c-4123-bbc9-d25bfe2f16f6/app-spheriq-ch-api](https://parse.bot/marketplace/d8cc6103-445c-4123-bbc9-d25bfe2f16f6/app-spheriq-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/spheriq/`
**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 organization

Fetch the full public detail page for a single organization or foundation by its URL slug. Returns all publicly visible information including purpose/description, application criteria (how to apply for funding), exclusions (what is not supported), topics, target groups, geographic areas of impact, SOGC registry data (address, founding date, supervisory authority), board members and their roles, SDGs, and contact details. One round trip to the Spheriq detail page. Returns stale_input with kind input_not_found when the slug does not match any published organization.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | URL slug of the organization (from search_organizations results, e.g. 'ernst-goehner-stiftung'). |
| `type` | string | No | Type of item: 'organization' or 'project'. Determines the URL path used to fetch the detail page. |

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

### Search organizations

Search foundations and organizations in the Spheriq Swiss nonprofit database. Returns paginated results with name, description, categories (topics), target groups, and organizational metadata. Results are auto-iterated; the SDK walks pages automatically. An empty query returns all entries. Each item carries resolved human-readable category labels derived from the NKS classification system used in Swiss philanthropy.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `form_of_impact` | string | No | Filter by organization type. Omitted returns all types. |
| `hits_per_page` | integer | No | Number of results per page (1-1000). |
| `page` | integer | No | Zero-based page index for pagination. |
| `query` | string | No | Free-text search query matching organization/project names and descriptions. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/spheriq/search-organizations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"form_of_impact":"<string>","hits_per_page":"<integer>","page":"<integer>","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.