Bufdir API Integration Service
API Contract
REST
/api/v1/bufdir-submissions
4 endpoints
GET
/api/v1/bufdir-submissions/api/v1/bufdir-submissions
List all Bufdir API submissions
Public
Response Example
{
"data": [
{
"submission_id": "sub-20260301-001",
"org_id": "org-bufdir-042",
"export_id": "exp-20260301-abc123",
"status": "accepted",
"submitted_at": "2026-03-01T08:05:00Z",
"acknowledged_at": "2026-03-01T08:05:12Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2
}
}
GET
/api/v1/bufdir-submissions/api/v1/bufdir-submissions/:submission_id
Get the status of a Bufdir API submission
Public
Response Example
{
"submission_id": "sub-20260301-001",
"org_id": "org-bufdir-042",
"export_id": "exp-20260301-abc123",
"status": "accepted",
"bufdir_reference_id": "BUFDIR-2026-0042-001",
"submitted_at": "2026-03-01T08:05:00Z",
"acknowledged_at": "2026-03-01T08:05:12Z",
"error_message": null
}
POST
/api/v1/bufdir-submissions/api/v1/bufdir-submissions
Submit a report to the Bufdir API
Public
Request Example
{
"export_id": "exp-20260326-xyz789",
"org_id": "org-bufdir-042",
"report_period": "2025",
"file_url": "https://storage.example.no/exports/exp-20260326-xyz789.xlsx",
"activity_count": 312
}
Response Example
{
"submission_id": "sub-20260326-002",
"status": "submitted",
"bufdir_endpoint": "https://api.bufdir.no/reporting/v1/submit",
"submitted_at": "2026-03-26T10:10:00Z"
}
GET
/api/v1/bufdir-submissions/api/v1/bufdir-submissions/health
Check whether the Bufdir API is available
Public
Response Example
{
"available": true,
"endpoint": "https://api.bufdir.no/reporting/v1",
"latency_ms": 84,
"checked_at": "2026-03-26T10:00:00Z"
}