Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getList DomainsgetGet DomainpostCreate DomainpostUpdate DomaindelDelete DomainpostActivate Email SendingpostActivate Email ReceivingdelDisable Email SendingdelDisable Email ReceivingpostEnable ShortlinkdelDisable ShortlinkpostEnable Link TrackinggetGet Email Receiving ConfiggetGet Sender ReputationgetGet Sender Reputation By Domain NamegetGet Domain Warmup StatuspostVerify Email DNSpostVerify Email Receiving DNSpostVerify Shortlink
Add DNS records
ProjectsDomains

Get Domain Warmup Status

Current warmup ramp for a sending domain: day, daily cap, remaining sends, and whether the send window is open. Returns null if the domain is not warming.

GET
/projects/{projectId}/domains/by-name/{domainName}/warmup-status

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the domain.

domainNamerequiredstring

Hostname to look up, without a protocol, e.g. mail.example.com.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/domains/by-name/string/warmup-status"
{
  "advanceThresholdPct": 0,
  "dailyCap": 0,
  "day": -9007199254740991,
  "maxWarmupDay": -9007199254740991,
  "remaining": 0,
  "sentInWindow": -9007199254740991,
  "status": "PENDING",
  "windowEndsAt": "string",
  "windowOpen": true
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get Sender Reputation By Domain Name

Same sender reputation score as Get Sender Reputation, looked up by hostname within the project. Returns null if the domain is not on the project.

Verify Email DNS

Asks Resend to re-check sending and tracking records and starts the verification job. The job is what emails 'verified'. verified is sending-only; trackingVerified is reported separately so a pending links CNAME does not look fully done. Returns 400 if the domain is not connected to an email provider.