Mailfullydocs

List API keys

List the organization's API keys for the current environment, newest first. Each key is masked to prefix and last4; the plaintext and hash are never returned.

GEThttps://api.mailfully.com/v1/api-keys

List the organization's API keys for the current environment, newest first. Each key is masked to prefix and last4; the plaintext and hash are never returned. revoked_at may be future-dated during a rotation grace window. Requires the manage:keys scope, which is a dashboard-session scope (owner or admin only) and cannot be granted to API keys today: every mf_ API key receives 403. Call this endpoint with a dashboard session token.

Loading code example
Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

application/json

The organization's API keys.

dataarray<object>required
data.object"api_key"required
Allowed values: "api_key"
data.idstringrequired
data.namestringrequired
data.prefixstringrequired

First 12 characters of the plaintext.

data.last4stringrequired

Last 4 characters of the plaintext.

data.scopesarray<"send" | "read:emails" | "read:analytics" | "read:suppressions">required
data.environment"live" | "test"required
Allowed values: "live" | "test"
data.domain_idstringrequired
data.last_used_atstring<date-time>required
data.created_atstring<date-time>required
data.revoked_atstring<date-time>required

May be future-dated during a rotation grace window.