Read a domain's higher-start request
Where the domain's latest "Request a higher start" stands, and whether it can ask now.
https://app.usenotix.dev/api/v1/domains/{id}/start-requestFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
Where the domain's latest "Request a higher start" stands, and whether it can ask now. A domain you migrated from Resend, SendGrid or Mailchimp starts at 2,000 emails a day by itself when its history there qualifies (automaticStart); above that a Notix admin decides. request is null when the domain never asked; otherwise its status is PENDING, APPROVED (with the approvedCap the admin set, which can differ from what was asked), DECLINED or CANCELLED (a pause, a hold or a newer move ended it). canRequest is true when the domain has recent history from your old provider, is sending, and has no request waiting.
Who can call it
Any key that can read the domain. A key limited to one domain may read that domain only; any other id answers 404.
Path parameters
Minimum 0. Maximum 2147483647.
Headers
Bearer followed by your API key.
Errors
No domain with this id for the calling team, or a key limited to one domain asked about another.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/domains/<id>/start-request" \
-H "Authorization: Bearer $NOTIX_API_KEY"
{
"domainId": 1,
"canRequest": true,
"automaticStart": 1,
"maxRequest": 1,
"request": {
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"status": "PENDING",
"requestedCap": 1,
"approvedCap": 1,
"createdAt": "2026-10-01T09:00:00Z",
"decidedAt": "2026-10-01T09:00:00Z"
}
}