Entri Sell Enterprise API

Overview

The Entri Sell (Enterprise) API enables you to offer domain search, registration, and management directly within your platform. By integrating with our API, you can sell domains to your customers without needing to manage ICANN compliance, registry integrations, or billing infrastructure. Entri handles the provisioning and maintenance behind the scenes, while you focus on building a seamless customer experience.

Request Structure

All requests to the Entri Sell Enterprise API must be made over HTTPS. Base URL:

https://api.goentri.com/enterprise/sell/{api-version}/{resource}

General format:

{http-method} https://api.goentri.com/enterprise/sell/{api-version}/{resource}?{query-params}

Request headers:

Authorization: Bearer {access_token} — required for authentication
Accept: application/json — required, JSON is the only supported format
Content-Type: application/json — required for requests with a body (POST, PUT)
applicationId: {your-application-name} — identifies your integration

Authentication

The Entri Sell Enterprise API uses a short-lived JWT that you mint server-side using your applicationId and secret. Do not expose your secret in client code. The JWT expires after 60 minutes.

1) Create a JWT

Endpoint POST https://api.goentri.com/token Headers Content-Type: application/json Body

{
  "applicationId": "<YOUR_APPLICATION_ID>",
  "secret": "<YOUR_SECRET>"
}

Response (200)

{ "auth_token": "eyJ0eXAiOiJKV1QiLCJhbGciOi..." }

JWT creation with applicationId and secret, 60-minute expiry.

2) Call the API with the JWT

Include the JWT as a Bearer token, and pass your applicationId header on every request:

Authorization: Bearer <auth_token>
applicationId: <YOUR_APPLICATION_ID>

(Use of the JWT in Authorization and the applicationId header is shown across the Secure/Power API examples and applies here as well.) Example

curl -X GET "https://api.goentri.com/enterprise/sell/v1/domains/availability?domainName=example.com" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Notes

Mint tokens server-side only; never ship your secret to the browser.
Tokens expire after 60 minutes—mint a fresh token as needed.

Domains – Search

Check Domain Availability

GET /domains/availability — Check if a domain is available. Params

domain (required): Domain name to check (e.g., example.com)

Description Checks if a domain is available for registration. Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/domains/availability?domain=example.com" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "domain": "example.com",
  "availability": "AVAILABLE",
  "price": 12.99,
  "renewalPrice": 14.99
}

Retrieve Domain Suggestions

GET /domains/suggestions — Returns domain name suggestions using Identity Digital API. Params

domain (required): Base domain name for suggestions
tlds (optional): Comma separated list of TLDs, e.g: com,store,online. If no tlds are present as the request parameters, the default online,shop will be used.

Description Returns domain name suggestions using Identity Digital API. Integration Points

Identity Digital API
DynamoDB: Control Table for calculating the price for the given TLDs.

Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/domains/suggestions?domain=example&tlds=com,store,online" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "suggestions": [
    {
      "domain": "Exampleco.store",
      "price": 1,
      "renewalPrice": 99
    }
  ]
}

Domains – Management

Retrieve List of Domains

GET /domains — Retrieves list of all domains registered through the platform for the authenticated application. Authentication Required (JWT) Params

page (optional): Page number. Default first page (0)
size (optional): Results per page. Default: 10
status (optional): The status of the domain. Supported statuses: payment_initiated, payment_successful, payment_failed, registration_in_progress, registered, transferred, transfer_started, transfer_completed, transfer_ack, transfer_success, transfer_failed
domain (optional): The domain name used in the search query.
application_id (optional): The application_id used in the search query.
from_date (optional): ISO 8601 Date Format (YYYY-MM-DD) - Used for delimiting the start date of the search
to_date (optional): ISO 8601 Date Format (YYYY-MM-DD) - Used for delimiting the end date of the search

Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/domains?page=0&size=10&status=registered" \
  -H "Authorization: Bearer <AUTH_TOKEN>" \
  -H "applicationId: <YOUR_APPLICATION_ID>" \
  -H "Accept: application/json"

Example response

{
  "items": [
    {
      "domainName": "domainname.com",
      "dnsRecords": [],
      "autoRenewed": true,
      "whoisPrivacy": false,
      "locked": false,
      "status": "registered",
      "createdAt": "2025-09-07T23:22:42.661936",
      "updatedAt": "2025-09-07T23:22:42.661936"
    }
  ],
  "total": 100,
  "page": 0,
  "limit": 10,
  "count": 10,
  "pages": 10,
  "nextPage": 1,
  "prevPage": null
}

Retrieve Single Domain

GET /domains/{domain_name} — Retrieves detailed information about a specific domain. Path Parameters:

domain_name (required): Domain name to retrieve

