> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API changelog

> Release history and recent changes for the Omneo API.

<Info>
  Each release is tagged by the area of the API it touches. Use the tag filters in the right side panel to narrow the list (for example, **Incentives** for points, rewards, and benefits changes, or **Automation** for triggers, automations, and queries).
</Info>

<Update label="v15.1.0" description="Released 14 May 2026" tags={["Incentives", "Profiles", "Automation"]}>
  ### New features

  * **Earn tier points from benefits.** Interacting with specific benefits can now contribute toward [tier points](/concepts/incentives/tiers), opening up new ways to reward engagement beyond purchases. See [Benefits](/concepts/incentives/benefits) and [Points](/concepts/incentives/points).
  * **New `not_in` and `not_has` filter operators.** More precise audience segmentation against profile and automation queries. Available across [automation queries](/api-reference/automation-query) and profile filters.
  * **Broader interaction tracking.** Additional interaction types are now captured against profiles. See [Interactions](/api-reference/interaction).

  ### Improvements

  * **Future-dated benefits are now hidden from display until they activate.** Customers only see benefits they can redeem right now. See [Benefits](/concepts/incentives/benefits).
  * **Tier status now includes pending points.** A profile's tier surface returns both confirmed and pending point totals, giving a more accurate live view of progress toward the next tier. See [Tiers](/concepts/incentives/tiers).
  * **Faster product list loading** across [product lists](/api-reference/product-list) and [list items](/api-reference/product-list-item).
</Update>

<Update label="v15.0.0" description="Released 7 May 2026" tags={["Profiles"]}>
  ### Improvements

  * **Profile location.** Refined the new profile location surface for better performance. See [Profile localisation](/concepts/profiles/localisation).
</Update>

<Update label="v14.5.7" description="Released 6 May 2026" tags={["Incentives", "Commerce", "Configuration"]}>
  ### New features

  * **Product estimate endpoints.** New API endpoints to retrieve product estimates before a transaction is committed. See [Products](/concepts/commerce/products).
  * **Bulk benefit export.** Benefits data can now be exported as a CSV from CX Manager.

  ### Improvements

  * **Tier status updates on point expiry.** When points expire, a profile's tier status now recalculates automatically. See [Tiers](/concepts/incentives/tiers).
  * **Rate prioritisation.** More options for setting priority on rate calculations. See [Rates](/api-reference/rate).
</Update>

<Update label="v14.5.6" description="Released 16 April 2026" tags={["Profiles", "Batch"]}>
  ### New features

  * **Batch update custom attributes and regions.** Update [custom attributes](/concepts/profiles/custom-attributes) and [regions](/concepts/profiles/localisation) for many profiles at once via the [Batch](/api-reference/batch) endpoints.
  * **Advanced profile validation filtering.** [Profile validation rules](/api-reference/profile-validation-rule) accept richer filter expressions for more granular targeting.

  ### Improvements

  * **`expires_at` included in profile status context.** Status payloads now carry expiry information directly. See [Statuses](/concepts/profiles/tags-and-statuses).
</Update>

<Update label="v14.5.5" description="Released 13 April 2026" tags={["Profiles"]}>
  ### New features

  * **Per-profile rule controls.** Apply rules to individual profiles to govern how they interact with the platform. Useful for managing exception cases that need specific treatment without deleting or depersonalising the record. See [Profile statuses](/concepts/profiles/tags-and-statuses).
</Update>

<Update label="v14.5.4" description="Released 9 April 2026" tags={["Incentives", "Profiles"]}>
  ### New features

  * **Benefit visibility endpoint.** New endpoint `GET profiles/{profile}/benefits/visibility` returns the benefit definitions a profile is currently allowed to see, based on the definition's `visibility_condition`. See [Benefits](/concepts/incentives/benefits) and [Profile benefit](/api-reference/profile-benefit).

  ### Improvements

  * **Country search by full name.** Country lookups accept either the country code or the full name. See [Country](/api-reference/country).
  * **Protected join date and join location.** A profile's original join date and join location are now immutable once set, preserving the integrity of cohort and tenure reporting. See [Profile core fields](/concepts/profiles/core-fields).
  * **Consistent redemption list sorting.** [Redemption](/api-reference/redemption) and [Redemption item](/api-reference/redemption-item) lists sort consistently by ID.
</Update>

<Update label="v14.5.3" description="Released 31 March 2026" tags={["Batch", "Imports"]}>
  ### New features

  * **Advanced batch processing.** New API endpoints for fine-grained control over batch jobs, including dry runs that validate a batch without applying it, and explicit finalise steps for both batches and their parent imports. See [Batch](/api-reference/batch) and [Imports](/api-reference/import).
</Update>

<Update label="v14.5.2" description="Released 26 March 2026" tags={["Audit", "Commerce"]}>
  ### New features

  * **Programmatic audit creation.** A new endpoint allows saving an audit entry programmatically, making audits accessible to integrations and automations. See [Audit](/api-reference/audit).

  ### Improvements

  * **Stock accuracy on product variations.** Only [product variants](/api-reference/product-variant) with available stock are returned in stock-aware contexts.
</Update>

<Update label="v14.5.1" description="Released 25 March 2026" tags={["Incentives", "Webhooks", "Profiles"]}>
  ### New features

  * **Redemption data endpoints.** New endpoints to retrieve [redemption](/api-reference/redemption) and [redemption item](/api-reference/redemption-item) data.
  * **`benefit.expired` webhook event.** A new event fires when a profile's benefit expires, so integrations can react automatically. See [Webhooks](/concepts/automation/webhooks) and [Benefits](/concepts/incentives/benefits).

  ### Improvements

  * **Leaner tier definition payloads.** [Tier definition](/api-reference/tier-definition) responses now omit fields that integrations rarely use, reducing payload size.
  * **`updated_at` refreshes on address change.** A profile's `updated_at` timestamp updates when one of its [addresses](/concepts/profiles/addresses) is modified.
  * **More sortable lists.** Additional list endpoints accept sorting by ID.
  * **Reward expiration accuracy.** Improved calculation of [reward](/concepts/incentives/rewards) expiry dates.
</Update>

<Update label="v14.5.0" description="Released 5 March 2026" tags={["Profiles", "Incentives", "Ratings", "Automation"]}>
  ### New features

  * **Region on profile attributes.** Profile attribute payloads now accept a `region`, enabling region-aware personalisation. See [Profile localisation](/concepts/profiles/localisation) and [Profile region](/api-reference/profile-region).
  * **New automation actions.** A new system action, plus enhancements to the create-tier-point action. See [Reactions](/concepts/automation/reactions) and [Tier point](/api-reference/tier-point).

  ### Improvements

  * **Upgraded rating system.** The rating engine has been overhauled with more flexible and accurate calculations across [CSAT](/concepts/ratings/csat), [NPS](/concepts/ratings/nps), [product](/concepts/ratings/product-ratings), and [location](/concepts/ratings/location-ratings) ratings.
</Update>

<Update label="v14.4.4" description="Released 2 March 2026" tags={["Incentives", "Credits", "Automation"]}>
  ### New features

  * **Issue multiple credits in one call.** Specify a quantity and value to issue several credits in a single request. See [Credits](/concepts/commerce/credits) and the [Credit](/api-reference/credit) endpoints.
  * **Filter daily spend aggregations by product tag.** [Profile aggregations](/concepts/profiles/aggregations) can now be sliced by product tag.
  * **New automation query for daily spend by tag.** Trigger actions when a profile's spend on tagged products crosses a threshold. See [Automation query](/api-reference/automation-query).
</Update>

<Update label="v14.4.3" description="Released 22 February 2026" tags={["Profiles"]}>
  ### New features

  * **Custom date attributes on profiles.** Track milestones and anniversaries with profile date attributes, including events when those dates change. See [Custom attributes](/concepts/profiles/custom-attributes) and [Profile dates attribute](/api-reference/profile-dates-attribute).
</Update>

<Update label="v14.4.2" description="Released 17 February 2026" tags={["Lists", "Incentives"]}>
  ### New features

  * **Targeted product reservations.** Offer [product list reservations](/api-reference/product-list-reservations) to specific customer segments rather than the full audience. See [List reservations](/concepts/lists/list-reservations).
  * **List expiration dates.** Set an expiry date on a list to manage time-bound campaigns. See [Lists](/concepts/lists/overview).

  ### Improvements

  * **Reservation event tracking.** The reservation lifecycle now emits clearer events for downstream automations.
  * **Smoother redemption flow.** Reward and benefit redemption is more reliable. See [Redemption](/api-reference/redemption).
</Update>

