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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-app-spheriq-ch-api-d8cc6103/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-app-spheriq-ch-api-d8cc6103/get_organization \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-app-spheriq-ch-api-d8cc6103/search_organizations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form_of_impact":"<string>","hits_per_page":"<integer>","page":"<integer>","query":"<string>"}'
```