Authentication Required (JWT) Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/domains/sampledomain.com" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "domainName": "sampledomain.com",
  "dnsRecords": [],
  "autoRenewed": true,
  "whoisPrivacy": false,
  "locked": false,
  "status": "payment_initiated",
  "createdAt": "2025-11-24T02:33:05.918266",
  "updatedAt": "2025-11-24T02:33:05.918266"
}

Update Domain Automatic Renewal Status

PUT /domains/{domain_name}/auto-renew — Updates the auto-renewal status for a domain. Authentication Required (JWT) Path Parameters

domain_name (required): Domain name to set the renew

Request Body

{
  "autoRenew": true,
  "period": 12
}

Example request

curl -X PUT \
"https://api.goentri.com/enterprise/sell/v1/domains/mydomain.com/auto-renew" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "autoRenew": true, "period": 12 }'

Example response

{
  "message": "Domain auto-renewal updated successfully"
}

Resend Registrant Verification Email

POST /domains/{domain_name}/resend-verification — Resends the registrant verification email for a domain. Path Parameters

domain_name (required): Domain name

Description Resends the registrant verification email for a domain. Authentication Required (JWT) Example request

curl -X POST \
"https://api.goentri.com/enterprise/sell/v1/domains/mydomain.com/resend-verification" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "message": "Verification email has been resent"
}

Retrieve Domain DNS Records

GET /domains/{domain_name}/dns-records — Retrieves all DNS records for a domain Path Parameters

domain_name (required): Domain name

Authentication Required (JWT) Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/domains/mydomain.com/dns-records" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

[
  {
    "host": "@",
    "type": "A",
    "value": "192.168.1.1",
    "ttl": 3600
  }
]

Update Domain DNS Records

PUT /domains/{domain_name}/dns-records — Updates DNS records for a given domain. Path Parameters

domain_name (required): Domain name

Authentication Required (JWT) Request Body

{
  "dns_records": [
    {
      "value": "ring-floor-1187.the.com",
      "host": "www",
      "ttl": 300,
      "type": "CNAME"
    },
    {
      "value": "_402962b5637f756da4ab7a0608067719.czrmfnbpdk.acm-validations.aws.",
      "host": "_a49d1d3b2b3fe27d0d002d533a751aee.www",
      "ttl": 300,
      "type": "CNAME"
    }
  ]
}

Example request

curl -X PUT \
"https://api.goentri.com/enterprise/sell/v1/domains/mydomain.com/dns-records" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "dns_records": [ { "host":"www", "type":"CNAME", "value":"ring-floor-1187.the.com", "ttl":300 } ] }'

Example response

{
  "message": "DNS records updated successfully"
}

Domain Transfer In

POST /domains/{domain_name}/transfers/in — Initiates the domain transfer from an external registrar. Path Parameters

domain_name (required): Domain name to be transferred.

Description Initiates the domain transfer from an external registrar. Authentication Required (JWT) Request Body

{
  "domain": "foo.com",
  "authorizationCode": "{AUTHORIZATION CODE}",
  "contactDetails": {
    "email": "[email protected]",
    "fname": "Renan",
    "lname": "Alves",
    "phone": "+1-555-123-4567",
    "address": [
      "123 Main Street",
      "Suite 456"
    ],
    "city": "New York",
    "state": "NY",
    "country": "US",
    "pcode": "10001"
  }
}

The {AUTHORIZATION CODE} MUST be provided in order to successfully initiate the transfer due to the following purposes:

Validates that the person initiating the transfer is the legitimate domain owner
Identifies the legal owner or admin of the domain
Acts as authentication between the losing registrar and gaining registrar

Example request

curl -X POST "https://api.goentri.com/enterprise/sell/v1/domains/foo.com/transfers/in" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @transfer-in.json

Example response

{
  "domain": "foo.com",
  "transferId": "{TRANSFER_ID}",
  "transferStatus": "transfer_started",
  "transferType": "transfer_in"
}

Domain Transfer Out

POST /domains/{domain_name}/transfers/out — Initiates the domain transfer out to an external registrar Path Parameters

domain_name (required): Domain name to be transferred to the gaining / external registrar

Description Initiates the domain transfer out to an external registrar Authentication Required (JWT) Request Body

{
  "domain": "foo.com"
}

Example request

curl -X POST "https://api.goentri.com/enterprise/sell/v1/domains/foo.com/transfers/out" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{ "domain": "foo.com" }'

Example response

{
  "domain": "foo.com",
  "authCode": "{AUTHORIZATION CODE}",
  "transferStatus": "transfer_started",
  "transferType": "transfer_out"
}

Orders

Validate Whois Contacts

