pjsip show contacts

Since N/A CLI Commands Found this useful? Upvote it. ×

List [[term:pjsip]] contacts, contact URIs, reachability status, and qualify round trip time.

Last reviewed 2026-08-22

pjsip show contacts
Description

pjsip show contacts lists known PJSIP contacts. Contacts are the actual SIPSession Initiation Protocol, the standard signaling protocol used to set up, manage, and tear down VoIP calls between Asterisk and phones or carriers. URIs Asterisk can use to reach an endpointIn PJSIP configuration, the SIP entity Asterisk communicates with: a phone, trunk, or other user agent. Defined by an endpoint section in pjsip.conf., either learned from endpoint registration or configured statically on an AoR.

The output is useful when an endpoint appears in pjsip show endpoints but calls do not reach the phone, OPTIONS qualify shows an unexpected state, or NAT rewriting results in an unroutable contact URI.

Contact status commonly shows values such as Avail, Unavail, Unknown, or NonQual. Round trip time appears when qualify is enabled and a recent qualify result is available.

Example:

asterisk -rx "pjsip show contacts"

Use this with pjsip show aors to map a contact back to the AoR and endpoint that owns it.

User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.

Moderated before publishing. Email never shown.

Related

pjsip show aors

List PJSIP Address of Record objects and their contact limits.

CLI Commands pjsip troubleshooting cli
pjsip show registration

Show details for one outbound PJSIP registration object.

CLI Commands pjsip troubleshooting cli
pjsip show registrations

List outbound PJSIP registrations and their current registration status.

CLI Commands pjsip troubleshooting cli
Managing PJSIP Outbound Registrations from the Asterisk CLI

Use pjsip send unregister safely with Asterisk outbound registrations. Covers syntax, endpoint and AOR scope, expected o...

Getting Started pjsip troubleshooting cli
pjsip show endpoints

List PJSIP endpoints, state, contacts, transports, identify matches, and active channels.

