# Hostingsurge Certificates API **Canonical:** https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/ **Provider:** Hostingsurge — https://apis.io/providers/hostingsurge-com/ **Base URL:** https://hostingsurge.com/api/v1 **Documentation:** https://hostingsurge.com/developers Hostingsurge Certificates API is one of 37 APIs that [Hostingsurge](https://apis.io/providers/hostingsurge-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Certificates. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas. The Certificates API from Hostingsurge — 26 operation(s) for certificates. ## Operations (31) | Method | Path | Summary | |---|---|---| | GET | `/certificates` | Every hostname your projects serve with the certificate the proxy presents… | | POST | `/certificates/check` | Probe one of your hostnames now (TLS handshake against the platform) | | POST | `/certificates/validate` | Dry run of an upload: parsed certificate, blocking problems, warnings and the… | | POST | `/certificates/managed` | Bring your own certificate for verified domains: certificate + chain +… | | GET | `/certificates/managed/{certificateId}` | One managed certificate | | DELETE | `/certificates/managed/{certificateId}` | Remove a managed certificate; the hostnames fall back to automatic Let's… | | POST | `/certificates/managed/{certificateId}/replace` | Replace a managed certificate with a renewed one (same rules as an upload) | | GET | `/certificates/acme` | Free certificate requests (issued by the platform, DNS-01) | | POST | `/certificates/acme` | Request a free certificate (wildcards allowed) for your verified domains at any… | | GET | `/certificates/acme/{requestId}` | One free certificate request | | DELETE | `/certificates/acme/{requestId}` | Cancel a free certificate request | | POST | `/certificates/acme/{requestId}/verify` | Check the _acme-challenge CNAME record(s) now; issuance starts within a minute… | | GET | `/certificates/products` | Paid certificates for sale (DV/OV/EV, wildcard, multi-domain) | | GET | `/certificates/orders` | Your certificate orders (without history; see GET /certificates/orders/{id}) | | POST | `/certificates/orders` | Create a draft order (price fixed). | | GET | `/certificates/orders/{orderId}` | One order with its validation instructions and history | | POST | `/certificates/orders/{orderId}/submit` | Place the order: payment (charges the team's saved card), then the certificate… | | POST | `/certificates/orders/{orderId}/refresh` | Ask the certificate authority for the current status now (issued certificates… | | POST | `/certificates/orders/{orderId}/cancel` | Cancel an order that is not issued yet | | POST | `/certificates/orders/{orderId}/renew` | Create a renewal (draft) for an issued certificate; it replaces the current one… | | GET | `/operator/certificates` | Platform operators: every hostname of every team and of the platform, managed… | | GET | `/operator/certificates/orders` | Platform operators: every certificate order | | GET | `/operator/certificates/products` | Platform operators: the price list (all products) | | POST | `/operator/certificates/products` | Platform operators: create or update a price-list entry (fresh session and a… | | GET | `/operator/certificates/reseller-products` | Platform operators: the reseller's catalog with purchase prices | | POST | `/operator/certificates/orders/{orderId}/mark-paid` | Platform operators: confirm payment of an order (until billing is wired); the… | | POST | `/operator/certificates/orders/{orderId}/mark-refunded` | Platform operators: record a refund (an installed certificate is withdrawn) | | POST | `/operator/certificates/orders/{orderId}/cancel` | Platform operators: cancel an order that is not issued yet | | GET | `/operator/certificates/log` | Platform operators: price-list and payment decisions | | POST | `/operator/certificates/platform/acme` | Platform operators: a free certificate for the platform's own hostnames, held… | | POST | `/operator/certificates/platform/managed` | Platform operators: upload a certificate for the platform's own hostnames, held… | ## Machine-readable artifacts (7) - **OpenAPI** — https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-certificates-api-openapi.yml - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json ## Other Hostingsurge APIs (12) - [Hostingsurge Accelerator API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-accelerator-api/) - [Hostingsurge Agents API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-agents-api/) - [Hostingsurge Alerts API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-alerts-api/) - [Hostingsurge Analytics API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-analytics-api/) - [Hostingsurge Assistant API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-assistant-api/) - [Hostingsurge Automation API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-automation-api/) - [Hostingsurge Backups API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-backups-api/) - [Hostingsurge Billing API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-billing-api/) - [Hostingsurge Builder API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/) - [Hostingsurge Business API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-business-api/) - [Hostingsurge Databases API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-databases-api/) - [Hostingsurge Deployments API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-deployments-api/) ## Tags Certificates --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hostingsurge-com/.