POST /domains/contacts/validate — Validates WHOIS contact information before domain registration. Description Validates WHOIS contact information before domain registration. Authentication Required (JWT) Request Body

{
  "email": "[email protected]",
  "fname": "Renan",
  "lname": "Alves",
  "phone": "+1-555-123-4567",
  "address": [
    "123 Main Street",
    "Suite 456"
  ],
  "city": "New York",
  "state": "NY",
  "country": "US",
  "pcode": "10001",
  "organization": "Example Corporation",
  "type": "PERSON"
}

Example request

curl -X POST "https://api.goentri.com/enterprise/sell/v1/domains/contacts/validate" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @contacts.json

Example response

{
  "message": "Whois contact validated and successfully created",
  "content": {
    "created": "2025-12-17T14:06:31.000+0100",
    "updated": "2025-12-17T14:06:31.000+0100",
    "id": 24047757,
    "owner": {
      "context": 4,
      "user": "1352400449"
    },
    "updater": {
      "context": 4,
      "user": "1352400449"
    },
    "alias": "Renan-Alves1",
    "type": "PERSON",
    "organization": "Example Corporation",
    "city": "New York",
    "country": "US",
    "state": "NY",
    "email": "[email protected]",
    "protection": "SHOW_NONE",
    "domainsafe": false,
    "fname": "Renan",
    "lname": "Alves",
    "address": [
      "123 Main Street",
      "Suite 456"
    ],
    "pcode": "10001",
    "phone": "+1-555-1234567"
  }
}

Retrieve Orders

GET /orders — Retrieves list of all orders for the authenticated application. Query Parameters

page (optional): Page number. Default first page (0)
size (optional): Results per page. Default: 10
status (optional): The status of the domain. Supported statuses: payment_initiated, payment_successful, payment_failed, registration_in_progress, registered, transferred, transfer_started, transfer_completed, transfer_ack, transfer_success, transfer_failed
domain (optional): The domain name used in the search query.
application_id (optional): The application_id used in the search query.
from_date (optional): ISO 8601 Date Format (YYYY-MM-DD) - Used for delimiting the start date of the search
to_date (optional): ISO 8601 Date Format (YYYY-MM-DD) - Used for delimiting the end date of the search

Authentication Required (JWT) Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/orders?page=0&size=10" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "items": [
    {
      "orderId": "5cf0cd4a-6a9f-4b53-8b11-7fe2a89e75df",
      "orderStatus": "registered",
      "customerEmail": "[email protected]",
      "items": [
        {
          "orderItemId": "fe5624c3-d18d-4144-b1ab-5ef4711317e5",
          "domainName": "foo.com",
          "dnsRecords": [],
          "autoRenewed": true,
          "whoisPrivacy": false,
          "locked": false,
          "status": "registered",
          "createdAt": "2025-12-09T16:27:53.523047",
          "updatedAt": "2025-12-09T16:27:53.523047"
        }
      ]
    }
  ],
  "total": 100,
  "page": 0,
  "limit": 10,
  "count": 10,
  "pages": 10,
  "nextPage": 1,
  "prevPage": null
}

Place New Order

POST /orders — Creates a new domain order and Stripe payment intent Description Creates a new domain order and Stripe payment intent Authentication Required (JWT) Request Body

{
  "domain": "example.com",
  "email": "[email protected]",
  "contactDetails": {
    "type": "PERSON",
    "fname": "John",
    "lname": "Doe",
    "address": [
      "123 Main Street"
    ],
    "city": "New York",
    "pcode": "12345",
    "country": "US",
    "state": "NY",
    "phone": "+1.5551234567",
    "email": "[email protected]"
  },
  "defaultDnsRecords": [
    {
      "host": "@",
      "type": "A",
      "value": "192.168.1.1"
    }
  ]
}

Example request

curl -X POST "https://api.goentri.com/enterprise/sell/v1/orders" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d @order.json

Example response

{
  "order_id": "uuid-v4",
  "payment_url": "https://domains.entri.com/pay?session=encrypted_data",
  "payment_data": "encrypted_session_data"
}

order_id: Order identifier. payment_data: Payment hash required for opening the checkout modal using our built-in loadPayment(payment_data) javascript function. payment_url: Checkout’s URL for opening the checkout without using the loadPayment javascript function. For more info, refer to loadPayment(payment_data).

loadPayment(payment_data)

This function is part of the entri.js library. It opens a modal that displays the checkout page, and once the customer either completes or cancels the payment process, the modal closes automatically. The result of the transaction is then communicated through a webhook event with type: “domain.purchased”. For more details, please visit our webhook documentation page. Parameters

Name	Type	Description
payment_data	string	A signed and encoded payment token obtained from the POST /orders endpoint. It contains all necessary information to securely initialize the checkout session.

