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
Post-death procedures
Product differences
Successful response (200 OK)
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)
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)
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
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
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_approvedorpending_revieware 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 |

