Expense Threshold Config - API Contract

GET /api/v1/expense-thresholds/api/v1/expense-thresholds

List threshold configurations across organizations (admin)

Public

Response Example

{
  "data": [
    {
      "threshold_id": "thr_2e9a7b",
      "organization_id": "org_4729bc",
      "receipt_threshold_nok": 200,
      "auto_approval_distance_km": 50,
      "currency": "NOK",
      "updated_at": "2026-01-15T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

GET /api/v1/expense-thresholds/api/v1/expense-thresholds/:id

Get threshold configuration by ID

Public

Response Example

{
  "threshold_id": "thr_2e9a7b",
  "organization_id": "org_4729bc",
  "receipt_threshold_nok": 200,
  "auto_approval_distance_km": 50,
  "currency": "NOK",
  "updated_at": "2026-01-15T00:00:00Z"
}

POST /api/v1/expense-thresholds/api/v1/expense-thresholds

Create threshold configuration for a new organization

Public

Request Example

{
  "organization_id": "org_9c3f1d",
  "receipt_threshold_nok": 150,
  "auto_approval_distance_km": 30,
  "currency": "NOK"
}

Response Example

{
  "threshold_id": "thr_7a1c4e",
  "organization_id": "org_9c3f1d",
  "receipt_threshold_nok": 150,
  "auto_approval_distance_km": 30,
  "currency": "NOK",
  "created_at": "2026-03-26T10:00:00Z"
}

PUT /api/v1/expense-thresholds/api/v1/expense-thresholds/:id

Update threshold values for an organization

Public

Request Example

{
  "receipt_threshold_nok": 250,
  "auto_approval_distance_km": 75
}

Response Example

{
  "threshold_id": "thr_2e9a7b",
  "organization_id": "org_4729bc",
  "receipt_threshold_nok": 250,
  "auto_approval_distance_km": 75,
  "updated_at": "2026-03-26T10:30:00Z"
}

DELETE /api/v1/expense-thresholds/api/v1/expense-thresholds/:id

Remove threshold configuration (reverts to system defaults)

Public

Response Example

{
  "deleted": true,
  "threshold_id": "thr_2e9a7b"
}

GET /api/v1/expense-thresholds/api/v1/expense-thresholds/by-organization/:organizationId

Get active threshold config for an organization

Public

Response Example

{
  "threshold_id": "thr_2e9a7b",
  "organization_id": "org_4729bc",
  "receipt_threshold_nok": 200,
  "auto_approval_distance_km": 50,
  "currency": "NOK",
  "is_receipt_required_above_threshold": true
}

POST /api/v1/expense-thresholds/api/v1/expense-thresholds/check-receipt-required

Check if receipt is required for a given amount and organization

Public

Request Example

{
  "organization_id": "org_4729bc",
  "amount": 247.5
}

Response Example

{
  "receipt_required": true,
  "threshold_nok": 200,
  "amount": 247.5,
  "currency": "NOK"
}

POST /api/v1/expense-thresholds/api/v1/expense-thresholds/refresh

Force refresh cached threshold config for organization

Public

Request Example

{
  "organization_id": "org_4729bc"
}

Response Example

{
  "organization_id": "org_4729bc",
  "refreshed": true,
  "refreshed_at": "2026-03-26T10:35:00Z"
}

Additional Metadata

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