Example Usage

javascript

// payment_data is typically obtained from your backend using the POST /orders endpoint
const payment_data = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";  

// Open the Entri checkout modal
entri.loadPayment(payment_data);

Retrieve Single Order

GET /orders/{order_id} — Retrieves detailed information about a specific order. Description Retrieves detailed information about a specific order. Path Parameters

order_id (required): Order UUID

Authentication Required (JWT) Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/orders/5c819665-2f7a-48c7-8c7b-fabd46f9235f" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "orderId": "5c819665-2f7a-48c7-8c7b-fabd46f9235f",
  "orderStatus": "registered",
  "customerEmail": "[email protected]",
  "items": [
    {
      "orderItemId": "5ea01588-509f-4245-bbe9-6f37c3047f0c",
      "domainName": "foo.com",
      "dnsRecords": [],
      "autoRenewed": true,
      "whoisPrivacy": false,
      "locked": false,
      "status": "registered",
      "createdAt": "2025-12-09T16:27:53.523047",
      "updatedAt": "2025-12-09T16:27:53.523047"
    }
  ]
}

Where status is one of the supported:

payment_initiated, payment_successful, payment_failed, registration_in_progress, registered, transferred, transfer_started, transfer_completed, transfer_ack, transfer_success, transfer_failed

Check Order Status

GET /orders/{order_id}/status — Checks and updates the current status of an order. Description Checks and updates the current status of an order. Path Parameters

order_id (required): Order UUID

Authentication Required (JWT) Example request

curl -X GET \
"https://api.goentri.com/enterprise/sell/v1/orders/5c819665-2f7a-48c7-8c7b-fabd46f9235f/status" \
-H "Authorization: Bearer <AUTH_TOKEN>" \
-H "applicationId: <YOUR_APPLICATION_ID>" \
-H "Accept: application/json"

Example response

{
  "status": "registered"
}

Where status is one of the supported:

payment_initiated, payment_successful, payment_failed, registration_in_progress, registered, transferred, transfer_started, transfer_completed, transfer_ack, transfer_success, transfer_failed

Webhook Notifications

When your users go through the Sell flow, Entri will send you webhook notifications to update you on their progress and the status of their purchase. To learn more about the configuration and webhook notifications, please visit our webhook documentation page.

Errors

All errors from the API are returned in a standard JSON structure. The respective HTTP status code is also returned part of the HTTP response headers. Format:

{
  "message": "Error description"
}

message – human-readable description of the error

Security

IP Safelisting

The Entri Sell Enterprise API supports optional IP safelisting. If configured, only requests from approved IPs or CIDR ranges will be accepted. To request or update your safelist, please contact our support team with the IP addresses you would like to register.

Billing Integration

Link to Entri Billing from Your Customer Dashboard

For a streamlined customer experience, you should provide your users with direct access to Entri’s billing management interface. When displaying a customer account (created via Entri Sell) inside your own dashboard, include a “Manage Billing” link or button that opens the following URL in a new browser tab:

https://billing.entri.com/

This allows customers to review invoices, update payment details, and manage billing without leaving your platform.

Documentation

Security

​Overview

​Request Structure

​Authentication

​1) Create a JWT

​2) Call the API with the JWT

​Notes

​Domains – Search

​Check Domain Availability

​Retrieve Domain Suggestions

​Domains – Management

​Retrieve List of Domains

​Retrieve Single Domain

​Update Domain Automatic Renewal Status

​Resend Registrant Verification Email

​Retrieve Domain DNS Records

​Update Domain DNS Records

​Domain Transfer In

​Domain Transfer Out

​Orders

​Validate Whois Contacts

​Retrieve Orders

​Place New Order

​loadPayment(payment_data)

​Retrieve Single Order

​Check Order Status

​Webhook Notifications

​Errors

​Security

​IP Safelisting

​Billing Integration

​Link to Entri Billing from Your Customer Dashboard

Overview

Request Structure

Authentication

1) Create a JWT

2) Call the API with the JWT

Notes

Domains – Search

Check Domain Availability

Retrieve Domain Suggestions

Domains – Management

Retrieve List of Domains

Retrieve Single Domain

Update Domain Automatic Renewal Status

Resend Registrant Verification Email

Retrieve Domain DNS Records

Update Domain DNS Records

Domain Transfer In

Domain Transfer Out

Orders

Validate Whois Contacts

Retrieve Orders

Place New Order

loadPayment(payment_data)

Retrieve Single Order

Check Order Status

Webhook Notifications

Errors

Security

IP Safelisting

Billing Integration

Link to Entri Billing from Your Customer Dashboard