Bufdir Schema Config Repository - API Contract

GET /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions

List schema versions for an organisation

Public

Response Example

{
  "data": [
    {
      "version_id": "schema-org-bufdir-042-v3",
      "org_id": "org-bufdir-042",
      "schema_version": "2025-v3",
      "column_count": 12,
      "created_at": "2026-01-10T09:00:00Z",
      "is_active": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

GET /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions/:org_id/active

Get the active schema for an organisation

Public

Response Example

{
  "org_id": "org-bufdir-042",
  "schema_version": "2025-v3",
  "columns": [
    {
      "source_field": "activity_type",
      "bufdir_column": "Aktivitetstype",
      "required": true,
      "data_type": "string"
    },
    {
      "source_field": "participant_count",
      "bufdir_column": "Antall deltakere",
      "required": true,
      "data_type": "integer"
    }
  ],
  "is_active": true,
  "created_at": "2026-01-10T09:00:00Z"
}

GET /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions/default

Get the default Bufdir column schema

Public

Response Example

{
  "schema_version": "default-2025",
  "columns": [
    {
      "source_field": "activity_type",
      "bufdir_column": "Aktivitetstype",
      "required": true,
      "data_type": "string"
    },
    {
      "source_field": "date",
      "bufdir_column": "Dato",
      "required": true,
      "data_type": "date"
    },
    {
      "source_field": "participant_count",
      "bufdir_column": "Antall deltakere",
      "required": true,
      "data_type": "integer"
    }
  ]
}

POST /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions

Save a new schema version for an organisation

Public

Request Example

{
  "org_id": "org-bufdir-042",
  "schema_version": "2026-v1",
  "columns": [
    {
      "source_field": "activity_type",
      "bufdir_column": "Aktivitetstype",
      "required": true,
      "data_type": "string"
    },
    {
      "source_field": "participant_count",
      "bufdir_column": "Antall deltakere",
      "required": true,
      "data_type": "integer"
    },
    {
      "source_field": "duration_minutes",
      "bufdir_column": "Varighet (minutter)",
      "required": false,
      "data_type": "integer"
    }
  ],
  "set_as_active": true
}

Response Example

{
  "version_id": "schema-org-bufdir-042-v4",
  "org_id": "org-bufdir-042",
  "schema_version": "2026-v1",
  "is_active": true,
  "created_at": "2026-03-26T10:00:00Z"
}

PUT /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions/:version_id

Update an existing schema version

Public

Request Example

{
  "columns": [
    {
      "source_field": "activity_type",
      "bufdir_column": "Aktivitetstype",
      "required": true,
      "data_type": "string"
    },
    {
      "source_field": "participant_count",
      "bufdir_column": "Antall deltakere",
      "required": true,
      "data_type": "integer"
    }
  ],
  "set_as_active": false
}

Response Example

{
  "version_id": "schema-org-bufdir-042-v4",
  "updated_at": "2026-03-26T10:05:00Z"
}

DELETE /api/v1/bufdir-schema-versions/api/v1/bufdir-schema-versions/:version_id

Delete a schema version

Public

Response Example

{
  "deleted": true,
  "version_id": "schema-org-bufdir-042-v3"
}

Additional Metadata

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