a method to retrieve messages for bot from telegram api

        :param last_update: integer with update id of last message received
        :return: dictionary of response details with update list in [json][result]

        {
            'headers': { ... },
            'url': 'https://api.telegram.org/bot.../getUpdates',
            'code': 200,
            'error': '',
            'json': {
                'ok': True,
                'result': [
                    {
                        'update_id': 667652176,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'text': 'Hey',
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 173,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652176,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'caption': 'Interesting song',
                            'photo': [
                                {
                                    'file_id': 'AgADAQ...EC',
                                    'width': 51,
                                    'file_size': 1238,
                                    'height': 90
                                },
                                {
                                    'file_id': 'AgADAQ...Ag',
                                    'width': 180,
                                    'file_size': 13151,
                                    'height': 320
                                },
                                {
                                    'file_id': 'AgADAQ...VC',
                                    'width': 449,
                                    'file_size': 51134,
                                    'height': 800
                                },
                                {
                                    'file_id': 'AgADAQ...AC',
                                    'width': 719,
                                    'file_size': 82609,
                                    'height': 1280
                                }
                            ],
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 175,
                            'date': 1478729799
                        }
                    },
                    {
                        'update_id': 667652179,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'caption': 'Snow in slow mo',
                            'document': {
                                'file_name': 'IMG_0010.MOV',
                                'thumb': {
                                    'file_id': 'AAQB...IC',
                                    'file_size': 2547,
                                    'width': 90,
                                    'height': 50
                                },
                                'file_size': 51588899,
                                'file_id': 'BQAD...QI'
                            }
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 176,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652180,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'location': {
                                'latitude': 12.345678,
                                'longitude': -23.456789
                            },
                            'venue': {'
                                location': {
                                    'latitude': 12.345678,
                                    'longitude': -23.456789
                                },
                                'address': '1 Laboratory Rd',
                                'title': 'Collective Acuity Labs',
                                'foursquare_id': '4a...e3'
                            },
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 177,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652191,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'voice': {
                                'duration': 3,
                                'mime_type': 'audio/ogg',
                                'file_id': 'AwADAQADAgADXGbcC3hOFYsqDDtKAg',
                                'file_size': 7008
                            },
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 224,
                            'date': 1478729313
                        }
                    }
                ]
            }
        }

def get_updates(self, last_update=0):

        ''' a method to retrieve messages for bot from telegram api

        :param last_update: integer with update id of last message received
        :return: dictionary of response details with update list in [json][result]

        {
            'headers': { ... },
            'url': 'https://api.telegram.org/bot.../getUpdates',
            'code': 200,
            'error': '',
            'json': {
                'ok': True,
                'result': [
                    {
                        'update_id': 667652176,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'text': 'Hey',
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 173,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652176,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'caption': 'Interesting song',
                            'photo': [
                                {
                                    'file_id': 'AgADAQ...EC',
                                    'width': 51,
                                    'file_size': 1238,
                                    'height': 90
                                },
                                {
                                    'file_id': 'AgADAQ...Ag',
                                    'width': 180,
                                    'file_size': 13151,
                                    'height': 320
                                },
                                {
                                    'file_id': 'AgADAQ...VC',
                                    'width': 449,
                                    'file_size': 51134,
                                    'height': 800
                                },
                                {
                                    'file_id': 'AgADAQ...AC',
                                    'width': 719,
                                    'file_size': 82609,
                                    'height': 1280
                                }
                            ],
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 175,
                            'date': 1478729799
                        }
                    },
                    {
                        'update_id': 667652179,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'caption': 'Snow in slow mo',
                            'document': {
                                'file_name': 'IMG_0010.MOV',
                                'thumb': {
                                    'file_id': 'AAQB...IC',
                                    'file_size': 2547,
                                    'width': 90,
                                    'height': 50
                                },
                                'file_size': 51588899,
                                'file_id': 'BQAD...QI'
                            }
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 176,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652180,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'location': {
                                'latitude': 12.345678,
                                'longitude': -23.456789
                            },
                            'venue': {'
                                location': {
                                    'latitude': 12.345678,
                                    'longitude': -23.456789
                                },
                                'address': '1 Laboratory Rd',
                                'title': 'Collective Acuity Labs',
                                'foursquare_id': '4a...e3'
                            },
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 177,
                            'date': 1478729313
                        }
                    },
                    {
                        'update_id': 667652191,
                        'message': {
                            'chat': {
                                'first_name': 'First',
                                'type': 'private',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'voice': {
                                'duration': 3,
                                'mime_type': 'audio/ogg',
                                'file_id': 'AwADAQADAgADXGbcC3hOFYsqDDtKAg',
                                'file_size': 7008
                            },
                            'from': {
                                'first_name': 'First',
                                'id': 1234567890,
                                'last_name': 'Last'
                            },
                            'message_id': 224,
                            'date': 1478729313
                        }
                    }
                ]
            }
        }
        '''

        title = '%s.get_updates' % self.__class__.__name__

    # construct request fields
        request_kwargs = {
            'url': '%s/getUpdates' % self.api_endpoint
        }

    # add offset to kwargs
        if last_update:
            object_title = '%s(last_update=%s)' % (title, str(last_update))
            self.fields.validate(last_update, '.last_update', object_title)
            request_kwargs['data'] = {
                'offset': last_update + 1
            }

    # send request
        response_details = self._post_request(**request_kwargs)

        return response_details