Query Entities

message EntityQueryService {
  rpc GetEntity(GetEntityRequest) GetEntityResponse;
}

message GetEntityRequest {
  string entity_id = 1;
  Timestamp ts = 2;
}

message GetEntityResponse {
  string entity_id = 1;
  Timestamp updated_at = 2;
  string schema_uri = 3;
  string payload = 4; // validated json payload
}

curl /v1/entities/ent_4X7TZ9V9QF1WQ9QF1WQ?ts=1702342340 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-jwt-token"

{
  "updated_at": "1702342000",
  "schema_uri": "https://schemas.entersignal.com/amex/financial_product/v1.json",
  "entity_id": "ent_4X7TZ9V9QF1WQ9QF1WQ"
  "entity_payload": {
    "title": "American Express Platinum Offer",
    "description": "Our best offer ever. Premium charge card with airport‑lounge access and 5× points on travel.",
    "annualPercentageRate": {
      "@type": "QuantitativeValue",
      "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"
    }
  }
}