List Domains

List domain names

Request

Request-Line

GET /lls/v1.0/domain

Request Parameters

Query Parameters

Parameter	Type	Required	Description
type	String	Optional	Domain type. Valid values: ingest, delivery.
status	String	Optional	Status of domain. Valid values: active, inactive.

Response

Response Body

Parameter	Type	Required	Description
domains	Array	Mandatory	Array of domains. Refer to Domain Object.

Object: Domain

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

List active ingest domains

Request

GET /lls/v1.0/domain?type=ingest&status=active HTTP/1.1

Successful Response Body

{
  "domains": [
    {
      "domain": "ingest.example.com",
      "type": "ingest",
      "created": "2025-07-10T09:30:00Z",
      "updated": "2025-07-10T19:48:07Z",
      "status": "active",
      "CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
      "authentication": true,
      "authenticationType": "default",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    },
    {
      "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",
      "authentication": true,
      "authenticationType": "3rdparty",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    }
  ]
}

List all domains

Request

GET /lls/v1.0/domain HTTP/1.1

Successful Response Body

{
  "domains": [
    {
      "domain": "ingest.example.com",
      "type": "ingest",
      "created": "2025-07-10T09:30:00Z",
      "updated": "2025-07-10T19:48:07Z",
      "status": "active",
      "CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
      "authentication": true,
      "authenticationType": "default",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    },
    {
      "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",
      "authentication": true,
      "authenticationType": "3rdparty",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    },
    {
      "domain": "delivery.example.com",
      "type": "delivery",
      "created": "2025-07-10T09:30:00Z",
      "updated": "2025-07-10T19:48:07Z",
      "status": "active",
      "CNAME": "edge.conversant.swiftserve.com"
    },
    {
      "domain": "deprecated.example.com",
      "type": "delivery",
      "created": "2025-06-20T16:40:55Z",
      "updated": "2025-07-08T13:30:22Z",
      "status": "inactive",
      "CNAME": "edge.conversant.swiftserve.com"
    }
  ]
}

List ingest domains

Request

GET /lls/v1.0/domain?type=ingest HTTP/1.1

Successful Response Body

{
  "domains": [
    {
      "domain": "ingest.example.com",
      "type": "ingest",
      "created": "2025-07-10T09:30:00Z",
      "updated": "2025-07-10T19:48:07Z",
      "status": "active",
      "CNAME": "1000-2000-3000.llss-ingest-sw.swiftserve.com",
      "authentication": true,
      "authenticationType": "default",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    },
    {
      "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",
      "authentication": true,
      "authenticationType": "3rdparty",
      "3rdPartyEndpoint": "https://auth.example.com/check"
    }
  ]
}

List inactive domains

Request

GET /lls/v1.0/domain?status=inactive HTTP/1.1

Successful Response Body

{
  "domains": [
    {
      "domain": "deprecated.example.com",
      "type": "delivery",
      "created": "2025-06-20T16:40:55Z",
      "updated": "2025-07-08T13:30:22Z",
      "status": "inactive",
      "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