EnterSignalGuide

Fact Entities

An entity represents a fact from a consumer enterprise. It could be a hotel listing, the return policy of an item, a credit card promotion, etc..

Fact Entities are mutable. A hotel listing’s availability could change, a promotion could end, the return policy could be amended, etc..

You will learn more about entities and how it is represented in EnterSignal in the next section.

Example Entities

An Amex offer

{
  "updated_at": "1702342000",
  "schema_uri": "/v1/schemas/amex/financial_product/v1.json",
  "entity_id": "ent_4X7TZ9V9QF1WQ9QF1WQ"
  "entity_payload": {
    "title": "American Express Platinum Offer",
    "description": "Airport‑lounge access and 5× points on travel.",
    "annualPercentageRate": {
      "minValue": 20.99,
      "maxValue": 27.99,
      "unitCode": "APR"
    },
    "annualFee": 695,
    "signUpBonus": "100 000 Membership Rewards® points after $6 000 spend in 6 months",
    "applicationURL": "https://americanexpress.com/apply/plat",
    "compliance": {
      "offerValidThrough": "2025-09-30",
      "cfpbDisclosureID": "US‑CFPB‑2025‑07‑PLAT"
    }
  }
}

An Airbnb Listing

{
  "updated_at": "1702342000",
  "schema_uri": "/v1/schemas/default/hotel_listing/v1.json",
  "entity_id": "ent_4X7TZ9V9QF1WQ9QF1WQ"
  "entity_payload": {
    "title": "Queen Room in Mendocino",
    "description": "Charming Victorian queen room with ocean view in Mendocino with free breakfast.",
    "availability": ["..."], // list of intervals
    "location": { "country": "US", "state": "CA", "..." }
    // ....
  }
}