REST /api/v1/bufdir-storage 4 endpoints
GET /api/v1/bufdir-storage/api/v1/bufdir-storage

List stored export files for an organisation

Public

Response Example

{
  "data": [
    {
      "export_id": "exp-20260301-abc123",
      "file_name": "bufdir-rapport-2025-org-bufdir-042.xlsx",
      "file_size_bytes": 204800,
      "uploaded_at": "2026-03-01T08:03:00Z",
      "expires_at": "2026-04-01T08:03:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5
  }
}
GET /api/v1/bufdir-storage/api/v1/bufdir-storage/:export_id/download-url

Get a signed download URL for an export file

Public

Response Example

{
  "export_id": "exp-20260301-abc123",
  "download_url": "https://storage.example.no/exports/exp-20260301-abc123.xlsx?token=abc&expires=1743945600",
  "expires_at": "2026-04-06T10:00:00Z"
}
POST /api/v1/bufdir-storage/api/v1/bufdir-storage/:export_id/upload

Upload an export file

Public

Request Example

{
  "file_name": "bufdir-rapport-2025-org-bufdir-042.xlsx",
  "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
  "file_size_bytes": 204800
}

Response Example

{
  "export_id": "exp-20260326-xyz789",
  "upload_url": "https://storage.example.no/uploads/presigned?token=xyz",
  "file_name": "bufdir-rapport-2025-org-bufdir-042.xlsx",
  "uploaded_at": "2026-03-26T10:02:00Z"
}
DELETE /api/v1/bufdir-storage/api/v1/bufdir-storage/:export_id

Delete an export file from storage

Public

Response Example

{
  "deleted": true,
  "export_id": "exp-20260301-abc123"
}

Additional Metadata

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