Buttondown logo

Listing advertising slots

Use the /advertising_units/slots endpoint to list all advertising slots for your newsletter, ordered by date (most recent first).

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/advertising_units/slots"
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": "adslot_1328edc3fw896bp4mrhc535z5k",
            "creation_date": "2024-01-01T00:00:00+00:00",
            "date": "2024-12-01",
            "status": "open",
            "invoice_url": null,
            "sku_id": "adsku_0k28edc3fw896bp4mrhc535z5k",
            "submission_url": "http://127.0.0.1:8000/example/sponsorships/submit/11111111-1111-1111-1111-111111111111/",
            "sponsor_company": "",
            "sponsor_email": "",
            "sponsor_name": "",
            "content": "",
            "content_image_id": null,
            "content_url": "",
            "content_approved_at": null,
            "content_rejected_at": null,
            "content_rejection_reason": "",
            "content_submitted_at": null
        }
    ],
    "count": 1
}