# DNSMint API API

**Canonical:** https://apis.io/apis/dnsmint-com/dnsmint-api-api/  
**Provider:** DNSMint — https://apis.io/providers/dnsmint-com/  
**Base URL:** https://dnsmint.com/api  
**Documentation:** https://dnsmint.com/api-reference

DNSMint API API is one of 2 APIs that [DNSMint](https://apis.io/providers/dnsmint-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

DNSMint turns an IP address into a stable hostname on a domain we operate, served by our authoritative DNS. Register an IP with one call, point your ACME client at the hostname, and update the IP whenever it changes while the name and certificate stay the same.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/hostnames` | Register an IP and mint a hostname |
| GET | `/v1/hostnames` | List this team's hostnames |
| GET | `/v1/hostnames/{id}` | Read one hostname |
| PUT | `/v1/hostnames/{id}` | Set the hostname IP |
| DELETE | `/v1/hostnames/{id}` | Release a hostname |
| POST | `/v1/hostnames/{id}/acme-credential` | Mint an acme-dns credential scoped to this hostname |
| GET | `/v1/hostnames/{id}/records` | List records under a hostname |
| POST | `/v1/hostnames/{id}/records` | Add a record under a hostname |
| PUT | `/v1/hostnames/{id}/records/{record_id}` | Change a record's value |
| DELETE | `/v1/hostnames/{id}/records/{record_id}` | Delete a record |
| GET | `/v1/hostnames/{id}/certificate` | Fetch the current certificate, with its key when we hold one |
| POST | `/v1/hostnames/{id}/certificate` | Order a certificate from your own CSR |
| POST | `/v1/hostnames/{id}/acme-challenge` | Publish a DNS-01 challenge value with the API key |
| DELETE | `/v1/hostnames/{id}/acme-challenge` | Withdraw a DNS-01 challenge value |
| POST | `/httpreq/present` | lego httpreq provider: publish a challenge |
| POST | `/httpreq/cleanup` | lego httpreq provider: withdraw a challenge |
| POST | `/acme/update` | Publish a DNS-01 challenge (acme-dns wire protocol) |
| GET | `/v1/keys` | List API keys |
| POST | `/v1/keys` | Create an API key |
| PUT | `/v1/keys/{key_id}` | Rename an API key |
| DELETE | `/v1/keys/{key_id}` | Revoke an API key |
| GET | `/v1/hostnames/{id}/diagnose` | Why a hostname is not working |
| POST | `/v1/billing/checkout` | Start a checkout |
| GET | `/v1/billing/checkout` | What the plan allows, and whether a checkout is outstanding |
| GET | `/v1/provisioning` | Is a domain being registered for this account? |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/dnsmint-com/openapi/_original/dnsmint-com-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-create-record-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-create-hostname-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-host-view-schema.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-register-ip-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-managed-certificate-schema.json
- **JSONSchema** — https://artifacts.apis.io/dnsmint-com/json-schema/dnsmint-com-provisioning-status-schema.json

## Other DNSMint APIs (1)

- [DNSMint API](https://apis.io/apis/dnsmint-com/dnsmint-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dnsmint-com/dnsmint-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dnsmint-com/.