---
title: "Previews loyalty reward that will be issued when closing a job (based on ActualRev delta)"
method: GET
path: "/api/v1/jobs/{jobId}/referrals/loyalty-rewards/preview"
tags: ["JobReferral"]
---

# Previews loyalty reward that will be issued when closing a job (based on ActualRev delta)

`GET /api/v1/jobs/{jobId}/referrals/loyalty-rewards/preview`

## Request

- Base URL: `https://api.fireserviceusa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fireserviceusa.com/api/v1/jobs/{jobId}/referrals/loyalty-rewards/preview`
- Auth: none declared

## Path parameters

- `jobId` integer, required

## Response `200`

Success

- LoyaltyRewardsPreviewViewModel: View model for previewing loyalty rewards eligibility
  - `JobId` integer: The job ID
  - `IsEligible` boolean: Whether the job is eligible for loyalty rewards
  - `MainReferrerId` integer: The main referrer entity ID
  - `MainReferrerName` string, nullable: The main referrer name
  - `RewardRate` number, double: The loyalty rewards rate (decimal, e.g., 0.10 for 10%)
  - `RewardRateDisplay` string, nullable: The reward rate display string (e.g., "10%")
  - `EligibleInvoices` EligibleInvoiceViewModel[], nullable: The list of eligible invoices (for legacy compatibility; now represents job-level reward)
    - `InvoiceId` integer: The invoice ID
    - `InvoiceNumber` string, nullable: The invoice number
    - `InvoiceDate` string, date-time: The invoice date
    - `InvoiceAmount` number, double: The invoice amount
    - `RewardAmount` number, double: The calculated reward amount for this invoice
    - `Description` string, nullable: The invoice description
  - `TotalRewardAmount` number, double: The total reward amount across all invoices
  - `Message` string, nullable: A message about eligibility status
  - `JobActualRev` number, double: Job ActualRev (new field for ActualRev-based rewards)
  - `AlreadyIssuedThrough` number, double: Amount already issued through previous close cycles
  - `EligibleRevenueDelta` number, double: Eligible revenue delta (ActualRev - AlreadyIssuedThrough)

---

[API](https://skmtc.dev/fireserviceusa/apis/fireservice-usa-p2-api.md) - [All operations](https://skmtc.dev/fireserviceusa/apis/fireservice-usa-p2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireserviceusa/apis/fireservice-usa-p2-api/revisions/96ea2ea68d87?raw)