SIP Call-Info Parameters for Labeling Calls

In many countries, an increasing number of calls are unwanted , as they might be fraudulent, illegal telemarketing or the receiving party does not want to be disturbed by, say, surveys or solicitation by charities. Currently, called parties have to rely exclusively on the caller's number or, if provided, caller name, but unwanted callers may not provide their true name or use a name that misleads, e.g., "Cardholder Services". On the other hand, many calls from unknown numbers may be important to the called party, whether this is an emergency alert from their emergency management office or a reminder about a doctor's appointment. Since many subscribers now reject all calls from unknown numbers, such calls may also be inadvertently be left unanswered. Users may also install smartphone apps that can benefit from additional information in making decisions as to whether to ring, reject or redirect a call. This document describes a new set of optional parameters and usage for the SIP Call-Info header field, purpose "info" [TBD: re-use or define new purpose?], for labeling the nature of the call. The header field may be inserted by the call originator, an intermediate proxy or B2BUA or the terminating carrier, based on assertions by the caller, number-indexed databases, call analytics or other sources of information. The SIP provider serving the called party MUST remove any parameters enumerated in this specification that it does not trust. The Call-Info header field MAY be signed using a future "ppt" extension to . To ensure that an untrusted originating caller does not mislead the called party, a new feature tag, sip.call-info.spam, indicates whether the terminating carrier will remove untrusted information. SIP entities MUST add a new Call-Info header field, rather than add parameters to an existing one. There MAY be several Call-Info header fields in one request. As defined in , the Call-Info header field contains a URI that can provide additional information about the caller or call. For example, many call filtering services provide a web page with crowd-sourced information about the calling number. If the entity inserting the header field does not have information it wants to link to, it MUST use an empty data URL as a placeholder, as in data:. (The Call-Info header field syntax makes the URI itself mandatory.) Providers may also find the SIP Priority header (Section 20.26) field useful in helping called parties decide how to respond to an incoming call.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14, RFC 2119 .

All of the parameters listed below are optional and may appear in any combination and order. The spam parameter indicates the estimated probability that the call is unwanted by the called party, expressed as a whole-number percentage between 0 and 100, inclusive, with larger numbers indicating a higher probability. The computation of the estimate is beyond the scope of this specification. If not specified, the entity inserting the Call-Info information is making no claims about the likelihood of being unwanted. The type parameter indicates the type of the call or caller. It is drawn from an extensible set of values, with the initial set listed below. Gateways to analog phone systems MAY include the label in caller name (CNAM) information. Automated call classification systems MAY use this information as one factor in deciding how to handle the call. Calls SHOULD be labeled with types that may make it more likely that the caller will answer (e.g., for alert and health-related calls) if the entity inserting the information is confident that the calling party number is valid, e.g., because the request has been signed . The reason parameter provides free-text information about the source of the type or spam parameter and is meant to be used for debugging, rather than for display to the end user. For example, it may indicate the name of an external information source, such as a list of known emergency alerters. The source parameter identifies the entity, by host name, domain or IP address, that inserted the parameters above. It uses the "host" ABNF syntax. The following initial set of types are defined. The call types are generally based on the caller's telephone number or possibly an assertion by a trusted caller, as the content cannot be not known. The definitions are meant to be informal and reflect the common understanding of subscribers who are not lawyers. Other strings may be used; there does not appear to be a need for defining vendor-defined strings as the likelihood of confusion between a service-provider-specific usage and a later extension to the list appears low. Additional labels are registered with IANA. Calls placed by businesses, i.e., an entity or enterprise entered into for profit. This type is used if no other, more precise, category fits. Calls related to collecting of debt owed or alleged to be owed by the called party. Calls that provide the recipient information regarding an emergency. The call is considered to be fraudulent. A call placed by a government entity, if no more specific label such as "health" or "debt-collection" is known or applies. Informational calls by health plans, health care clearinghouses or health care provider, where health care means care, services, or supplies related to the health of an individual. Calls intended to convey information to the called party about a transaction such as package delivery, appointment reminder, order confirmation. This call type is only used if the calling party believes to have an established business relationship with the called party. A call placed by a not-for-profit organization, including for soliciting donations or providing information. A non-business, person-to-person, call, e.g., from a residential line or personal mobile number. Calls related to elections or other political purposes. Calls that provide the recipient information regarding public services, e.g., school closings. A call that is likely unwanted, if not otherwise classified. The calling number for this call has been spoofed. A call that solicits the opinions or data of the called party. Calls placed in order to induce the purchase of a product or service to the called party. The call is being placed by a trusted entity and falls outside the other categories listed. This may include call backs, e.g., from a conferencing service, or messages from telecommunication carriers and utilities.

Call-Info: <http://wwww.example.com/5974c8d942f120351143> ;source=carrier.example.com ;purpose=info ;spam=85 ;type=fraud ;reason="FTC list"

This document defines the 'spam', 'type', 'reason' and 'source' parameters in the Call-Info header in the "Header Field Parameters and Parameter Values" registry defined by . Header Field Parameter Name Predefined Values Reference Call-Info reason No [this RFC] Call-Info source No [this RFC] Call-Info spam No [this RFC] Call-Info type Yes [this RFC]

This document defines the feature capability sip.call-info.spam in the "Global Feature-Capability Indicator Registration Tree" registry defined in . sip.call-info.spam This feature-capability indicator when used in a REGISTER response indicates that the server will add, inspect, alter and possibly remove the Call-Info header field parameters defined in the reference. [this RFC]

The security considerations in (Section 20.9) apply. A user agent MUST ignore the parameters defined in this document unless the SIP REGISTER response contained the sip.call-info.spam feature capability. SIP entities MUST remove any parameters defined here that were provided by untrusted third parties.

Jim Calme and other members of the Robocall Strikeforce provided helpful comments.