Skip to main content

​
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

ParameterTypeRequiredDescription
topicstring✅ YesQuestion or topic in natural language. Max 200 characters.
languagestringNoes (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

FieldDescription
topicInternal identifier of the KB entry
contentValidated knowledge text
business_lineat_need (immediate service), pre_need (planning), both
validation_statushuman_approved (manually reviewed) or pending_review
relevance_scoreSemantic relevance score (0–1)
meta.results_limitAlways 5 — maximum per request

​
Topics covered in the Knowledge Base

  • 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
  • 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
  • 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

​
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

CodeErrorDescription
400MISSING_TOPICThe topic parameter is required
400TOPIC_TOO_LONGTopic exceeds 200 characters
401UNAUTHORIZEDInvalid API Key
429RATE_LIMIT_EXCEEDEDRequest 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.