Buttondown logo

Listing imports

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/imports"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("GET", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "results": [
        {
            "id": "sub_imp_0k28edc3fw896bp4mrhc535z5k",
            "creation_date": "2020-09-29T00:00:00+00:00",
            "type": "subscriber_import",
            "status": "succeeded",
            "source": "substack",
            "label": "subscribers.csv",
            "metadata": {
                "email_column": 0,
                "metadata_columns": {}
            },
            "results": {
                "new_subscribers": 100,
                "updated_subscribers": null,
                "existing_subscribers": 20,
                "reason_to_bad_subscribers": {
                    "That email address is invalid.": [
                        "email@examplecom"
                    ]
                },
                "new_tags": 2
            }
        }
    ],
    "count": 1
}