# Aquinas — 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 bilingual texts from Thomas Aquinas's philosophical and theological works, with the ability to find specific articles and statements across the entire collection. Access organized works by reference or use global search to discover relevant passages on topics within Aquinas's writings.

**Category:** Education | **Website:** [aquinas.cc/](https://aquinas.cc/) | **Docs:** [parse.bot/marketplace/b451b92f-9b03-4004-b0ae-520d763b3bf9/aquinas-cc-api](https://parse.bot/marketplace/b451b92f-9b03-4004-b0ae-520d763b3bf9/aquinas-cc-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/aquinas/`
**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 article

Retrieve parallel Latin/English text for a specific article reference within a work. Returns cell-level bilingual content with cell IDs that correspond to paragraph-level segments. Each cell contains the original Latin and its English translation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `ref` | string | Yes | Article reference within the work, formatted as WorkCode.Q{number}.A{number} (e.g. ST.I.Q2.A2, ST.III.Q2.A2) |
| `work` | string | Yes | Work code from list_works (e.g. ST.I, ST.III, SCG1) |

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

### Get statements

Extract statements matching a query term from across the library. Searches Latin text and returns matching passages with their English translations. Limited to 20 results from the top 5 works by hit count. Useful for finding specific theological or philosophical concepts across the corpus.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Latin term to search for in the text (e.g. subsistendi, gratia) |

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

### List works

List all available works in the Aquinas library with their internal work IDs and work codes. Returns a list of works with code and numeric ID that can be used with other endpoints.

**Estimated cost:** Metered

_No parameters required._

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

### Search

Search for a term across all works in the Aquinas library. Returns a list of works containing the term with hit counts. Searches Latin text by default. Supports exact match, any word, all words, and regex modes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mode` | string | No | Search mode. |
| `query` | string | Yes | Search term to find across all works (Latin or English text) |

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