Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

Support

Projects

getList DomainsgetGet DomaingetGet Domain By NamepostCreate DomainpostUpdate DomaindelDelete DomainpostActivate Email SendingpostActivate Email ReceivingdelDisable Email SendingdelDisable Email ReceivingpostEnable ShortlinkdelDisable ShortlinkpostEnable Link TrackinggetGet Email Receiving ConfiggetGet Sender ReputationgetGet Sender Reputation By Domain NamepostRefresh Sender ReputationgetGet Domain Warmup StatuspostComplete Domain WarmuppostVerify Email DNSpostVerify Email Receiving DNSpostVerify Shortlink
Domains

Get Domain

Fetches a domain plus its email DNS config and whether verification jobs are still running. Returns 404 if no domain matches.

GET
/projects/{projectId}/domains/{domainId}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the domain.

domainIdrequiredstring

ID of the domain.

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/string"
{
  "domain": {
    "id": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "emailStatus": "INACTIVE",
    "emailProvider": "string",
    "emailProviderDomainId": "string",
    "emailReceivingStatus": "INACTIVE",
    "emailReceivingProviderId": "string",
    "trackingSubdomain": "string",
    "trackingVerificationStatus": "PENDING",
    "shortlinkEnabled": true,
    "vercelConfigured": true,
    "vercelVerificationStatus": "PENDING",
    "vercelVerificationError": "string",
    "vercelVerificationDNS": [
      {
        "domain": "string",
        "reason": "string",
        "type": "string",
        "value": "string"
      }
    ],
    "emailVerificationRequestedAt": "string",
    "receivingVerificationRequestedAt": "string",
    "shortlinkVerificationRequestedAt": "string",
    "senderReputationComputedAt": "string",
    "warmupStatus": "PENDING",
    "warmupStartedAt": "string",
    "warmupWindowStartedAt": "string",
    "projectId": "string",
    "name": "string",
    "senderReputation": 50,
    "warmupDay": 0,
    "warmupSentCount": 0
  },
  "emailConfig": {
    "capabilities": {
      "receiving": "string",
      "sending": "string"
    },
    "created_at": "string",
    "id": "string",
    "name": "string",
    "records": [
      {
        "name": "string",
        "priority": 0,
        "record": "string",
        "status": "string",
        "ttl": "string",
        "type": "string",
        "value": "string"
      }
    ],
    "region": "string",
    "status": "pending"
  },
  "emailVerificationJobActive": true,
  "emailVerificationStarted": true,
  "receivingVerificationJobActive": true,
  "receivingVerificationStarted": true,
  "shortlinkVerificationJobActive": true,
  "shortlinkVerificationStarted": 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": []
}

List Domains

Lists the project's domains. Filter by sending status, shortlink state, or readyToSend (ACTIVE and tracking verified — use that when picking a from-domain).

Get Domain By Name

Public lookup of a domain by hostname. Not project-scoped. Returns 404 if no domain matches.