Mailchimp Developer LogoMailchimp Developer Wordmark

Transactional API

  • Allowlists

    Add, list, or delete from your Rejection Allowlist.

    • Exports

      Start an export, or get information on export jobs in progress.

      • IPs

        Request and manage Dedicated IPs for your account, and set up reverse DNS.

        • Inbound

          Manage your inbound domains and routes.

          • Messages

            Send, schedule, or get information on your emails.

            • Metadata

              Manage your custom metadata fields in your account.

              • Rejects

                Add, list, or delete from your Rejection Denylist.

                • Senders

                  Manage or get information about your sending domains.

                  • Subaccounts

                    Manage your subaccounts, including the abilitiy to pause and resume sending.

                    • Tags

                      List, delete, or get information on your Tags and their sending statistics.

                      • Templates

                        Manage the Templates in your account.

                        • URLs

                          Manage your tracking domains. Some of these endpoints may be deprecated.

                          • Get url historydeprecated

                            post

                            /urls/time-series

                            Return the recent history (hourly stats for the last 30 days) for a URL

                            body parameters

                            • keyrequired
                              string

                              a valid api key

                            • urlrequired
                              string

                              an existing URL

                            Get url history

                            const mailchimpClient = require("@mailchimp/mailchimp_transactional")(
                              "YOUR_API_KEY"
                            );
                            
                            const run = async () => {
                              const response = await mailchimpClient.urls.timeSeries({
                                url: "http://korey.name",
                              });
                              console.log(response);
                            };
                            
                            run();
                            
                            

                            Success Response

                            • HTTP Status 200

                              the array of history information

                              • Array
                                object[]

                                the information for a single hour

                                Show Properties

                            Example response

                            JSON
                            [
                              {
                                "time": "2019-08-24T14:15:22Z",
                                "sent": 0,
                                "clicks": 0,
                                "unique_clicks": 0
                              }
                            ]
                          • Users

                            Get information about your account, or ping Transactional.

                            • Webhooks

                              Manage the webhooks in your account.

                              • Whitelists

                                Add, list, or delete from your Rejection Allowlist. These endpoints are being replaced with a series of functionally identical endpoints called /allowlists.