canonical: https://jentic.com/apis/ote-godaddy.com/subscriptions

# GoDaddy (OTE Test Environment) GoDaddy Subscriptions API (OTE)

The GoDaddy Subscriptions API (OTE - Operational Test Environment) provides programmatic access to recurring subscriptions and services including domains, hosting, SSL certificates, email services, and other GoDaddy products. This test environment allows developers to retrieve subscription details, manage renewals, check expiration dates, and access add-ons before deploying to production. Subscriptions represent ongoing services that require periodic renewal and payment.

## For AI agents

Manage GoDaddy subscriptions: list active services, retrieve subscription details, check expiration dates, and manage renewals for domains, hosting, and other products in the OTE test environment.

## Scope

Does not process payments, create new subscriptions, or perform product-specific operations - use only for retrieving and monitoring existing subscriptions.

## Capabilities

- List all subscriptions for an account with filtering by product group
- Retrieve detailed information for a specific subscription including pricing and renewal options
- Check subscription expiration dates and renewal status
- Access subscription add-ons and related services
- Filter and sort subscriptions by expiration date or product category
- Paginate through large subscription lists with configurable limits and offsets

## Use cases

### Subscription Renewal Management

Operations teams can monitor subscriptions approaching expiration and automate renewal workflows. GET `/v1/subscriptions` returns all subscriptions with expiration dates, and sorting by -expiresAt (descending) surfaces subscriptions expiring soonest. Agents can filter by product group to focus on critical services like domains or SSL certificates and trigger renewal reminders or automated renewals.

Example prompt: GET `/v1/subscriptions` with sort=-expiresAt to retrieve subscriptions by expiration, filter for those expiring within 30 days, then trigger renewal workflows or notifications.

### Customer Subscription Portal

SaaS platforms managing services for customers can provide subscription visibility through their own interfaces. GET `/v1/subscriptions` with X-Shopper-Id header retrieves subscriptions per customer account, and GET `/v1/subscriptions/{subscriptionId}` provides detailed subscription information including add-ons and renewal options. Resellers can build white-label subscription management interfaces.

Example prompt: GET `/v1/subscriptions` with X-Shopper-Id for the customer account, then GET `/v1/subscriptions/{subscriptionId}` for detailed information including renewal options and add-ons.

### Multi-Product Subscription Tracking

Agencies managing diverse GoDaddy services for clients can track subscriptions across product categories including domains, hosting, SSL, email, and more. The productGroupKeys parameter filters subscriptions by type, and the includes parameter adds details about add-ons and relations. This enables comprehensive service inventory management and cost tracking across client portfolios.

Example prompt: GET `/v1/subscriptions` with productGroupKeys=['domains'] to list domain subscriptions, then repeat with other product groups to build a complete inventory.

### AI Agent for Subscription Operations

Let an AI agent handle subscription inquiries for a web agency - listing active services, checking expiration dates, and identifying renewal opportunities. Through Jentic, the agent loads only the required operations and the GoDaddy API key is injected at execution time.

Example prompt: Use the Jentic search query 'list godaddy subscriptions' to find GET `/v1/subscriptions`, load its schema, and execute with filtering and sorting parameters.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v1/subscriptions` | List subscriptions with filtering by product group and sorting by expiration |
| GET | `/v1/subscriptions/{subscriptionId}` | Get detailed information for a specific subscription |
| DELETE | `/v1/subscriptions/{subscriptionId}` | Cancel a subscription |

## Key resources

- **Subscriptions** — Recurring services including domains, hosting, SSL certificates, email, and other GoDaddy products
- **Subscription Details** — Pricing, renewal options, expiration dates, and billing information
- **Add-ons** — Additional services or features attached to subscriptions
- **Product Groups** — Categories of subscriptions (domains, hosting, SSL, email, etc.)
- **Renewal Options** — Available renewal periods and pricing for subscriptions

## Why Jentic

- **Setup:** Wiring the GoDaddy Subscriptions API by hand means setting up the GoDaddy API key and secret pair, targeting the api.godaddy.com host, and handling retries yourself around subscription reads. Through Jentic you install once, import the GoDaddy Subscriptions API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** The Subscriptions API puts the subscription id in the URL path (`/v1/subscriptions/{subscriptionId}`), so a rule can pin your agent to reading one subscription. You choose the operations it may call, so subscription cancellation is not included unless you add it, and a monitoring agent can list and read without cancelling anything.
- **Credential handling:** Your GoDaddy API key and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list active subscriptions' or 'check the status of one subscription', and Jentic returns the matching GoDaddy Subscriptions operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **GoDaddy Domains API (OTE)** — Manages domain registration and renewal operations for domain subscriptions.
- **GoDaddy Orders API (OTE)** — Tracks purchase history and billing for subscription renewals.
- **Stripe API** — Alternative subscription and billing management for SaaS platforms.

## FAQ

### What is the GoDaddy OTE environment?

OTE (Operational Test Environment) is GoDaddy's sandbox for development and testing. It mirrors the production API but operates on test data and test subscriptions. No real charges or service changes occur in OTE.

### What types of subscriptions can I manage?

The API covers all recurring GoDaddy services including domain registrations, hosting plans, SSL certificates, email services, website builders, and other products that require periodic renewal.

### How do I renew a subscription through the API?

The Subscriptions API provides subscription details and renewal options. Actual renewal operations are performed through the specific product APIs (e.g., Domains API for domain renewals) using the subscription information.

### Can I retrieve subscriptions for other GoDaddy accounts?

Yes, resellers and agencies can use the X-Shopper-Id header to retrieve subscriptions for customer accounts they manage. This requires appropriate delegated access permissions.

### What is the difference between subscriptions and orders?

Orders represent one-time purchases and transactions, while subscriptions represent ongoing services that renew periodically. The Orders API tracks purchase history; the Subscriptions API tracks active services requiring renewal.