Get the description of a status code in Python Requests

Question:

I would like to be able to enter a server response code and have Requests tell me what the code means. For example, code 200 –> ok

I found a link to the source code which shows the dictionary structure of the codes and descriptions. I see that Requests will return a response code for a given description:

print requests.codes.processing  # returns 102
print requests.codes.ok          # returns 200
print requests.codes.not_found   # returns 404

But not the other way around:

print requests.codes[200]        # returns None
print requests.codes.viewkeys()  # returns dict_keys([])
print requests.codes.keys()      # returns []

I thought this would be a routine task, but cannot seem to find an answer to this in online searching, or in the documentation.

Asked By: Roberto

||

Answers:

Alternatively, in case of Python 2.x, you can use httplib.responses:

>>> import httplib
>>> httplib.responses[200]
'OK'
>>> httplib.responses[404]
'Not Found'

In Python 3.x, use http module:

In [1]: from http.client import responses

In [2]: responses[200]
Out[2]: 'OK'

In [3]: responses[404]
Out[3]: 'Not Found'
Answered By: alecxe

One possibility:

>>> import requests
>>> requests.status_codes._codes[200]
('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\o/', 'xe2x9cx93')

The first value in the tuple is used as the conventional code key.

Answered By: shux

requests.status_codes.codes.OK

works nicely and makes it more readable in my application code

Notice that in source code: the requests.status_codes.codes is of type LookupDict which overrides method getitem

You could see all the supported keys with – dir(requests.status_codes.codes)

When using in combination with FLASK:

i like use following enum from flask-api plugin
from flask_api import status where i get more descriptive version of HTTP status codes as in –

status.HTTP_200_OK

Answered By: ofbyone

I had the same problem before and found the
answer in this question

Basically:

  • responsedata.status_code – gives you the integer status code
  • responsedata.reason – gives the text/string representation of the status code
Answered By: nuwang

With Python 3.x this will work

>>> from http import HTTPStatus
>>> HTTPStatus(200).phrase
'OK'
Answered By: mat1010
Categories: questions Tags: , ,
Answers are sorted by their score. The answer accepted by the question owner as the best is marked with
at the top-right corner.