CLI Commands pjsip troubleshooting cli
CLI Commands
! CLI Commands Quick Reference _command matchesarray acl show aeap show client aeap show clients ael reload ael set debug {read|tokens|contexts|off} agent logoff agent show agent show all agent show online agi dump html agi exec agi set debug [on|off] agi show commands [topic] aoc set debug ari mkpasswd ari set debug ari show app ari show apps ari show outbound-websocket ari show outbound-websockets ari show status ari show user ari show users ari show websocket sessions ari shutdown websocket session ari shutdown websocket sessions ari start outbound-websocket astobj2 container check astobj2 container dump astobj2 container stats astobj2 show stats astobj2 test bridge destroy bridge kick bridge show bridge show all bridge technology show bridge technology {suspend|unsuspend} calendar dump sched calendar show calendar calendar show calendars calendar show types cc cancel [core|all] cc report status cdr set debug [on|off] cdr show active cdr show pgsql status cdr show status cdr submit cel show status channel dump frames channel originate channel redirect channel request hangup cli check permissions cli reload permissions cli show aliases cli show permissions confbridge kick confbridge list confbridge lock confbridge mute confbridge record start confbridge record stop confbridge show menu confbridge show menus confbridge show profile bridge confbridge show profile bridges confbridge show profile user confbridge show profile users confbridge unlock confbridge unmute config list config reload config show help console answer console dial console flash console hangup console list available console list devices console send text console {mute|unmute} console {set|show} active console {set|show} autoanswer [on|off] core abort shutdown core clear profile core eat memory core ping taskprocessor core reload core reset taskprocessor core reset taskprocessors core restart gracefully core restart now core restart when convenient core set debug core set debug category core set debug channel core set trace core set verbose core show application core show applications [like|describing] core show calls [uptime] core show channel core show channels [concise|verbose|count] core show channeltype core show channeltypes core show codec core show codecs [audio|video|image|text] core show config mappings core show device2extenstate core show fd core show file formats core show function core show functions [like] core show hanguphandlers core show hanguphandlers all core show help core show hint core show hints core show image formats core show license core show locks core show profile core show settings core show sound core show sounds core show switches core show sysinfo core show taskprocessor alerted subsystems core show taskprocessor name core show taskprocessors [like] core show threads core show translation core show uptime [seconds] core show version core show warranty core stop gracefully core stop now core stop when convenient core waitfullybooted corosync ping corosync show config corosync show members dahdi create channels dahdi destroy channels dahdi restart dahdi set dnd dahdi set hwgain {rx|tx} dahdi set mwi dahdi set swgain {rx|tx} dahdi show cadences dahdi show channel dahdi show channels [group|context] dahdi show status dahdi show version database del database deltree database get database put database query database show database showkey devstate change devstate list dialplan add extension dialplan add ignorepat dialplan add include dialplan debug dialplan eval function dialplan exec application dialplan locks show dialplan reload dialplan remove context dialplan remove extension dialplan remove ignorepat dialplan remove include dialplan save dialplan set chanvar dialplan set extenpatternmatchnew false dialplan set extenpatternmatchnew true dialplan set global dialplan show dialplan show chanvar dialplan show globals dnsmgr refresh dnsmgr reload dnsmgr status dundi flush [stats] dundi lookup dundi precache dundi query dundi set debug {on|off} dundi show cache dundi show entityid dundi show hints dundi show mappings dundi show peer dundi show peers [registered|include|exclude|begin] dundi show precache dundi show requests dundi show trans dundi store history {on|off} fax set debug {on|off} fax show capabilities fax show session fax show sessions fax show settings fax show stats fax show version features show file convert geoloc list locations geoloc list profiles geoloc reload geoloc show gml_shape_defs geoloc show profiles group show channels http show status iax2 provision iax2 prune realtime iax2 reload iax2 set debug jb {on|off} iax2 set debug trunk {on|off} iax2 set debug {on|off|peer} iax2 set mtu iax2 show cache iax2 show callnumber usage iax2 show channels iax2 show firmware iax2 show netstats iax2 show peer iax2 show peers iax2 show provisioning iax2 show registry iax2 show stats iax2 show threads iax2 show users [like] iax2 test jitter iax2 test late iax2 test losspct iax2 test resync iax2 unregister indication add indication remove indication show keys init keys show local show channels logger add channel logger filter changroup logger filter reset logger filter show logger mute logger reload logger remove channel logger rotate logger set level {DEBUG|TRACE|NOTICE|WARNING|ERROR|VERBOSE|DTMF} {on|off} logger show channels logger show levels malloc trim manager kick session manager reload manager set debug [on|off] manager show command manager show commands manager show connected manager show event manager show eventq manager show events manager show settings manager show user manager show users media cache create media cache delete media cache refresh media cache show media cache show all meetme kick meetme list meetme {lock|unlock} meetme {mute|unmute} memory atexit list {on|off} memory atexit summary {off|byline|byfunc|byfile} memory backtrace {on|off} memory show allocations memory show summary mfcr2 call files [on|off] mfcr2 destroy link mfcr2 set blocked mfcr2 set debug mfcr2 set idle mfcr2 show channels [group|context] mfcr2 show links mfcr2 show variants mfcr2 show version minivm list accounts [for] minivm list templates minivm list zones minivm reload minivm show settings minivm show stats mixmonitor {start|stop|list} mobile cusd mobile rfcomm mobile search mobile show devices module load module refresh module reload module show [like] module unload moh reload moh show classes moh show files moh unregister class mwi delete all mwi delete like mwi delete mailbox mwi list all mwi list like mwi show mailbox mwi update mailbox odbc read odbc show odbc write ooh323 reload ooh323 set debug [off] ooh323 show config ooh323 show gk ooh323 show peer ooh323 show peers ooh323 show user ooh323 show users parking show phoneprov show routes pjproject set log level {default|0|1|2|3|4|5|6} pjproject show buildopts pjproject show log level pjproject show log mappings pjsip dump endpt [details] pjsip export config_wizard primitives [to] pjsip list ciphers pjsip list subscriptions {inbound|outbound} [like] pjsip qualify pjsip reload qualify aor pjsip reload qualify endpoint pjsip send notify pjsip send register pjsip send unregister pjsip set history {on|off|clear} pjsip set logger {on|off|host|add|method|methodadd|verbose|pcap} pjsip show aors pjsip show contacts pjsip show endpoints pjsip show history pjsip show identifiers pjsip show qualify aor pjsip show qualify endpoint pjsip show registration pjsip show registrations pjsip show scheduled_tasks pjsip show settings pjsip show subscription {inbound|outbound} pjsip show subscriptions {inbound|outbound} [like] pjsip show transport-monitors pjsip show version presencestate change presencestate list pri destroy span pri service disable channel pri service enable channel pri set debug file pri set debug {on|off|hex|intense|0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15} span pri show channels pri show debug pri show span pri show spans pri show version prometheus show metrics prometheus show status queue add member queue priority caller queue reload {parameters|members|rules|all} queue remove member queue reset stats queue set penalty queue set ringinuse queue show queue show rules queue {pause|unpause} member realtime destroy realtime load realtime mysql cache realtime mysql status realtime show ldap status realtime show pgsql cache realtime show pgsql status realtime store realtime update realtime update2 remb set {send|receive} rtcp set debug {on|off|ip} rtcp set stats {on|off} rtp drop rtp set debug {on|off|ip} rtp show settings say load [new|old] skel show config skel show games skel show levels sla show stations sla show trunks sorcery memory cache dump sorcery memory cache expire sorcery memory cache populate sorcery memory cache show sorcery memory cache stale sorcery show settings ss7 mtp3 ss7 reset cic ss7 reset group ss7 restart mtp3 ss7 set debug {on|off} linkset ss7 show calls ss7 show channels ss7 show cics ss7 show linkset ss7 show version ss7 {block|unblock} cic ss7 {block|unblock} group ss7 {reset|block|unblock} linkset stasis show topic stasis show topics stasis statistics show messages stasis statistics show subscription stasis statistics show subscriptions stasis statistics show topic stasis statistics show topics stir_shaken show attestation stir_shaken show eprofile stir_shaken show eprofiles stir_shaken show profile stir_shaken show profiles stir_shaken show tn stir_shaken show tns stir_shaken show verification stir_shaken verify certificate_file stun set debug {on|off} stun show status test execute test generate results test show registered test show results threadstorage show allocations threadstorage show summary timing test transcoder show udptl set debug {on|off|ip} udptl show config ulimit unistim reload unistim send packet unistim set debug {on|off} unistim show devices unistim show info voicemail forward voicemail move voicemail reload voicemail remove voicemail show aliases voicemail show mailbox voicemail show users [for] voicemail show zones xmldoc dump xmldoc reload xmpp create collection xmpp create leaf xmpp delete node xmpp list nodes xmpp purge nodes xmpp set debug {on|off} xmpp show buddies xmpp show connections
CLI Commands
! CLI Commands Quick Reference _command matchesarray acl show aeap show client aeap show clients ael reload ael set debug {read|tokens|contexts|off} agent logoff agent show agent show all agent show online agi dump html agi exec agi set debug [on|off] agi show commands [topic] aoc set debug ari mkpasswd ari set debug ari show app ari show apps ari show outbound-websocket ari show outbound-websockets ari show status ari show user ari show users ari show websocket sessions ari shutdown websocket session ari shutdown websocket sessions ari start outbound-websocket astobj2 container check astobj2 container dump astobj2 container stats astobj2 show stats astobj2 test bridge destroy bridge kick bridge show bridge show all bridge technology show bridge technology {suspend|unsuspend} calendar dump sched calendar show calendar calendar show calendars calendar show types cc cancel [core|all] cc report status cdr set debug [on|off] cdr show active cdr show pgsql status cdr show status cdr submit cel show status channel dump frames channel originate channel redirect channel request hangup cli check permissions cli reload permissions cli show aliases cli show permissions confbridge kick confbridge list confbridge lock confbridge mute confbridge record start confbridge record stop confbridge show menu confbridge show menus confbridge show profile bridge confbridge show profile bridges confbridge show profile user confbridge show profile users confbridge unlock confbridge unmute config list config reload config show help console answer console dial console flash console hangup console list available console list devices console send text console {mute|unmute} console {set|show} active console {set|show} autoanswer [on|off] core abort shutdown core clear profile core eat memory core ping taskprocessor core reload core reset taskprocessor core reset taskprocessors core restart gracefully core restart now core restart when convenient core set debug core set debug category core set debug channel core set trace core set verbose core show application core show applications [like|describing] core show calls [uptime] core show channel core show channels [concise|verbose|count] core show channeltype core show channeltypes core show codec core show codecs [audio|video|image|text] core show config mappings core show device2extenstate core show fd core show file formats core show function core show functions [like] core show hanguphandlers core show hanguphandlers all core show help core show hint core show hints core show image formats core show license core show locks core show profile core show settings core show sound core show sounds core show switches core show sysinfo core show taskprocessor alerted subsystems core show taskprocessor name core show taskprocessors [like] core show threads core show translation core show uptime [seconds] core show version core show warranty core stop gracefully core stop now core stop when convenient core waitfullybooted corosync ping corosync show config corosync show members dahdi create channels dahdi destroy channels dahdi restart dahdi set dnd dahdi set hwgain {rx|tx} dahdi set mwi dahdi set swgain {rx|tx} dahdi show cadences dahdi show channel dahdi show channels [group|context] dahdi show status dahdi show version database del database deltree database get database put database query database show database showkey devstate change devstate list dialplan add extension dialplan add ignorepat dialplan add include dialplan debug dialplan eval function dialplan exec application dialplan locks show dialplan reload dialplan remove context dialplan remove extension dialplan remove ignorepat dialplan remove include dialplan save dialplan set chanvar dialplan set extenpatternmatchnew false dialplan set extenpatternmatchnew true dialplan set global dialplan show dialplan show chanvar dialplan show globals dnsmgr refresh dnsmgr reload dnsmgr status dundi flush [stats] dundi lookup dundi precache dundi query dundi set debug {on|off} dundi show cache dundi show entityid dundi show hints dundi show mappings dundi show peer dundi show peers [registered|include|exclude|begin] dundi show precache dundi show requests dundi show trans dundi store history {on|off} fax set debug {on|off} fax show capabilities fax show session fax show sessions fax show settings fax show stats fax show version features show file convert geoloc list locations geoloc list profiles geoloc reload geoloc show gml_shape_defs geoloc show profiles group show channels http show status iax2 provision iax2 prune realtime iax2 reload iax2 set debug jb {on|off} iax2 set debug trunk {on|off} iax2 set debug {on|off|peer} iax2 set mtu iax2 show cache iax2 show callnumber usage iax2 show channels iax2 show firmware iax2 show netstats iax2 show peer iax2 show peers iax2 show provisioning iax2 show registry iax2 show stats iax2 show threads iax2 show users [like] iax2 test jitter iax2 test late iax2 test losspct iax2 test resync iax2 unregister indication add indication remove indication show keys init keys show local show channels logger add channel logger filter changroup logger filter reset logger filter show logger mute logger reload logger remove channel logger rotate logger set level {DEBUG|TRACE|NOTICE|WARNING|ERROR|VERBOSE|DTMF} {on|off} logger show channels logger show levels malloc trim manager kick session manager reload manager set debug [on|off] manager show command manager show commands manager show connected manager show event manager show eventq manager show events manager show settings manager show user manager show users media cache create media cache delete media cache refresh media cache show media cache show all meetme kick meetme list meetme {lock|unlock} meetme {mute|unmute} memory atexit list {on|off} memory atexit summary {off|byline|byfunc|byfile} memory backtrace {on|off} memory show allocations memory show summary mfcr2 call files [on|off] mfcr2 destroy link mfcr2 set blocked mfcr2 set debug mfcr2 set idle mfcr2 show channels [group|context] mfcr2 show links mfcr2 show variants mfcr2 show version minivm list accounts [for] minivm list templates minivm list zones minivm reload minivm show settings minivm show stats mixmonitor {start|stop|list} mobile cusd mobile rfcomm mobile search mobile show devices module load module refresh module reload module show [like] module unload moh reload moh show classes moh show files moh unregister class mwi delete all mwi delete like mwi delete mailbox mwi list all mwi list like mwi show mailbox mwi update mailbox odbc read odbc show odbc write ooh323 reload ooh323 set debug [off] ooh323 show config ooh323 show gk ooh323 show peer ooh323 show peers ooh323 show user ooh323 show users parking show phoneprov show routes pjproject set log level {default|0|1|2|3|4|5|6} pjproject show buildopts pjproject show log level pjproject show log mappings pjsip dump endpt [details] pjsip export config_wizard primitives [to] pjsip list ciphers pjsip list subscriptions {inbound|outbound} [like] pjsip qualify pjsip reload qualify aor pjsip reload qualify endpoint pjsip send notify pjsip send register pjsip send unregister pjsip set history {on|off|clear} pjsip set logger {on|off|host|add|method|methodadd|verbose|pcap} pjsip show aors pjsip show contacts pjsip show endpoints pjsip show history pjsip show identifiers pjsip show qualify aor pjsip show qualify endpoint pjsip show registration pjsip show registrations pjsip show scheduled_tasks pjsip show settings pjsip show subscription {inbound|outbound} pjsip show subscriptions {inbound|outbound} [like] pjsip show transport-monitors pjsip show version presencestate change presencestate list pri destroy span pri service disable channel pri service enable channel pri set debug file pri set debug {on|off|hex|intense|0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15} span pri show channels pri show debug pri show span pri show spans pri show version prometheus show metrics prometheus show status queue add member queue priority caller queue reload {parameters|members|rules|all} queue remove member queue reset stats queue set penalty queue set ringinuse queue show queue show rules queue {pause|unpause} member realtime destroy realtime load realtime mysql cache realtime mysql status realtime show ldap status realtime show pgsql cache realtime show pgsql status realtime store realtime update realtime update2 remb set {send|receive} rtcp set debug {on|off|ip} rtcp set stats {on|off} rtp drop rtp set debug {on|off|ip} rtp show settings say load [new|old] skel show config skel show games skel show levels sla show stations sla show trunks sorcery memory cache dump sorcery memory cache expire sorcery memory cache populate sorcery memory cache show sorcery memory cache stale sorcery show settings ss7 mtp3 ss7 reset cic ss7 reset group ss7 restart mtp3 ss7 set debug {on|off} linkset ss7 show calls ss7 show channels ss7 show cics ss7 show linkset ss7 show version ss7 {block|unblock} cic ss7 {block|unblock} group ss7 {reset|block|unblock} linkset stasis show topic stasis show topics stasis statistics show messages stasis statistics show subscription stasis statistics show subscriptions stasis statistics show topic stasis statistics show topics stir_shaken show attestation stir_shaken show eprofile stir_shaken show eprofiles stir_shaken show profile stir_shaken show profiles stir_shaken show tn stir_shaken show tns stir_shaken show verification stir_shaken verify certificate_file stun set debug {on|off} stun show status test execute test generate results test show registered test show results threadstorage show allocations threadstorage show summary timing test transcoder show udptl set debug {on|off|ip} udptl show config ulimit unistim reload unistim send packet unistim set debug {on|off} unistim show devices unistim show info voicemail forward voicemail move voicemail reload voicemail remove voicemail show aliases voicemail show mailbox voicemail show users [for] voicemail show zones xmldoc dump xmldoc reload xmpp create collection xmpp create leaf xmpp delete node xmpp list nodes xmpp purge nodes xmpp set debug {on|off} xmpp show buddies xmpp show connections