Openprovider TldService API
The TldService API from Openprovider — 2 operation(s) for tldservice.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/openprovider-tldservice-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: REST AdditionalData Tld Service API
version: 1.0.0-beta
servers:
- url: https://api.openprovider.eu
security:
- Bearer: []
tags:
- name: TldService
x-displayName: Tld
paths:
/v1beta/tlds:
get:
tags:
- TldService
summary: List tlds
operationId: ListTlds
parameters:
- description: Search query limit.
name: limit
in: query
schema:
type: integer
format: int32
- description: Search query offset.
name: offset
in: query
schema:
type: integer
format: int32
- description: Sorts output ASC or DESC.
name: order
in: query
schema:
type: string
- description: Sorts output by a field.
name: order_by
in: query
schema:
type: string
- description: Array of extensions.
name: extensions
in: query
style: form
explode: true
schema:
type: array
items:
type: string
- description: Extension name pattern. Wildcard (*) can be used.
name: name_pattern
in: query
schema:
type: string
- description: Returns only extension names in the output.
name: only_names
in: query
schema:
type: boolean
format: boolean
- description: Returns additional extension description.
name: with_description
in: query
schema:
type: boolean
format: boolean
- description: Returns list of extension restrictions.
name: with_restrictions
in: query
schema:
type: boolean
format: boolean
- description: Returns number of domains using specified extension in this account.
name: with_usage_count
in: query
schema:
type: boolean
format: boolean
- description: Array of extension application modes.
name: with_application_mode
in: query
style: form
explode: true
schema:
type: array
items:
type: string
- description: Returns extension prices.
name: with_price
in: query
schema:
type: boolean
format: boolean
- description: Returns extension prices for each Openprovider discount tier.
name: with_level_prices
in: query
schema:
type: boolean
format: boolean
- description: Indicates, if extension is active.
name: is_active
in: query
schema:
type: boolean
format: boolean
- description: Indicates, if extension is a newGTLD.
name: is_new_gtld
in: query
schema:
type: boolean
format: boolean
- description: Extension status.
name: status
in: query
schema:
type: string
- description: Pre-registration mode.
name: application_mode
in: query
schema:
type: string
responses:
'200':
description: A successful response.
content:
application/json:
schema:
$ref: '#/components/schemas/tldListTldsResponse'
default:
description: (empty)
content:
application/json:
schema:
$ref: '#/components/schemas/errorError'
/v1beta/tlds/{name}:
get:
tags:
- TldService
summary: Get tld
operationId: GetTld
parameters:
- description: Extension name
name: name
in: path
required: true
schema:
type: string
- description: Search query limit.
name: limit
in: query
schema:
type: integer
format: int32
- description: Search query offset.
name: offset
in: query
schema:
type: integer
format: int32
- description: Returns additional extension description.
name: with_description
in: query
schema:
type: boolean
format: boolean
- description: Returns list of extension restrictions.
name: with_restrictions
in: query
schema:
type: boolean
format: boolean
- description: Returns extension prices.
name: with_price
in: query
schema:
type: boolean
format: boolean
- description: Returns extension prices for each Openprovider discount tier.
name: with_level_prices
in: query
schema:
type: boolean
format: boolean
- description: Returns number of domains using specified extension in this account.
name: with_usage_count
in: query
schema:
type: boolean
format: boolean
- description: Extension status.
name: status
in: query
style: form
explode: true
schema:
type: array
items:
type: string
responses:
'200':
description: A successful response.
content:
application/json:
schema:
$ref: '#/components/schemas/tldGetTldResponse'
default:
description: (empty)
content:
application/json:
schema:
$ref: '#/components/schemas/errorError'
components:
schemas:
tldPrice:
type: object
title: Price
properties:
product:
title: Price in product currency
$ref: '#/components/schemas/tldPriceInCurrency'
reseller:
title: Price in reseller's currency
$ref: '#/components/schemas/tldPriceInCurrency'
example:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
tldDescription:
type: object
title: Description
properties:
text:
type: string
title: Description text
url:
type: string
title: Url
example:
text: <p>La extensión de nombre de dominio .BIZ es el dominio de primer nivel orientado al sector de los negocios. La extensión de dominio .BIZ es utilizada por empresas que desean una única presencia en Internet. La extensión .BIZ ha sido desarrollada para promocionar la nueva generación de comercio electrónico, y de aplicaciones Internet.</p>
url: http://www.neustarregistry.biz
tldTld:
type: object
title: Tld
properties:
admin_handle_supported:
type: boolean
format: boolean
title: Indicates, if administrative domain handle is supported in specified extension
billing_handle_enabled:
type: boolean
format: boolean
title: Indicates, if billing domain handle is supported in specified extension
billing_handle_supported:
type: boolean
format: boolean
title: Indicates, if billing domain handle is supported in specified extension
description:
title: Extension description
$ref: '#/components/schemas/tldDescription'
dnssec_algorithms:
type: array
title: List of supported DNSSEC algorithms
items:
type: integer
format: int32
dnssec_allowed:
type: boolean
format: boolean
title: Indicates, if DNSSEC is supported by entension
dnssec_digests_allowed:
type: boolean
format: boolean
title: Indicates, if DNSSEC digests are supported by entension
dnssec_keys_allowed:
type: boolean
format: boolean
title: Indicates, if DNSSEC keys are supported by entension
dnssec_max_records_amount:
type: integer
format: int32
title: Indicates, how many DNSSEC records are allowed for the extension
domicile_available:
type: boolean
format: boolean
title: Indicates, if local presence service (domicile) is available for the extension
is_auth_code_available:
type: boolean
format: boolean
title: Indicates, if authcodes are supported by extension
is_auth_code_changeable:
type: boolean
format: boolean
title: Indicates, if authcode can be changed
is_auth_code_requested:
type: boolean
format: boolean
title: Indicates, if authcode can be requested
is_private_whois_allowed:
type: boolean
format: boolean
title: Indicates, if whois privacy protection service is available for the extension
is_trade_auth_code_required:
type: boolean
format: boolean
title: Indicates, if authcode is required for domain trade operation
is_transfer_auth_code_required:
type: boolean
format: boolean
title: Indicates, if authcode is required for domain transfer operation
level_prices:
type: array
title: List of prices by discount tier
items:
$ref: '#/components/schemas/tldLevelPrice'
max_period:
type: integer
format: int32
title: Maximal operation period
min_period:
type: integer
format: int32
title: Minimal operation period
name:
type: string
title: Extension name
owner_handle_supported:
type: boolean
format: boolean
title: Indicates, if domain owner handle is supported in specified extension
prices:
title: Array of prices
$ref: '#/components/schemas/tldPrices'
quarantine_period:
type: integer
format: int32
title: Extension hard quarantine period
renew_available:
type: boolean
format: boolean
title: Indicates, if domain renew is supported by extension
reseller_handle_enabled:
type: boolean
format: boolean
title: Indicates, if domain reseller handle is supported in specified extension
reseller_handle_supported:
type: boolean
format: boolean
title: Indicates, if domain reseller handle is supported in specified extension
restrictions:
type: array
title: Extension restrictions
items:
type: string
soft_quarantine_period:
type: integer
format: int32
title: Extension soft quarantine period
status:
type: string
title: Extension status
supported_application_mode:
type: array
title: List of supported pre-regitration modes
items:
$ref: '#/components/schemas/tldApplicationMode'
supported_idn_scripts:
type: array
title: List of supported IDN scripts
items:
$ref: '#/components/schemas/tldIdnScript'
tech_handle_supported:
type: boolean
format: boolean
title: Indicates, if domain technical handle is supported in specified extension
trade_available:
type: boolean
format: boolean
title: Indicates, if domain trade is supported by extension
transfer_available:
type: boolean
format: boolean
title: Indicates, if domain transfer is supported by extension
usage_count:
type: integer
format: int32
title: Returns count of domains using specified extension
example:
admin_handle_supported: false
billing_handle_enabled: false
billing_handle_supported: false
description:
text: <p>La extensión de nombre de dominio .BIZ es el dominio de primer nivel orientado al sector de los negocios. La extensión de dominio .BIZ es utilizada por empresas que desean una única presencia en Internet. La extensión .BIZ ha sido desarrollada para promocionar la nueva generación de comercio electrónico, y de aplicaciones Internet.</p>
url: http://www.neustarregistry.biz
dnssec_algorithms:
- 3
dnssec_allowed: false
dnssec_digests_allowed: false
dnssec_keys_allowed: false
dnssec_max_records_amount: 0
domicile_available: false
is_auth_code_available: false
is_auth_code_changeable: false
is_auth_code_requested: false
is_private_whois_allowed: false
is_trade_auth_code_required: true
is_transfer_auth_code_required: true
level_prices:
- level: 1
price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
name: eu
owner_handle_supported: false
prices:
create_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
domicile_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
renew_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
reseller_price:
product:
currency: USD
price: 226
promotion_details:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
reseller:
currency: USD
price: 226
restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
setup_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
soft_restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
trade_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
transfer_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
update_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
quarantine_period: 38
renew_available: false
reseller_handle_enabled: false
reseller_handle_supported: false
restrictions:
- Los dominios premium (cortos y nombres genéricos) son más caros para registros y renovaciones
soft_quarantine_period: 44
status: ACT
supported_application_mode:
- name: claims
title: General Availability
supported_idn_scripts:
- description: Afrikaans
value: AFR
tech_handle_supported: false
trade_available: false
transfer_available: false
usage_count: 0
tldLevelPrice:
type: object
title: LevelPrice
properties:
level:
type: integer
format: int32
title: Openprovider discount tier
price:
title: Tiered price
$ref: '#/components/schemas/tldPrice'
example:
level: 1
price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
tldPriceInCurrency:
type: object
title: PriceInCurrency
properties:
currency:
type: string
title: Price currency
price:
type: number
format: double
title: Price in specified currency
example:
currency: USD
price: 226
tldPriceWithPromoInfo:
type: object
title: PriceWithPromoInfo
properties:
product:
title: Price in product currency
$ref: '#/components/schemas/tldPriceInCurrency'
promotion_details:
title: Additional info about current promotion
$ref: '#/components/schemas/tldPromoDetails'
reseller:
title: Price in reseller's currency
$ref: '#/components/schemas/tldPriceInCurrency'
example:
product:
currency: USD
price: 226
promotion_details:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
reseller:
currency: USD
price: 226
tldIdnScript:
type: object
title: IdnScript
properties:
description:
type: string
title: IDN script description
value:
type: string
title: IDN script parameter value
example:
description: Afrikaans
value: AFR
tldGetTldResponse:
type: object
title: GetTldResponse
properties:
code:
type: integer
format: int32
title: Response code
data:
title: Response data
$ref: '#/components/schemas/tldTld'
desc:
type: string
title: Response description
maintenance:
type: boolean
format: boolean
title: Indicates, if Openprovider API is on maintenance
warnings:
type: array
title: Array of warning messages
items:
$ref: '#/components/schemas/errorWarning'
example:
code: 0
data:
admin_handle_supported: false
billing_handle_enabled: false
billing_handle_supported: false
description:
text: <p>La extensión de nombre de dominio .BIZ es el dominio de primer nivel orientado al sector de los negocios. La extensión de dominio .BIZ es utilizada por empresas que desean una única presencia en Internet. La extensión .BIZ ha sido desarrollada para promocionar la nueva generación de comercio electrónico, y de aplicaciones Internet.</p>
url: http://www.neustarregistry.biz
dnssec_algorithms:
- 3
dnssec_allowed: false
dnssec_digests_allowed: false
dnssec_keys_allowed: false
dnssec_max_records_amount: 0
domicile_available: false
is_auth_code_available: false
is_auth_code_changeable: false
is_auth_code_requested: false
is_private_whois_allowed: false
is_trade_auth_code_required: true
is_transfer_auth_code_required: true
level_prices:
- level: 1
price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
name: eu
owner_handle_supported: false
prices:
create_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
domicile_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
renew_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
reseller_price:
product:
currency: USD
price: 226
promotion_details:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
reseller:
currency: USD
price: 226
restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
setup_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
soft_restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
trade_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
transfer_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
update_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
quarantine_period: 38
renew_available: false
reseller_handle_enabled: false
reseller_handle_supported: false
restrictions:
- Los dominios premium (cortos y nombres genéricos) son más caros para registros y renovaciones
soft_quarantine_period: 44
status: ACT
supported_application_mode:
- name: claims
title: General Availability
supported_idn_scripts:
- description: Afrikaans
value: AFR
tech_handle_supported: false
trade_available: false
transfer_available: false
usage_count: 0
desc: ''
errorError:
type: object
title: Error
properties:
code:
type: integer
format: int32
title: Error code
data:
type: string
title: Additional error description
desc:
type: string
title: Error description
example:
code: 0
data: ''
desc: ''
tldListTldsResponse:
type: object
title: ListTldsResponse
properties:
code:
type: integer
format: int32
title: Response code
data:
title: Response data
$ref: '#/components/schemas/tldListTldsResponseData'
desc:
type: string
title: Response description
maintenance:
type: boolean
format: boolean
title: Indicates, if Openprovider API is on maintenance
warnings:
type: array
title: Array of warning messages
items:
$ref: '#/components/schemas/errorWarning'
example:
code: 0
data:
results:
- admin_handle_supported: false
billing_handle_enabled: false
billing_handle_supported: false
description:
text: <p>La extensión de nombre de dominio .BIZ es el dominio de primer nivel orientado al sector de los negocios. La extensión de dominio .BIZ es utilizada por empresas que desean una única presencia en Internet. La extensión .BIZ ha sido desarrollada para promocionar la nueva generación de comercio electrónico, y de aplicaciones Internet.</p>
url: http://www.neustarregistry.biz
dnssec_algorithms:
- 3
dnssec_allowed: false
dnssec_digests_allowed: false
dnssec_keys_allowed: false
dnssec_max_records_amount: 0
domicile_available: false
is_auth_code_available: false
is_auth_code_changeable: false
is_auth_code_requested: false
is_private_whois_allowed: false
is_trade_auth_code_required: true
is_transfer_auth_code_required: true
level_prices:
- level: 1
price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
name: eu
owner_handle_supported: false
prices:
create_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
domicile_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
renew_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
reseller_price:
product:
currency: USD
price: 226
promotion_details:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
reseller:
currency: USD
price: 226
restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
setup_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
soft_restore_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
trade_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
transfer_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
update_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
quarantine_period: 38
renew_available: false
reseller_handle_enabled: false
reseller_handle_supported: false
restrictions:
- Los dominios premium (cortos y nombres genéricos) son más caros para registros y renovaciones
soft_quarantine_period: 44
status: ACT
supported_application_mode:
- name: claims
title: General Availability
supported_idn_scripts:
- description: Afrikaans
value: AFR
tech_handle_supported: false
trade_available: false
transfer_available: false
usage_count: 0
total: 999
desc: ''
tldPromoDetails:
type: object
title: PromoDetails
properties:
end_date:
type: string
title: Date when promotion is end
non_promo_price:
title: Domain regular price without promotions
$ref: '#/components/schemas/tldPrice'
start_date:
type: string
title: Date when promotion is start
example:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
tldApplicationMode:
type: object
title: ApplicationMode
properties:
name:
type: string
title: Application mode name
title:
type: string
title: Pre-registration mode title
example:
name: claims
title: General Availability
tldListTldsResponseData:
type: object
title: ListTldsResponseData
properties:
results:
type: array
title: Array of results
items:
$ref: '#/components/schemas/tldTld'
total:
type: integer
format: int32
title: Results count
example:
results:
- admin_handle_supported: false
billing_handle_enabled: false
billing_handle_supported: false
description:
text: <p>La extensión de nombre de dominio .BIZ es el dominio de primer nivel orientado al sector de los negocios. La extensión de dominio .BIZ es utilizada por empresas que desean una única presencia en Internet. La extensión .BIZ ha sido desarrollada para promocionar la nueva generación de comercio electrónico, y de aplicaciones Internet.</p>
url: http://www.neustarregistry.biz
dnssec_algorithms:
- 3
dnssec_allowed: false
dnssec_digests_allowed: false
dnssec_keys_allowed: false
dnssec_max_records_amount: 0
domicile_available: false
is_auth_code_available: false
is_auth_code_changeable: false
is_auth_code_requested: false
is_private_whois_allowed: false
is_trade_auth_code_required: true
is_transfer_auth_code_required: true
level_prices:
- level: 1
price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
name: eu
owner_handle_supported: false
prices:
create_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
domicile_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
max_period: 10
min_period: 1
renew_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
reseller_price:
product:
currency: USD
price: 226
promotion_details:
end_date: '1589932800'
non_promo_price:
product:
currency: USD
price: 226
reseller:
currency: USD
price: 226
start_date: '1582156800'
reseller:
currency: USD
price: 226
restore_p
# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/openprovider/refs/heads/main/openapi/openprovider-tldservice-api-openapi.yml