<Update label="v14.4.1" description="Released 11 February 2026" tags={["Automation", "Profiles"]}>
  ### New features

  * **Check profile status action.** A new automation action to look up and verify a profile's status. See [Profile statuses](/concepts/profiles/tags-and-statuses).
  * **Custom transaction event trigger.** Fire a named event with the transaction context, optionally with a custom payload. Available from a [Reaction](/concepts/automation/reactions) or via the Artisan command surface.
  * **`DispatchProfileTransactionEvent` action.** Finds a profile's transactions (optionally within a date range), filters them with JsonLogic, and dispatches a custom event for each match. See [Automation action](/api-reference/automation-action).
  * **`get_date` JsonLogic operator.** Returns a datetime string based on a base date with optional offset, timezone, UTC conversion, and start- or end-of-day flags. Useful for building date-aware automation queries. See [Automation query](/api-reference/automation-query).

  ### Improvements

  * **Exact-match numeric condition.** Build precise rules by matching a number field to an exact value in [automation queries](/api-reference/automation-query).
</Update>

<Update label="v14.4.0" description="Released 9 February 2026" tags={["Incentives", "Audit", "Automation"]}>
  ### New features

  * **Incentive estimate endpoint.** Preview the value of incentives that would apply to a profile before issuing them. See [Incentives overview](/concepts/incentives/overview).
  * **Expanded auditing.** The audit surface now captures a more complete history of profile changes. See [Audit](/api-reference/audit).
  * **Automated achievements.** Configure [achievements](/concepts/incentives/achievements) to be awarded automatically as part of daily automations.
</Update>

<Update label="v14.3.3" description="Released 3 February 2026" tags={["Profiles", "Commerce", "Automation"]}>
  ### New features

  * **Bulk tag management.** Add or remove [profile tags](/api-reference/profile-tag) on many profiles in a single API call. See [Tags and statuses](/concepts/profiles/tags-and-statuses).
  * **Returns tracking.** Flag individual [transaction items](/api-reference/transaction-item) as returns and run a daily automation that aggregates total return value per profile. See [Transactions](/concepts/commerce/transactions) and [Return strategy](/api-reference/return-strategy).
  * **Tier and point definition events.** New events fire when a [tier definition](/api-reference/tier-definition) or [point definition](/api-reference/point-definition) is created or updated, enabling more automation workflows.

  ### Improvements

  * **Flexible location identifiers when issuing credits.** [Credit](/api-reference/credit) endpoints accept either `external_id` or `code` to identify a [location](/concepts/commerce/locations).
  * **Return values represented as negative amounts.** Returns are accounted for consistently in transaction totals.
</Update>

<Update label="v14.3.2" description="Released 22 January 2026" tags={["Profiles", "Automation"]}>
  ### New features

  * **Separate email and SMS consent preferences.** Manage email and SMS opt-in independently. See [Comms preferences](/concepts/profiles/comms-preferences).

  ### Improvements

  * **Filter profiles by credit and custom attribute data.** Richer expressions are accepted on the [Profile](/api-reference/profile) browse endpoint.
  * **Date searching on custom dates.** More flexible date queries against [profile date attributes](/api-reference/profile-dates-attribute).
</Update>

<Update label="v14.3.1" description="Released 21 January 2026" tags={["Profiles", "Incentives"]}>
  ### New features

  * **Streamlined create-connection action.** A single action creates a [connection](/concepts/profiles/connections) between two profiles, replacing a multi-step flow.

  ### Improvements

  * **Currency and region on incentives.** Incentives can carry currency and region context for cleaner multi-market campaigns. See [Incentives overview](/concepts/incentives/overview).
</Update>

<Update label="v14.3.0" description="Released 14 January 2026" tags={["Incentives"]}>
  ### New features

  * **`accrued_at` timestamp on points.** Each [point](/concepts/incentives/points) and tier point now carries the exact accrual datetime, giving precise tracking of loyalty activity. See [Profile point](/api-reference/profile-point).
  * **Point redemption ignores future-dated points.** Points with an `issued_at` in the future are excluded from redemption calculations until they activate.
</Update>

<Update label="v14.2.3" description="Released 11 January 2026" tags={["Profiles"]}>
  ### New features

  * **Referral tracking.** A profile now exposes the total number of customers it has referred. Referrals are modelled on [connections](/concepts/profiles/connections).
</Update>

<Update label="v14.2.2" description="Released 4 January 2026" tags={["Automation"]}>
  ### New features

  * **Compare date fields against each other.** [Automation queries](/api-reference/automation-query) now support cross-field date comparisons, enabling rules like "last purchase older than last visit".
