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"
  ]
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}