API Reference
Current Account
Return the authenticated account's identity, verification status, current plan, BYOC configuration status, verified sending domains, and current calendar-month usage totals for Shared SES and BYOC.
GET/api/me/
Authentication
Send the same X-API-Key header used by POST /api/send/. The response is scoped to the API key's account; API key secrets and infrastructure credentials are never returned.
curl https://sendfleet.net/api/me/ \ -H "X-API-Key: YOUR_API_KEY"
Response
{
"name": "Your Name",
"email": "you@example.com",
"is_verified": true,
"current_plan": "growth",
"byoc_usage_current_month": 3,
"shared_usage_current_month": 7,
"byoc_configured": false,
"verified_byoc_domains": ["byoc.example.com"],
"verified_shared_domains": ["shared.example.com"]
}| Field | Type | Description |
|---|---|---|
| name | string | The account display name, or an empty string if none was provided. |
| string | The account email address used for sign-in and verification. | |
| is_verified | boolean | Whether the account email address has been verified. |
| current_plan | string | The active plan ID, such as growth or pro. An empty string means no subscription currently grants access. |
| byoc_usage_current_month | integer | BYOC emails counted in the current calendar month (UTC). |
| shared_usage_current_month | integer | Shared SES emails counted in the current calendar month (UTC). |
| byoc_configured | boolean | Whether the account has a fully validated, enabled BYOC configuration. |
| verified_byoc_domains | string[] | The account's verified BYOC sending domains. |
| verified_shared_domains | string[] | The account's verified Shared SES sending domains. |
Usage is authoritative. Counters use the same UTC calendar-month logic and database counters as the sending API. Previous-month rows are not included, and a missing current-month row returns zero.
Errors
A missing, invalid, revoked, or expired key is rejected before the account is returned. See Error Codes for the current authentication behavior and retry guidance.