List sending domains

Lists your sending domains and whether each can send right now.

GET /v1/sending-identities

Example

curl https://api.wakio.net/v1/sending-identities \
  -H "Authorization: Bearer $WAKIO_API_KEY"

Response 200:

{
  "sending_identities": [
    {
      "domain": "mail.northwind.example",
      "sendable": true,
      "verification_status": "verified"
    }
  ]
}

Response

Name	Type	Required	Description
`sending_identities`	array	Yes	One entry per domain, ordered by domain. Removed domains are left out.
`sending_identities[].domain`	string	Yes	The domain.
`sending_identities[].sendable`	boolean	Yes	Whether mail can go out from it now. A verified domain that is paused is not sendable.
`sending_identities[].verification_status`	string	Yes	One of `pending`, `verified`, or `failed`.

Errors

Every error this endpoint itself returns is {"error": "<code>"}, sometimes with one more field that explains it. The API overview lists the responses that do not follow that shape.

Status	Code	What happened	What to do
`401`	`invalid_api_key`	The `Authorization` header is missing, malformed, or names no active key.	Send `Authorization: Bearer <key>` with an active key from API keys in the dashboard.

Notes

Check sendable, not verification_status, before you send. A verified domain that is paused still reads verified and cannot send.