Receipt Threshold Validator
API Contract
REST
/api/v1/receipt-thresholds
7 endpoints
GET
/api/v1/receipt-thresholds/api/v1/receipt-thresholds
List receipt thresholds for all organisations
Public
Response Example
{
"data": [
{
"org_id": "org-42",
"org_name": "Acme Corp",
"threshold_amount": 50,
"currency": "NOK",
"effective_from": "2026-01-01",
"updated_at": "2026-01-15T08:00:00Z"
},
{
"org_id": "org-17",
"org_name": "Byggern AS",
"threshold_amount": 100,
"currency": "NOK",
"effective_from": "2025-07-01",
"updated_at": "2025-07-01T00:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2
}
}
GET
/api/v1/receipt-thresholds/api/v1/receipt-thresholds/:orgId
Get receipt threshold configuration for a specific organisation
Public
Response Example
{
"org_id": "org-42",
"org_name": "Acme Corp",
"threshold_amount": 50,
"currency": "NOK",
"effective_from": "2026-01-01",
"updated_at": "2026-01-15T08:00:00Z"
}
POST
/api/v1/receipt-thresholds/api/v1/receipt-thresholds
Create a receipt threshold configuration for an organisation
Public
Request Example
{
"org_id": "org-99",
"threshold_amount": 75,
"currency": "NOK",
"effective_from": "2026-04-01"
}
Response Example
{
"org_id": "org-99",
"threshold_amount": 75,
"currency": "NOK",
"effective_from": "2026-04-01",
"created_at": "2026-03-26T10:00:00Z"
}
PUT
/api/v1/receipt-thresholds/api/v1/receipt-thresholds/:orgId
Update receipt threshold for an organisation
Public
Request Example
{
"threshold_amount": 60,
"currency": "NOK",
"effective_from": "2026-04-01"
}
Response Example
{
"org_id": "org-42",
"threshold_amount": 60,
"currency": "NOK",
"effective_from": "2026-04-01",
"updated_at": "2026-03-26T10:05:00Z"
}
DELETE
/api/v1/receipt-thresholds/api/v1/receipt-thresholds/:orgId
Delete receipt threshold configuration for an organisation
Public
Response Example
{
"org_id": "org-99",
"status": "deleted",
"deleted_at": "2026-03-26T10:10:00Z"
}
GET
/api/v1/receipt-thresholds/api/v1/receipt-thresholds/:orgId/required
Check whether a receipt is required for a given claim amount
Public
Response Example
{
"org_id": "org-42",
"claim_amount": 49.99,
"threshold_amount": 50,
"receipt_required": false,
"reason": "Claim amount is below the NOK 50.00 threshold"
}
POST
/api/v1/receipt-thresholds/api/v1/receipt-thresholds/:orgId/validate
Validate a submission — checks if receipt is required and present
Public
Request Example
{
"claim_amount": 120,
"has_attachment": false
}
Response Example
{
"org_id": "org-42",
"claim_amount": 120,
"has_attachment": false,
"receipt_required": true,
"valid": false,
"validation_message": "A receipt is required for claims above NOK 50.00. Please attach a receipt before submitting."
}