Report Re-export Coordinator - API Contract

GET /api/v1/report-reexports/api/v1/report-reexports

List re-export jobs with status tracking

Public

Response Example

{
  "data": [
    {
      "reexport_id": "reexp_01KA2L5P6Q7R8S9T0U1V2W3X",
      "report_id": "rpt_01HX9K2M3N4P5Q6R7S8T9U0V",
      "org_id": "org_bufdir_oslo_42",
      "status": "completed",
      "export_params": {
        "format": "xlsx",
        "include_annexes": true,
        "locale": "nb-NO"
      },
      "output_file_ref": "reports/org_bufdir_oslo_42/reexports/rpt_01HX9K2M_reexport_20260326.xlsx",
      "requested_by": "user_09AXKL2",
      "requested_at": "2026-03-26T09:00:00Z",
      "completed_at": "2026-03-26T09:02:15Z",
      "notified": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

GET /api/v1/report-reexports/api/v1/report-reexports/:reexport_id

Get status and result of a specific re-export job

Public

Response Example

{
  "reexport_id": "reexp_01KA2L5P6Q7R8S9T0U1V2W3X",
  "report_id": "rpt_01HX9K2M3N4P5Q6R7S8T9U0V",
  "org_id": "org_bufdir_oslo_42",
  "status": "completed",
  "export_params": {
    "format": "xlsx",
    "include_annexes": true,
    "locale": "nb-NO"
  },
  "output_file_ref": "reports/org_bufdir_oslo_42/reexports/rpt_01HX9K2M_reexport_20260326.xlsx",
  "output_file_size_bytes": 215040,
  "requested_by": "user_09AXKL2",
  "requested_at": "2026-03-26T09:00:00Z",
  "completed_at": "2026-03-26T09:02:15Z",
  "notified": true,
  "error_message": null
}

POST /api/v1/report-reexports/api/v1/report-reexports

Trigger a re-export of a historical report with optional parameter overrides

Public

Request Example

{
  "report_id": "rpt_01HX9K2M3N4P5Q6R7S8T9U0V",
  "export_params": {
    "format": "xlsx",
    "include_annexes": true,
    "locale": "nb-NO"
  },
  "notify_on_completion": true
}

Response Example

{
  "reexport_id": "reexp_02KB3M6Q7R8S9T0U1V2W3X4Y",
  "report_id": "rpt_01HX9K2M3N4P5Q6R7S8T9U0V",
  "org_id": "org_bufdir_oslo_42",
  "status": "pending",
  "export_params": {
    "format": "xlsx",
    "include_annexes": true,
    "locale": "nb-NO"
  },
  "output_file_ref": null,
  "requested_by": "user_09AXKL2",
  "requested_at": "2026-03-26T12:00:00Z",
  "completed_at": null,
  "notified": false
}

PUT /api/v1/report-reexports/api/v1/report-reexports/:reexport_id

Update re-export job state (e.g. store result file ref, mark notification sent)

Public

Request Example

{
  "status": "completed",
  "output_file_ref": "reports/org_bufdir_oslo_42/reexports/rpt_01HX9K2M_reexport_20260326.xlsx",
  "output_file_size_bytes": 215040,
  "completed_at": "2026-03-26T12:02:30Z",
  "notified": true
}

Response Example

{
  "reexport_id": "reexp_02KB3M6Q7R8S9T0U1V2W3X4Y",
  "report_id": "rpt_01HX9K2M3N4P5Q6R7S8T9U0V",
  "org_id": "org_bufdir_oslo_42",
  "status": "completed",
  "output_file_ref": "reports/org_bufdir_oslo_42/reexports/rpt_01HX9K2M_reexport_20260326.xlsx",
  "output_file_size_bytes": 215040,
  "requested_at": "2026-03-26T12:00:00Z",
  "completed_at": "2026-03-26T12:02:30Z",
  "notified": true
}

DELETE /api/v1/report-reexports/api/v1/report-reexports/:reexport_id

Cancel a pending re-export job

Public

Response Example

{
  "reexport_id": "reexp_02KB3M6Q7R8S9T0U1V2W3X4Y",
  "cancelled": true,
  "cancelled_at": "2026-03-26T12:01:00Z"
}

Additional Metadata

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