Knowledge Base

`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

Cremation question

curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-knowledge?topic=cremation+price+barcelona" \
  -H "Authorization: Bearer YOUR_API_KEY"

Post-death procedures

curl -X GET \
  "https://qegraxvwwikrltmtfamo.supabase.co/functions/v1/v1-knowledge?topic=death+procedures+spain" \
  -H "Authorization: Bearer YOUR_API_KEY"

Product differences

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`)

{
  "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

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

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

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

Legal and procedures

Death certificate and registration
Will and inheritance
Social Security deregistration
Widowhood pension
Municipal register deregistration

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.

Getting started

API Reference

`GET /v1-knowledge`

Parameters

Request examples

Successful response (`200 OK`)

Response fields

Topics covered in the Knowledge Base

Limits

Possible errors

GPT Action description

​GET /v1-knowledge

​Parameters

​Request examples

​Successful response (200 OK)

​Response fields

​Topics covered in the Knowledge Base

​Limits

​Possible errors

​GPT Action description

`GET /v1-knowledge`

Parameters

Request examples

Successful response (`200 OK`)

Response fields

Topics covered in the Knowledge Base

Limits

Possible errors

GPT Action description