Bufdir API Client

Authenticate against the Bufdir external API

{
  "client_id": "eircodex_org_482",
  "client_secret": "s3cr3t_token_here"
}

{
  "access_token": "eyJhbGciOiJSUzI1NiJ9.eyJvcmciOiJvcmdfNDgyIn0.sig",
  "token_type": "Bearer",
  "expires_in": 3600,
  "issued_at": "2026-03-26T10:00:00Z"
}

Submit a validated export payload to Bufdir

{
  "report_id": "rpt_20250101_region07_pdf",
  "org_id": "org_482",
  "payload_version": "bufdir_2025_v2",
  "payload": {
    "organisasjonsnummer": "912345678",
    "rapporteringsperiode": "2025",
    "aktiviteter": [
      {
        "kategori": "individual_mentoring",
        "antall": 842,
        "timer": 6740
      }
    ]
  }
}

{
  "submission_reference_id": "bufdir_ref_20260326_00482",
  "status": "received",
  "submitted_at": "2026-03-26T10:30:00Z",
  "bufdir_confirmation": "Rapport mottatt og registrert."
}

Check status of a previously submitted Bufdir report

{}

{
  "reference_id": "bufdir_ref_20260326_00482",
  "status": "accepted",
  "submitted_at": "2026-03-26T10:30:00Z",
  "processed_at": "2026-03-26T11:00:00Z",
  "notes": "Rapporten er behandlet og godkjent."
}

Validate an export payload against Bufdir schema before submission

{
  "payload_version": "bufdir_2025_v2",
  "payload": {
    "organisasjonsnummer": "912345678",
    "rapporteringsperiode": "2025",
    "aktiviteter": [
      {
        "kategori": "individual_mentoring",
        "antall": 842,
        "timer": 6740
      }
    ]
  }
}

{
  "is_valid": true,
  "payload_version": "bufdir_2025_v2",
  "errors": [],
  "warnings": [
    "Field 'kontaktperson' is recommended but not present."
  ]
}

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