Email Zones API Endpoints

Fetch all available email zones with our API.

Get Email Zones

To list all available email zones you can simply send a GET request to the following endpoint.

https://api.nodion.com/v1/email_zones

Required Headers: Authorization

Example Response:

{
  "email_zones": [
    {
      "id": "ef77b949-cc49-4edb-9ac1-2a51a99c9ef9",
      "status": "available",
      "name": "Sample Zone",
      "message_count": 648,
      "delivered_count": 50,
      "bounced_count": 1,
      "created_at": "2025-04-24T15:38:09.291+02:00",
      "updated_at": "2025-04-24T16:23:15.683+02:00"
    }
  ]
}

Get Email Zone

To fetch a single email zone you can simply send a GET request to the following endpoint.

https://api.nodion.com/v1/email_zones/:id

Required Headers: Authorization

Example Response:

{
  "email_zone": {
    "id": "ef77b949-cc49-4edb-9ac1-2a51a99c9ef9",
    "status": "available",
    "name": "Sample Zone",
    "message_count": 648,
    "delivered_count": 50,
    "bounced_count": 1,
    "created_at": "2025-04-24T15:38:09.291+02:00",
    "updated_at": "2025-04-24T16:23:15.683+02:00"
  }
}

Get Email Zone Messages

To fetch messages sent through a specific email zone you can simply send a GET request to the following endpoint.

https://api.nodion.com/v1/email_zones/:id/messages

Required Headers: Authorization

Example Response:

{
  "messages": [
    {
      "id": "1bf7d635-99ad-4632-a355-15f43a426265",
      "status": "created",
      "to_address": "sample@nodion.com",
      "created_at": "2025-06-03T21:30:54.894+02:00",
      "updated_at": "2025-06-03T21:30:54.894+02:00"
    },
    {
      "id": "0d3a755a-50d9-4cc1-bd7b-dde1c807a31c",
      "status": "created",
      "to_address": "john.doe@nodion.com",
      "created_at": "2025-06-03T21:30:27.144+02:00",
      "updated_at": "2025-06-03T21:30:27.144+02:00"
    },
    ...
  ]
}