Skip to main content

HTTP status code reporting for GET and POST requests

Project description


status is a cross-platform command line application that returns the HTTP response status code for a GET or POST request to a user submitted URL.

It has been tested in cPython 2.7.x, 3.4.x and pypy 2.4.0 (Python v2.7.8)


You can install status with the Python package manager pip:

pip install status

or download the source repository and run the following command in the top level source directory:

python install


You can upgrade status with pip. Use the following command:

pip install --upgrade status

or download the source repository and use the above instructions for a new install from source.


status will report the returned status code with a GET or POST request. The general syntax is:

status [option] <url>

It is not necessary to include the protocol (http://) in your URL. If you enter a URL without the protocol, status will prefix it with http://. If you intend to test with the secure HTTP protocol (https://), then make this explicit in your URL.

GET Request Status Codes

GET is the default request type. Enter the URL as an argument to status without an option:

status <url>

POST Request Status Codes

To use a POST request, add the -p or --post option:

status -p <url>


v0.2.5 - bug fix: connection error handling and new tests in cPython 2.7.9, 3.4.2 + pypy 2.4.0

v0.2.4 - updated application dependencies

v0.2.3 - updated application dependencies

v0.2.2 - minor bug fixes, documentation updates

v0.2.1 - exception handling for HTTP connection errors, help documentation updates

v0.2.0 - initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

status-0.2.5.tar.gz (5.7 kB view hashes)

Uploaded Source

Built Distribution

status-0.2.5-py2.py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page