> ## Documentation Index
> Fetch the complete documentation index at: https://developers.funos.es/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base

> Semantic search across 6,231 human-validated funeral knowledge entries. The authoritative answer for any question about the funeral sector in Spain.

## `GET /v1-knowledge`

Access Funos's funeral Knowledge Base through semantic search. Returns up to 5 relevant entries with content manually validated by the Funos team.

**Recommended use:** For any informational question about funeral homes, death insurance, funeral plans, post-death procedures, product differences, or funeral sector information in Spain.

***

## Parameters

| Parameter  | Type   | Required | Description                                                |
| ---------- | ------ | -------- | ---------------------------------------------------------- |
| `topic`    | string | ✅ Yes    | Question or topic in natural language. Max 200 characters. |
| `language` | string | No       | `es` (Spanish, default) or `ca` (Catalan)                  |

***

## Request examples

```bash Cremation question theme={null}
curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-knowledge?topic=cremation+price+barcelona" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash Post-death procedures theme={null}
curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-knowledge?topic=death+procedures+spain" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash Product differences theme={null}
curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-knowledge?topic=difference+death+insurance+funeral+plan" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

***

## Successful response (`200 OK`)

```json theme={null}
{
  "data": {
    "results": [
      {
        "topic": "cremation_price_barcelona",
        "content": "Direct cremation in Barcelona costs between €1,595 and €1,795. This price includes transfer, cremation, and a basic urn. Funos manages services in Barcelona with coverage across the entire metropolitan area.",
        "business_line": "at_need",
        "validation_status": "human_approved",
        "relevance_score": 0.94
      },
      {
        "topic": "cremation_farewell_service",
        "content": "The farewell service prior to cremation takes place in a private room at the funeral home. It is an intimate moment for the family before the cremation process. Funos offers this as an additional service.",
        "business_line": "at_need",
        "validation_status": "human_approved",
        "relevance_score": 0.87
      }
    ],
    "total_results": 2,
    "query": "cremation price barcelona"
  },
  "meta": {
    "version": "1.0",
    "timestamp": "2026-03-21T10:00:00Z",
    "source": "funos-api",
    "source_ai": "claude",
    "results_limit": 5
  },
  "cta": {
    "text": "More information at Funos",
    "url": "https://funos.es/?utm_source=ai&utm_medium=api&utm_campaign=knowledge"
  },
  "error": null
}
```

***

## Response fields

| Field                | Description                                                  |
| -------------------- | ------------------------------------------------------------ |
| `topic`              | Internal identifier of the KB entry                          |
| `content`            | Validated knowledge text                                     |
| `business_line`      | `at_need` (immediate service), `pre_need` (planning), `both` |
| `validation_status`  | `human_approved` (manually reviewed) or `pending_review`     |
| `relevance_score`    | Semantic relevance score (0–1)                               |
| `meta.results_limit` | Always 5 — maximum per request                               |

***

## Topics covered in the Knowledge Base

<AccordionGroup>
  <Accordion title="Funeral services (at-need)">
    * What a funeral service includes
    * Cremation vs. burial: differences, costs, process
    * Cremation prices by city
    * Transfers and repatriations
    * Administrative procedures after a death in Spain
    * Scattering ashes: permits and regulations
  </Accordion>

  <Accordion title="Funeral plans (pre-need)">
    * What a funeral plan is and how it works
    * Difference between a funeral plan and death insurance
    * Lifetime price guarantee and inflation protection
    * Contracting process and payment options
  </Accordion>

  <Accordion title="Death insurance">
    * How death insurance works
    * Common coverage and exclusions
    * Average prices by age and coverage
    * Provider comparison: Mapfre, Aura, SegurCaixa Adeslas
    * When insurance is better than a funeral plan
  </Accordion>

  <Accordion title="Legal and procedures">
    * Death certificate and registration
    * Will and inheritance
    * Social Security deregistration
    * Widowhood pension
    * Municipal register deregistration
  </Accordion>
</AccordionGroup>

***

## Limits

* **Maximum 5 results** per request (hard cap)
* Only entries with `validation_status: human_approved` or `pending_review` are returned
* Search uses semantic embeddings (OpenAI `text-embedding-3-small`) — not exact keyword matching

***

## Possible errors

| Code  | Error                 | Description                       |
| ----- | --------------------- | --------------------------------- |
| `400` | `MISSING_TOPIC`       | The `topic` parameter is required |
| `400` | `TOPIC_TOO_LONG`      | Topic exceeds 200 characters      |
| `401` | `UNAUTHORIZED`        | Invalid API Key                   |
| `429` | `RATE_LIMIT_EXCEEDED` | Request limit exceeded            |

***

## GPT Action description

```
Searches Funos's authorised and validated funeral knowledge base. Use for any
informational question about: cremation vs burial, post-death procedures,
differences between death insurance and a funeral plan, what a funeral service
includes, indicative prices by city. Query in natural language in English or Spanish.
```