</Update>

<Update label="v14.2.1" description="Released 31 December 2025" tags={["Credits", "Profiles", "Automation"]}>
  ### New features

  * **Issue credits to a profile.** Create [credits](/concepts/commerce/credits) directly against a profile. See [Credit](/api-reference/credit).
  * **Share a status.** Share a profile's status for collaboration across staff. See [Share](/api-reference/share) and [Statuses](/concepts/profiles/tags-and-statuses).
  * **Delete a specific profile identity.** Remove a single [identity](/concepts/profiles/identities) from a profile without affecting the rest.

  ### Improvements

  * **More expressive automation rules.** The rules engine now supports a wider set of expressions for [Reactions](/concepts/automation/reactions).
</Update>

<Update label="v14.2.0" description="Released 18 December 2025" tags={["Lists", "Incentives", "Commerce"]}>
  ### New features

  * **Sharing and incentives.** A new system for sharing items between profiles and claiming incentives off the back of a share. See [Product list share](/api-reference/product-list-share) and [Lists overview](/concepts/lists/overview).
  * **Location-based redemption.** Rewards can be redeemed at specific [locations](/concepts/commerce/locations). See [Redemption](/api-reference/redemption).

  ### Improvements

  * **Tier change history on profiles.** Tier transitions are recorded against the profile, so you can reconstruct a status journey. See [Tiers](/concepts/incentives/tiers).
  * **Better interaction tracking.** More interaction signals are persisted against the profile. See [Interactions](/api-reference/interaction).
  * **Reference linking on transactions.** [Transactions](/concepts/commerce/transactions) can carry references to related transactions for improved history and tracking.
</Update>

<Update label="v14.1.0" description="Released 2 December 2025" tags={["Credits", "Commerce", "Audit"]}>
  ### New features

  * **Distinguish imported vs system-generated credits.** [Credit](/api-reference/credit) records carry a source marker so you can separate platform-issued credits from migrated balances.
  * **`claimed` status on transactions.** [Transactions](/concepts/commerce/transactions) now expose a `claimed` status, giving clearer insight into the claim lifecycle.
  * **Status group tracking in audits.** [Audit](/api-reference/audit) entries now record status group changes alongside the underlying status change.
</Update>

<Update label="v14.0.10" description="Released 25 November 2025" tags={["Automation", "Commerce", "Incentives"]}>
  ### New features

  * **Custom transaction events.** Define custom events tied to a transaction context, useful for triggering bespoke loyalty logic. See [Reactions](/concepts/automation/reactions) and [Tier point](/api-reference/tier-point).

  ### Improvements

  * **Connection context includes custom attributes.** The connection event payload now carries the connector's and connected profile's [custom attributes](/concepts/profiles/custom-attributes). See [Connections](/concepts/profiles/connections).
  * **Tier points in transaction responses.** The [Transaction](/api-reference/transaction) response now includes tier point allocations resulting from that transaction.
</Update>

