IpumsApiClient.extract_status(extract, collection=None)[source]#

Check on the status of an extract request. If no such extract exists, return ‘not found’.

  • extract (Union[BaseExtract, int]) – The extract to download. This extract must have been submitted. Alternatively, can be an extract id. If an extract id is provided, you must supply the collection name

  • collection (Optional[str]) – The name of the collection to pull the extract from. If None, then extract must be a BaseExtract


The status of the request. Valid statuses are:

’queued’, ‘started’, ‘completed’, ‘failed’, or ‘not found’

Return type: