Email Routing activity

GET

/api/v1/email-routing/domains/{domain}/activity

curl --request GET \
  --url https://digize.com/api/v1/email-routing/domains/example/activity \
  --header 'x-api-key: <x-api-key>'

• Digize

What a routing domain and its subdomains received over the last 30 days, the newest first, from Cloudflare’s Email Routing analytics. available is false when the platform can’t read the account.

Needs the sites:read permission.

Authorizations

• apiKey
• bearer

Parameters

Path Parameters

domain

required

string

>= 3 characters <= 253 characters

Responses

200

Done

Media typeapplication/json

object

available

required

boolean

emails

required

Array<object>

object

id

required

string

from

required

string

to

required

string

domain

required

string

subject

required

string

receivedAt

required

string format: date-time

outcome

required

string

Allowed values: forwarded worker conversations dropped rejected failed error

rule

required

string | null

detail

required

string

spf

required

string

Allowed values: pass fail none

dkim

required

string

Allowed values: pass fail none

dmarc

required

string

Allowed values: pass fail none

size

required

number

Example

{
  "emails": [
    {
      "outcome": "forwarded",
      "spf": "pass",
      "dkim": "pass",
      "dmarc": "pass"
    }
  ]
}

400

What was sent isn’t valid (invalid).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

401

No key, or one that’s unknown, off or expired.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

403

The key doesn’t have the permission this needs.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

404

Nothing has that id (not_found).

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}

429

Over the rate limit; see retry-after.

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid unauthorized forbidden not_found conflict too_large rate_limited unavailable internal

message

required

string

details

object

key

additional properties

any

Example

{
  "error": {
    "code": "invalid"
  }
}