SIP Responses - VoIP.ms Wiki

SIP Responses

From VoIP.ms Wiki

(Difference between revisions)
Jump to: navigation, search
[draft revision][quality revision]
 
(2 intermediate revisions not shown)
Line 1: Line 1:
-
SIP responses are the codes used by Session Initiation Protocol for communication. They complement the [[SIP Requests]], which are used to initiate action such as a phone conversation. Note that the Reason Phrases of the responses listed below are only the recommended examples, and can be replaced with local equivalents without affecting the protocol.
+
SIP responses are the codes used by ''Session Initiation Protocol'' for communication. They complement the [[SIP Requests]], which are used to initiate action such as a phone conversation. Note that the Reason Phrases of the responses listed below are only the recommended examples, and can be replaced with local equivalents without affecting the protocol.SIP responses are the codes used by Session Initiation Protocol for communication. They complement the SIP Requests, which are used to initiate action such as a phone conversation. Note that the Reason Phrases of the responses listed below are only the recommended examples, and can be replaced with local equivalents without affecting the protocol.
 +
=== 1xx = Informational SIP Responses ===
 +
{| class="wikitable" style="border: none;"
 +
|-
 +
! scope="col" | Code
 +
! scope="col" | Name
 +
! scope="col" | Description
 +
|-
 +
| 100 || Trying || Extended search is being performed so a forking proxy must send a 100 Trying response.
 +
|-
 +
| 180 || Ringing || The Destination User Agent has received the INVITE message and is alerting the user of call.
 +
|-
 +
| 181 || Call Is Being Forwarded || Optional, send by Server to indicate a call is being forwarded.
 +
|-
 +
| 182 || Queued || Destination was temporarily unavailable, the server has queued the call until the destination is available.
 +
|-
 +
| 183 || Session Progress || This response may be used to send extra information for a call which is still being set up.
 +
|-
 +
| 199 || Early Dialog Terminated || Send by the User Agent Server to indicate that an early dialogue has been terminated.
 +
|}
-
== Informational Responses - 1xx==
+
=== 2xx = Success Responses ===
-
* 100 Trying
+
-
extended search being performed may take a significant time so a forking proxy must send a 100                                  Trying response
+
-
* 180 Ringing
+
-
* 181 Call Is Being Forwarded
+
-
* 182 Queued
+
-
* 183 Session Progress
+
-
== Successful Responses - 2xx ==
+
{| class="wikitable" style="border: none;"
-
* 200 OK
+
|-
-
* 202 accepted: It Indicates that the request has been understood but actually can't be processed
+
! scope="col" | Code
-
* 204 No Notification [RFC5839]
+
! scope="col" | Name
 +
! scope="col" | Description
 +
|-
 +
| 200 || OK || Shows that the request was successful
 +
|-
 +
| 202 || accepted || Indicates that the request has been accepted for processing, mainly used for referrals.
 +
|-
 +
| 204 || No Notification || Indicates that the request was successful but no response will be received.
 +
|}
-
== Redirection Responses - 3xx==  
+
=== 3xx = Redirection Responses ===
-
* 300 Multiple Choices
+
-
* 301 Moved Permanently
+
-
* 302 Moved Temporarily
+
-
* 305 Use Proxy
+
-
* 380 Alternative Service
+
-
== Client Failure Responses - 4xx==
+
{| class="wikitable" style="border: none;"
-
* 400 Bad Request
+
|-
-
* 401 Unauthorized (Used only by registrars or user agents. Proxies should use proxy authorization 407)
+
! scope="col" | Code
-
* 402 Payment Required (Reserved for future use)
+
! scope="col" | Name
-
* 403 Forbidden
+
! scope="col" | Description
-
* 404 Not Found (User not found)
+
|-
-
* 405 Method Not Allowed
+
| 300 || Multiple Choices ||  The address resolved to one of several options for the user or client to choose between.
-
* 406 Not Acceptable
+
|-
-
* 407 Proxy Authentication Required
+
| 301 || Moved Permanently || The original Request URI is no longer valid, the new address is given in the Contact header.
-
* 408 Request Timeout (Couldn't find the user in time)
+
|-
-
* 409 Conflict
+
| 302 || Moved Temporarily || The client should try at the address in the Contact field.
-
* 410 Gone (The user existed once, but is not available here any more.)
+
|-
-
* 412 Conditional Request Failed
+
| 305 || Use Proxy || The Contact field details a proxy that must be used to access the requested destination.
-
* 413 Request Entity Too Large
+
|-
-
* 414 Request-URI Too Long
+
| 380 || Alternative Service || The call failed, but alternatives are detailed in the message body.
-
* 415 Unsupported Media Type
+
|}
-
* 416 Unsupported URI Scheme
+
-
* 417 Unknown Resource-Priority
+
-
* 420 Bad Extension (Bad SIP Protocol Extension used, not understood by the server)
+
-
* 421 Extension Required
+
-
* 422 Session Interval Too Small
+
-
* 423 Interval Too Brief
+
-
* 424 Bad Location Information
+
-
* 428 Use Identity Header
+
-
* 429 Provide Referrer Identity
+
-
* 433 Anonymity Disallowed
+
-
* 436 Bad Identity-Info
+
-
* 437 Unsupported Certificate
+
-
* 438 Invalid Identity Header
+
-
* 480 Temporarily Unavailable
+
-
* 481 Call/Transaction Does Not Exist
+
-
* 482 Loop Detected
+
-
* 483 Too Many Hops
+
-
* 484 Address Incomplete
+
-
* 485 Ambiguous
+
-
* 486 Busy Here
+
-
* 487 Request Terminated
+
-
* 488 Not Acceptable Here
+
-
* 489 Bad Event
+
-
* 491 Request Pending
+
-
* 493 Undecipherable (Could not decrypt S/MIME body part)
+
-
* 494 Security Agreement Required
+
-
== Server Failure Responses - 5xx ==  
+
=== 4xx = Request Failures ===
-
* 500 Server Internal Error
+
-
* 501 Not Implemented: The SIP request method is not implemented here
+
-
* 502 Bad Gateway
+
-
* 503 Service Unavailable
+
-
* 504 Server Time-out
+
-
* 505 Version Not Supported: The server does not support this version of the SIP protocol
+
-
* 513 Message Too Large
+
-
* 580 Precondition Failure
+
-
== Global Failure Responses - 6xx ==
+
{| class="wikitable" style="border: none;"
-
* 600 Busy Everywhere
+
|-
-
* 603 Decline
+
! scope="col"| Code
-
* 604 Does Not Exist Anywhere
+
! scope="col"| Name
-
* 606 Not Acceptable
+
! scope="col"| Description
 +
|-
 +
| 400 || Bad Request || The request could not be understood due to malformed syntax.
 +
|-
 +
| 401 || Unauthorized || The request requires user authentication. This response is issued by UASs and registrars.
 +
|-
 +
| 402 || Payment Required ||  (Reserved for future use).
 +
|-
 +
| 403 || Forbidden || The server understood the request but is refusing to fulfill it.
 +
|-
 +
| 404 || Not Found || The server has definitive information that the user does not exist at the (User not found).
 +
|-
 +
| 405 || Method Not Allowed || The method specified in the Request-Line is understood, but not allowed.
 +
|-
 +
| 406 || Not Acceptable || The resource is only capable of generating responses with unacceptable content.
 +
|-
 +
| 407 || Proxy Authentication Required || The request requires user authentication.
 +
|-
 +
| 408 || Request Timeout || Couldn’t find the user in time.
 +
|-
 +
| 409 || Conflict || User already registered (deprecated)
 +
|-
 +
| 410 || Gone || The user existed once but is not available here anymore.
 +
|-
 +
| 411 || Length Required || The server will not accept the request without a valid content length (deprecated).
 +
|-
 +
| 412 || Conditional Request Failed || The given precondition has not been met.
 +
|-
 +
| 413 || Request Entity Too Large || Request body too large.
 +
|-
 +
| 414 || Request URI Too Long || Server refuses to service the request, the Req-URI is longer than the server can interpret.
 +
|-
 +
| 415 || Unsupported Media Type || Request body is in a non-supported format.
 +
|-
 +
| 416 || Unsupported URI Scheme || Request-URI is unknown to the server.
 +
|-
 +
| 417 || Uknown Resource-Priority || There was a resource-priority option tag, but no Resource-Priority header.
 +
|-
 +
| 420 || Bad Extension || Bad SIP Protocol Extension used, not understood by the server.
 +
|-
 +
| 421 || Extension Required || The server needs a specific extension not listed in the Supported header.
 +
|-
 +
| 422 || Session Interval Too Small || The request contains a Session-Expires header field with a duration below the minimum.
 +
|-
 +
| 423 || Interval Too Brief || The expiration time of the resource is too short.
 +
|-
 +
| 424 || Bad Location Information || The request’s location content was malformed or otherwise unsatisfactory.
 +
|-
 +
| 428 || Use Identity Header || The server policy requires an Identity header, and one has not been provided.
 +
|-
 +
| 429 || Provide Referrer Identity || The server did not receive a valid Referred-By token on the request.
 +
|-
 +
| 430 || Flow Failed || A specific flow to a user agent has failed, although other flows may succeed.
 +
|-
 +
| 433 || Anonymity Disallowed || The request has been rejected because it was anonymous.
 +
|-
 +
| 436 || Bad Identity-Info || The request has an Identity-Info header and the  URI scheme contained cannot be de-referenced.
 +
|-
 +
| 437 || Unsupported Certificate || The server was unable to validate a certificate for the domain that signed the request.
 +
|-
 +
| 438 || Invalid Identity Header || Server obtained a valid certificate used to sign a request, was unable to verify the signature.
 +
|-
 +
| 439 || First Hop Lacks Outbound Support || The first outbound proxy doesn’t support the “outbound” feature.
 +
|-
 +
| 440 || Max-Breadth Exceeded || If a SIP proxy determined a response context had insufficient Incoming Max-Breadth to carry out a desired parallel fork, and the proxy is unwilling/unable to compensate by forking serially or sending a redirect, that proxy MUST return a 440 response. A client receiving a 440 response can infer that its request did not reach all possible destinations.
 +
|-
 +
| 469 || Bad Info Package || If a SIP UA receives an INFO request associated with an Info Package that the UA has not indicated willingness to receive, the UA MUST send a 469 response, which contains a Recv-Info header field with Info Packages for which UA is willing to receive INFO requests.
 +
|-
 +
| 470 || Consent Needed || The source of the request did not have the permission of the recipient to make such a request.
 +
|-
 +
| 480 || Temporarily Unavailable || Callee currently unavailable.
 +
|-
 +
| 481 || Call/Transaction Does Not Exist || Server received a request that does not match any dialogue or transaction.
 +
|-
 +
| 482 || Loop Detected || Server has detected a loop.
 +
|-
 +
| 483 || Too Many Hops || Max-Forwards header has reached the value ‘0’.
 +
|-
 +
| 484 || Address Incomplete || Request-URI incomplete.
 +
|-
 +
| 485 || Ambiguous || Request-URI is ambiguous.
 +
|-
 +
| 486 || Busy Here || Callee is busy.
 +
|-
 +
| 487 || Request Terminated || Request has terminated by bye or cancel.
 +
|-
 +
| 488 || Not Acceptable Here || Some aspects of the session description of the Request-URI are not acceptable.
 +
|-
 +
| 489 || Bad Event || The server did not understand an event package specified in an Event header field.
 +
|-
 +
| 491 || Request Pending || Server has some pending request from the same dialogue.
 +
|-
 +
| 493 || Undecipherable || UndecipherableRequest contains an encrypted MIME body, which recipient can not decrypt.
 +
|-
 +
| 494 || Security Agreement Required || The server has received a request that requires a negotiated security mechanism.
 +
|}
-
== Siemens 7xx-Extended Codes ==
+
=== 5xx = Server Errors ===
-
'''Attention:''' The following is a list of SIP Codes belonging to the 7xx, 8xx, 9xx classes (applicative) and used by Siemens in their Gigaset products. They are not documented by any SIP RFC and other companies and applications may override them without notice.
+
-
* 701 The called party has hung up
+
-
* 702 VoIP socket error
+
-
* 703 Connection cancelled because of timeout
+
-
* 704 Connection interrupted because of a SIP error
+
-
* 705 SIP memory error
+
-
* 706 SIP transaction memory error
+
-
* 751 Busy tone: No codec match between the calling and called party
+
-
* 810 General socket layer error.
+
-
* 811 General socket layer error: Wrong socket number
+
-
* 812 General socket layer error: Socket is not connected.
+
-
* 813 General socket layer error: Memory error
+
-
* 814 General socket layer error: Socket not available – check IP settings/connection problem/VoIP setting incorrect
+
-
* 815 General socket layer error: Illegal application on the socket interface
+
-
* 922 No DNS server known
+
{| class="wikitable" style="border: none;"
-
* 923 DNS name resolution failed
+
|-
-
* 924 Insufficient resources for DNS name resolution
+
! scope="col" | Code
-
* 925 URL error
+
! scope="col" | Name
 +
! scope="col" | Description
 +
|-
 +
| 500 || Server Internal Error || The server could not fulfill the request due to some unexpected condition.
 +
|-
 +
| 501 || Not Implemented || The SIP request method is not implemented here.
 +
|-
 +
| 502 || Bad Gateway || The server, received an invalid response from a downstream server while trying to fulfill a request.
 +
|-
 +
| 503 || Service Unavailable || The server is in maintenance or is temporarily overloaded and cannot process the request.
 +
|-
 +
| 504 || Server Time-out || The server tried to access another server while trying to process a request, no timely response.
 +
|-
 +
| 505 || Version Not Supported || The SIP protocol version in the request is not supported by the server.
 +
|-
 +
| 513 || Message Too Large || The request message length is longer than the server can process.
 +
|-
 +
| 555 || Push Notification Service Not Supported || The server does not support the push notification serviced specified in the pn-provider SIP URI parameter.
 +
|-
 +
| 580 || Precondition Failure || The server is unable or unwilling to meet some constraints specified in the offer.
 +
|}
 +
 
 +
=== 6xx = Global Failures===
 +
 
 +
{| class="wikitable" style="border: none;"
 +
|-
 +
! scope="col" | Code
 +
! scope="col" | Name
 +
! scope="col" | Description
 +
|-
 +
| 600 || Busy Everywhere || All possible destinations are busy.
 +
|-
 +
| 603 || Decline || Destination cannot/don't wish to participate in the call,  no alternative destinations.
 +
|-
 +
| 604 || Does Not Exist Anywhere || The server has authoritative information that the requested user does not exist anywhere.
 +
|-
 +
| 606 || Not Acceptable || The user’s agent was contacted successfully but some aspects of the session description were not acceptable.
 +
|-
 +
| 607 || Unwanted || The called party did not want his call from the calling party. Future attempts from the calling party are likely to be similarly rejected.
 +
|}

Latest revision as of 19:10, 24 January 2020

SIP responses are the codes used by Session Initiation Protocol for communication. They complement the SIP Requests, which are used to initiate action such as a phone conversation. Note that the Reason Phrases of the responses listed below are only the recommended examples, and can be replaced with local equivalents without affecting the protocol.SIP responses are the codes used by Session Initiation Protocol for communication. They complement the SIP Requests, which are used to initiate action such as a phone conversation. Note that the Reason Phrases of the responses listed below are only the recommended examples, and can be replaced with local equivalents without affecting the protocol.

Contents

1xx = Informational SIP Responses

Code Name Description
100 Trying Extended search is being performed so a forking proxy must send a 100 Trying response.
180 Ringing The Destination User Agent has received the INVITE message and is alerting the user of call.
181 Call Is Being Forwarded Optional, send by Server to indicate a call is being forwarded.
182 Queued Destination was temporarily unavailable, the server has queued the call until the destination is available.
183 Session Progress This response may be used to send extra information for a call which is still being set up.
199 Early Dialog Terminated Send by the User Agent Server to indicate that an early dialogue has been terminated.

2xx = Success Responses

Code Name Description
200 OK Shows that the request was successful
202 accepted Indicates that the request has been accepted for processing, mainly used for referrals.
204 No Notification Indicates that the request was successful but no response will be received.

3xx = Redirection Responses

Code Name Description
300 Multiple Choices The address resolved to one of several options for the user or client to choose between.
301 Moved Permanently The original Request URI is no longer valid, the new address is given in the Contact header.
302 Moved Temporarily The client should try at the address in the Contact field.
305 Use Proxy The Contact field details a proxy that must be used to access the requested destination.
380 Alternative Service The call failed, but alternatives are detailed in the message body.

4xx = Request Failures

Code Name Description
400 Bad Request The request could not be understood due to malformed syntax.
401 Unauthorized The request requires user authentication. This response is issued by UASs and registrars.
402 Payment Required (Reserved for future use).
403 Forbidden The server understood the request but is refusing to fulfill it.
404 Not Found The server has definitive information that the user does not exist at the (User not found).
405 Method Not Allowed The method specified in the Request-Line is understood, but not allowed.
406 Not Acceptable The resource is only capable of generating responses with unacceptable content.
407 Proxy Authentication Required The request requires user authentication.
408 Request Timeout Couldn’t find the user in time.
409 Conflict User already registered (deprecated)
410 Gone The user existed once but is not available here anymore.
411 Length Required The server will not accept the request without a valid content length (deprecated).
412 Conditional Request Failed The given precondition has not been met.
413 Request Entity Too Large Request body too large.
414 Request URI Too Long Server refuses to service the request, the Req-URI is longer than the server can interpret.
415 Unsupported Media Type Request body is in a non-supported format.
416 Unsupported URI Scheme Request-URI is unknown to the server.
417 Uknown Resource-Priority There was a resource-priority option tag, but no Resource-Priority header.
420 Bad Extension Bad SIP Protocol Extension used, not understood by the server.
421 Extension Required The server needs a specific extension not listed in the Supported header.
422 Session Interval Too Small The request contains a Session-Expires header field with a duration below the minimum.
423 Interval Too Brief The expiration time of the resource is too short.
424 Bad Location Information The request’s location content was malformed or otherwise unsatisfactory.
428 Use Identity Header The server policy requires an Identity header, and one has not been provided.
429 Provide Referrer Identity The server did not receive a valid Referred-By token on the request.
430 Flow Failed A specific flow to a user agent has failed, although other flows may succeed.
433 Anonymity Disallowed The request has been rejected because it was anonymous.
436 Bad Identity-Info The request has an Identity-Info header and the URI scheme contained cannot be de-referenced.
437 Unsupported Certificate The server was unable to validate a certificate for the domain that signed the request.
438 Invalid Identity Header Server obtained a valid certificate used to sign a request, was unable to verify the signature.
439 First Hop Lacks Outbound Support The first outbound proxy doesn’t support the “outbound” feature.
440 Max-Breadth Exceeded If a SIP proxy determined a response context had insufficient Incoming Max-Breadth to carry out a desired parallel fork, and the proxy is unwilling/unable to compensate by forking serially or sending a redirect, that proxy MUST return a 440 response. A client receiving a 440 response can infer that its request did not reach all possible destinations.
469 Bad Info Package If a SIP UA receives an INFO request associated with an Info Package that the UA has not indicated willingness to receive, the UA MUST send a 469 response, which contains a Recv-Info header field with Info Packages for which UA is willing to receive INFO requests.
470 Consent Needed The source of the request did not have the permission of the recipient to make such a request.
480 Temporarily Unavailable Callee currently unavailable.
481 Call/Transaction Does Not Exist Server received a request that does not match any dialogue or transaction.
482 Loop Detected Server has detected a loop.
483 Too Many Hops Max-Forwards header has reached the value ‘0’.
484 Address Incomplete Request-URI incomplete.
485 Ambiguous Request-URI is ambiguous.
486 Busy Here Callee is busy.
487 Request Terminated Request has terminated by bye or cancel.
488 Not Acceptable Here Some aspects of the session description of the Request-URI are not acceptable.
489 Bad Event The server did not understand an event package specified in an Event header field.
491 Request Pending Server has some pending request from the same dialogue.
493 Undecipherable UndecipherableRequest contains an encrypted MIME body, which recipient can not decrypt.
494 Security Agreement Required The server has received a request that requires a negotiated security mechanism.

5xx = Server Errors

Code Name Description
500 Server Internal Error The server could not fulfill the request due to some unexpected condition.
501 Not Implemented The SIP request method is not implemented here.
502 Bad Gateway The server, received an invalid response from a downstream server while trying to fulfill a request.
503 Service Unavailable The server is in maintenance or is temporarily overloaded and cannot process the request.
504 Server Time-out The server tried to access another server while trying to process a request, no timely response.
505 Version Not Supported The SIP protocol version in the request is not supported by the server.
513 Message Too Large The request message length is longer than the server can process.
555 Push Notification Service Not Supported The server does not support the push notification serviced specified in the pn-provider SIP URI parameter.
580 Precondition Failure The server is unable or unwilling to meet some constraints specified in the offer.

6xx = Global Failures

Code Name Description
600 Busy Everywhere All possible destinations are busy.
603 Decline Destination cannot/don't wish to participate in the call, no alternative destinations.
604 Does Not Exist Anywhere The server has authoritative information that the requested user does not exist anywhere.
606 Not Acceptable The user’s agent was contacted successfully but some aspects of the session description were not acceptable.
607 Unwanted The called party did not want his call from the calling party. Future attempts from the calling party are likely to be similarly rejected.
Personal tools
Namespaces
Variants
Actions
VoIP.ms Wiki
VoIP.ms Blog
Configuration
Guides (English)
Guides (Français)
Guías (Español)
Toolbox