Query a Domain

Query a domain name

Request

Request-Line

GET /lls/v1.0/domain/{domain}

Request Parameters

Path Parameters

Parameter	Type	Required	Description
domain	String	Mandatory	Domain name.

Response

Response Body

Parameter	Type	Required	Description
domain	String	Mandatory	Domain name
type	String	Mandatory	Domain type. Valid values: ingest, delivery.
created	Timestamp	Mandatory	Timestamp of created time in UTC timezone. Default is now.
updated	Timestamp	Mandatory	Timestamp of updated time in UTC timezone. Default is now.
status	String	Mandatory	Status of domain. Valid values: active, inactive.
CNAME	String	Mandatory	CNAME for domain.
associatedDeliveryDomain	Array	Optional	Associated delivery domain name. It is available for ingest domain only.
authentication	Boolean	Optional	Enable authentication or not. It is available for ingest domain only.
authenticationType	String	Optional	Authentication type. Valid values: default, 3rdparty. It is available for ingest domain only.
authenticationKey	String	Optional	Authentication key. It is available for authenticationType=default only.
3rdPartyEndpoint	String	Optional	Third party endpoint for 3rdparty authentication. It is available for authenticationType=3rdparty only.

Status Codes, Error Codes and Error Messages

Status Code	Error Code	Error Message
400	LLS.Domain.NotFound	Domain name is not found.

Examples

Query an ingest domain with default authentication

Request

GET /lls/v1.0/domain/ingest.example.com HTTP/1.1

Successful Response Body

{
  "domain": "ingest.example.com",
  "type": "ingest",
  "created": "2025-07-10T09:30:00Z",
  "updated": "2025-07-10T18:47:41Z",
  "status": "active",
  "CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
  "authentication": true, 
  "authenticationType": "default",
  "authenticationKey": "abcdef123456"
}

Query an ingest domain with 3rdparty authentication

Request

GET /lls/v1.0/domain/ingest-3rdparty.example.com HTTP/1.1

Successful Response Body

{
  "domain": "ingest-3rdparty.example.com",
  "type": "ingest",
  "created": "2025-07-12T10:15:00Z",
  "updated": "2025-07-12T14:30:22Z",
  "status": "active",
  "CNAME": "1000-2000-4000.llss-ingest-sw.swiftserve.com",
  "tokenAuthentication": {
    "authentication": true,
    "authenticationType": "3rdparty",
    "3rdPartyEndpoint": "https://auth.example.com/check"
  }
}

Query a delivery domain

Request

GET /lls/v1.0/domain/delivery.example.com HTTP/1.1

Successful Response Body

{
  "domain": "ingest.example.com",
  "type": "ingest",
  "created": "2025-07-10T09:30:00Z",
  "updated": "2025-07-10T18:47:41Z",
  "status": "active",
  "CNAME": "edge.conversant.swiftserve.com"
}

Best Practices

Rate Limiting

Rate Limits

Rate limiting is posed upon the API, please kindly check your API calls to ensure complying with the rate limit below:

• 100 requests per minute
• 1000 requests per hour