Claim Receipt Repository - API Contract

GET /api/v1/claim-receipts/api/v1/claim-receipts

List claims with missing receipts for an organisation

Public

Response Example

{
  "data": [
    {
      "claim_id": "clm-290",
      "claim_title": "Taxi to airport",
      "claim_amount": 320,
      "currency": "NOK",
      "user_id": "usr-55",
      "submitted_at": "2026-03-20T14:30:00Z",
      "receipt_path": null,
      "missing_receipt": true
    },
    {
      "claim_id": "clm-295",
      "claim_title": "Team lunch",
      "claim_amount": 680,
      "currency": "NOK",
      "user_id": "usr-88",
      "submitted_at": "2026-03-21T12:00:00Z",
      "receipt_path": null,
      "missing_receipt": true
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

GET /api/v1/claim-receipts/api/v1/claim-receipts/:claimId

Get the receipt path associated with a specific claim

Public

Response Example

{
  "claim_id": "clm-301",
  "receipt_path": "orgs/org-42/users/usr-88/claims/clm-301/receipts/att-7821.jpg",
  "has_receipt": true,
  "signed_url": "https://storage.example.com/orgs/org-42/.../att-7821.jpg?token=xyz&expires=1743080400",
  "attached_at": "2026-03-22T10:14:00Z"
}

PUT /api/v1/claim-receipts/api/v1/claim-receipts/:claimId

Save or update the receipt storage path for a claim

Public

Request Example

{
  "storage_path": "orgs/org-42/users/usr-88/claims/clm-305/receipts/att-7830.jpg"
}

Response Example

{
  "claim_id": "clm-305",
  "receipt_path": "orgs/org-42/users/usr-88/claims/clm-305/receipts/att-7830.jpg",
  "has_receipt": true,
  "updated_at": "2026-03-26T09:55:00Z"
}

DELETE /api/v1/claim-receipts/api/v1/claim-receipts/:claimId

Clear the receipt path from a claim record

Public

Response Example

{
  "claim_id": "clm-305",
  "receipt_path": null,
  "has_receipt": false,
  "cleared_at": "2026-03-26T10:00:00Z"
}

Additional Metadata

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