Property Names

  • Have parameters / properties in lower case with underscores.
  • Have identifiers following the format: type_id. (message_id, recording_id, etc)
  • Use distinguishers only when the name is non-intuitive or conflicts with another name. (count instead of message_count because message should be intuitive, but carrier_network if there’s also a roaming network)
  • Reuse parameter / property names. (from instead of msisdn)


  • machine_detection
  • call_id
  • balance_transfer_id
  • received_at

Why did we choose this?

Pre-existing standard