Activity Category Mapping Config
API Contract
REST
/api/v1/activity-category-mappings
6 endpoints
GET
/api/v1/activity-category-mappings/api/v1/activity-category-mappings
List all activity-to-Bufdir category mappings for an organization
Public
Response Example
{
"data": [
{
"id": "map-001",
"org_id": "org-bufdir-42",
"internal_activity_type": "peer_support_group",
"bufdir_category_code": "ungdom",
"bufdir_category_label": "Ungdom (13-25 år)",
"is_validated": true,
"created_at": "2024-09-01T00:00:00Z"
},
{
"id": "map-002",
"org_id": "org-bufdir-42",
"internal_activity_type": "family_workshop",
"bufdir_category_code": "foreldre_barn",
"bufdir_category_label": "Foreldre og barn",
"is_validated": true,
"created_at": "2024-09-01T00:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 9
}
}
GET
/api/v1/activity-category-mappings/api/v1/activity-category-mappings/:id
Get a specific mapping by ID
Public
Response Example
{
"id": "map-001",
"org_id": "org-bufdir-42",
"internal_activity_type": "peer_support_group",
"bufdir_category_code": "ungdom",
"bufdir_category_label": "Ungdom (13-25 år)",
"is_validated": true,
"validation_note": "Confirmed by reporting coordinator 2024-09",
"created_at": "2024-09-01T00:00:00Z",
"updated_at": "2024-09-01T00:00:00Z"
}
POST
/api/v1/activity-category-mappings/api/v1/activity-category-mappings
Create a new internal-to-Bufdir category mapping
Public
Request Example
{
"org_id": "org-bufdir-42",
"internal_activity_type": "elderly_social_club",
"bufdir_category_code": "eldre",
"bufdir_category_label": "Eldre (67+)",
"is_validated": false
}
Response Example
{
"id": "map-010",
"org_id": "org-bufdir-42",
"internal_activity_type": "elderly_social_club",
"bufdir_category_code": "eldre",
"bufdir_category_label": "Eldre (67+)",
"is_validated": false,
"created_at": "2025-03-26T09:00:00Z"
}
PUT
/api/v1/activity-category-mappings/api/v1/activity-category-mappings/:id
Update or validate an existing mapping
Public
Request Example
{
"bufdir_category_code": "eldre",
"is_validated": true,
"validation_note": "Reviewed and approved by admin 2025-03-26"
}
Response Example
{
"id": "map-010",
"org_id": "org-bufdir-42",
"internal_activity_type": "elderly_social_club",
"bufdir_category_code": "eldre",
"is_validated": true,
"validation_note": "Reviewed and approved by admin 2025-03-26",
"updated_at": "2025-03-26T10:00:00Z"
}
DELETE
/api/v1/activity-category-mappings/api/v1/activity-category-mappings/:id
Delete an activity category mapping
Public
Response Example
{
"deleted": true,
"id": "map-010"
}
GET
/api/v1/activity-category-mappings/api/v1/activity-category-mappings/validate-completeness
Check whether all provided internal activity types have a Bufdir mapping
Public
Response Example
{
"org_id": "org-bufdir-42",
"is_complete": false,
"mapped": [
"peer_support_group",
"family_workshop"
],
"unmapped": [
"crisis_intervention"
]
}