<Update label="v14.0.9" description="Released 24 November 2025" tags={["Profiles", "Incentives"]}>
  ### New features

  * **More granular custom data deletion.** New options for deleting custom data on a profile. See [Deletions, purges, and depersonalisations](/concepts/profiles/deletions-purges-depersonalisations).
  * **Redemption updates the benefit definition counter.** When a [redemption item](/api-reference/redemption-item) is created against a benefit, the parent [benefit definition's](/api-reference/benefit-definition) total redemption count updates automatically.

  ### Improvements

  * **Benefit expiry in days.** [Benefit definitions](/api-reference/benefit-definition) accept an expiry expressed as a number of days from issue.
  * **Profile updates synced across regions.** Cross-region profile updates land more reliably. See [Profile region](/api-reference/profile-region).
</Update>

<Update label="v14.0.8" description="Released 18 November 2025" tags={["Credits", "Profiles", "Batch", "Incentives"]}>
  ### New features

  * **Profile origin tracking.** A profile now records the staff member who created it, adding accountability to manual sign-ups. See [Staff](/api-reference/staff).

  ### Improvements

  * **Credit descriptive attributes.** [Credits](/concepts/commerce/credits) now carry additional descriptive metadata for clearer reporting.
  * **Batch profile processing.** Improved throughput when working with large batches of profiles, plus more intuitive status sorting. See [Batch](/api-reference/batch).
  * **Searchable benefit definitions.** [Benefit definitions](/api-reference/benefit-definition) are now searchable by name and key fields.
</Update>

<Update label="v14.0.7" description="Released 17 November 2025" tags={["Imports", "Batch", "Automation", "Credits"]}>
  ### New features

  * **File upload for imports.** Submit an [import](/api-reference/import) by uploading a file directly, in addition to the existing JSON payload pattern.
  * **Batch import job processing.** A new endpoint processes import jobs in batches for faster large-scale ingestion. See [Batch](/api-reference/batch).

  ### Improvements

  * **More expressive automation arguments.** [Automations](/api-reference/automation) accept a richer argument shape for greater control inside scheduled flows.
  * **Updated credit search response.** [Credit](/api-reference/credit) search responses use a refined shape for cleaner integration.
</Update>

<Update label="v14.0.6" description="Released 7 November 2025" tags={["Automation", "Lists", "Profiles"]}>
  ### New features

  * **New automation query type.** [Automation queries](/api-reference/automation-query) can now run against model contexts other than profile, opening up new automation patterns.
  * **Auto-expire reservations.** A new daily automation clears expired [product list reservations](/api-reference/product-list-reservations).

  ### Improvements

  * **Profile status update events.** Profile status changes driven by a [Reaction](/concepts/automation/reactions) now surface in the profile update event. See [Statuses](/concepts/profiles/tags-and-statuses).
</Update>

<Update label="v14.0.5" description="Released 5 November 2025" tags={["Credits", "Incentives", "Webhooks"]}>
  ### New features

  * **Edit the profile on a credit.** Reassign a [credit](/concepts/commerce/credits) to a different profile for administrative correction. See [Credit](/api-reference/credit).
  * **Update rewards by re-uploading an import file.** Modify existing [rewards](/api-reference/reward) by submitting an updated [import](/api-reference/import).

  ### Improvements

  * **Wider date format recognition.** Date validation accepts a broader set of input formats, reducing import errors.
  * **System-generated profile updates do not trigger webhooks.** Integrations only see [webhook](/concepts/automation/webhooks) events for genuine customer or staff activity, not internal platform updates.
</Update>

<Update label="v14.0.4" description="Released 28 October 2025" tags={["Configuration"]}>
  ### New features

  * **Saved search filters.** Save a frequently used filter set and reuse it. See [Saved filter](/api-reference/saved-filter).
</Update>

<Update label="v14.0.3" description="Released 21 October 2025" tags={["Incentives", "Commerce"]}>
  ### New features

  * **Spend limits on point accrual.** Cap the amount of spend that contributes toward earning points. See [Point definition](/api-reference/point-definition) and [Points](/concepts/incentives/points).
  * **View redeemable benefits.** A new endpoint surfaces all currently redeemable benefits for a profile. See [Profile benefit](/api-reference/profile-benefit).
  * **Custom handles for locations.** Identify [locations](/concepts/commerce/locations) using custom handles in API requests.
</Update>

<Update label="v14.0.2" description="Released 16 October 2025" tags={["Lists", "Automation"]}>
  ### New features

  * **Custom fields on product list items.** Attach custom fields to [product list items](/api-reference/product-list-item), with a reusable reference rule that resolves products from `namespace:handle:value`.
  * **New trigger events.** Reward definition, country, and list definition lifecycle events are now available as [triggers](/api-reference/trigger).
  * **Product list deletion events.** Product list and list item deletions now emit dedicated events.
</Update>

<Update label="v14.0.0" description="Released 15 October 2025" tags={["Profiles", "Connections"]}>
  ### New features

  * **Profile staff linking.** Profile create and update endpoints now accept `preferred_staff_id` and `joined_staff_id`, so you can attach preferred and onboarding staff in a single request. Identify the staff member with either a staff profile UUID or an `identityHandle:identifier` pair. See [Staff](/api-reference/staff) and [Connections](/concepts/profiles/connections).
  * **Staff metadata in responses.** API responses and domain events return detailed staff metadata (name, email, identities) so downstream systems stay informed.
  * **Automatic preferred staff and joined staff connections.** The profile observer creates, updates, and removes the **Preferred Staff** and **Joined Staff** connection records automatically whenever those attributes change.
  * **Default staff connection definition.** A baseline `staff` [connection definition](/concepts/profiles/connections) ships with every environment.
</Update>