When you attempt a call between two networks, SIP response codes convey important information.
By Emily Bowen
Session Initiation Protocol (SIP) is a call and response protocol used to initiate, maintain and terminate multimedia sessions within VoIP applications. Simply put, these internet-hosted multimedia sessions can integrate voice, video and messaging into a call. SIP response codes are three-digit numerical messages that contain information sent by the User Agent Server (UAS) to the User Agent Client (UAC). SIP response codes provide information about the status of the call.
There are six SIP response code class types—the first digit of each code indicates the class of the code. Codes beginning with the number 1 are known as “provisional” codes, and codes beginning with numbers 2-6 are known as “final” codes. Provisional SIP codes are sent up until a call is connected; final codes confirm whether or not the connection was successful.
You don’t need to memorize the different types of SIP codes, but it can be helpful to have a reference sheet handy and a general idea of what each code indicates. Here are the most common types of SIP response codes:
A 1xx SIP response code can be sent at any time while a connection is being established. Here are some common 1xx codes:
A call request has been received, and an unspecified action (such as consulting a database) is being taken on behalf of the call request.
An invite has been received by the User Agent Server (UAS), which is now attempting to alert the user.
The SIP call is being forwarded to another endpoint.
Gives information about the progress of a SIP call.
Notifies upstream SIP entities that an early dialog has been terminated.
The 2xx response codes are used to indicate that a SIP request has been successfully received, understood and accepted. You’ll typically see the following versions:
A request has succeeded.
A UAS has received and understood the request, but it may not have been authorized or processed by the server.
A request was successful, but a response will not be received.
These codes inform the User Agent Client (UAC) on redirections and of the different routes available to get to the UAS. Commonly received examples include:
A request address returned several choices, each with their own specific locations. In this case, the UA can select a preferred endpoint to redirect the request to that specific location.
A user can no longer be found at the address used in the request. A new address will be given in the contact header field, which can be retried by the requesting client. The new address should be saved and used in all future invite requests.
A new address will be given in the contact header field, which can be retried by the requesting client. This address should not be saved for future invite requests.
A proxy must be used to access the required destination. The specified proxy will be displayed in the contact field.
The call failed, but the message body describes alternatives.
The 4xx response codes indicate that something went wrong while processing the message, and the request cannot be fulfilled. There are quite a few of client error SIP response codes, including:
A request could not be understood.
A request requires user authentication.
A server has definitive information that the user does not exist at that particular domain.
Similar to the 401 (not authorized) code, but in this case the client must authenticate itself with the proxy.
A server could not produce a response within a suitable time frame.
A server is refusing to service the request because the message body is in a format not supported by the server for the particular request method.
5xx responses relate to server error issues and are mostly generated by the likes of proxy servers, location servers and redirect servers. They include:
A server was prevented from fulfilling the request by an unexpected condition.
A functionality required to fulfill the request is not supported by the server.
When attempting to fulfill the request, a server received an invalid response from a downstream server.
Temporary overloading or maintenance of a server means it is currently unable to process the request. The client should attempt to forward the request to another server.
When attempting to process the request, a server did not receive a timely response form the external server.
Finally, the 6xx response codes relate to Global Error issues. They include:
A callee’s end system was contacted successfully but the callee is busy.
A callee’s end system was successfully contacted but the user does not wish to or cannot participate.
Information the user indicated in the request Uniform Resource Identifier (URI) does not exist.
A user wishes to communicate, but they cannot adequately support the session described.
Download the infographic below and keep it as a handy reference:
The codes listed above are the most common codes, but there are additional codes you may encounter:
Response | Status |
---|---|
182 | queued |
402 | payment required |
403 | forbidden |
405 | method not allowed |
406 | not acceptable |
409 | forbidden |
410 | gone |
411 | length required |
412 | conditional request failed |
413 | request—entity too large |
414 | request URI too long |
416 | unsupported URI scheme |
417 | unknown resource—priority |
420 | bad extension |
421 | extension required |
422 | session interval too small |
423 | interval too brief |
424 | bad location information |
425 | bad alert message |
428 | use identity header |
429 | provide referrer identity |
430 | flow failed |
433 | anonymity disallowed |
436 | bad identity—info |
437 | unsupported certificate |
438 | invalid identity header |
439 | first hop lacks outbound support |
440 | max—breadth exceeded |
469 | bad info package |
470 | consent needed |
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 aceptable here |
489 | bad event |
491 | request pending |
493 | undecipherable |
494 | security agreement withheld |
505 | version not supported |
513 | message too large |
555 | push notification service not supported |
580 | precondition failure |
607 | unwanted |
608 | rejected |
Why SIP? SIP, together with VoIP, enables businesses to build customized telephony systems. SIP trunks reduce the amount of infrastructure your business needs: you can add many channels to a single SIP trunk, which allows you to have multiple phone lines. Without SIP trunks, you’d need to pay for individual lines each time you hired a new employee. SIP protocol and SIP trunking features enhance your VoIP system to create a robust, scalable and flexible communication solution for your business.
Contact our team of experts to learn how SIP trunking can transfom your business communications.
Related articles