# Porkbun API v3 — v3.109 documentation

> Plain-Markdown, agent-readable docs for the Porkbun v3 API. Every page below is generated from the OpenAPI spec, so it never drifts. No JavaScript required.

## Topics

- [Auth](https://porkbun.com/llms/auth) (1) — Token-based authentication
- [Account](https://porkbun.com/llms/account) (17) — Account credit balance, API spend controls, and onboarding
- [Domain](https://porkbun.com/llms/domain) (31) — Domain availability (single or up to 25 at once), registration, nameservers, URL forwarding, glue records, and auto-renewal
- [Porkbun DNS](https://porkbun.com/llms/porkbun-dns) (15) — Create, read, update and delete DNS records in **Porkbun's** nameservers, including DNSSEC.
- [SSL](https://porkbun.com/llms/ssl) (2) — Retrieve free SSL certificate bundles for domains registered at Porkbun
- [Hosting](https://porkbun.com/llms/hosting) (35) — Three products share these endpoints; the `sku` you pass to `/hosting/create` picks one
- [Link in Bio](https://porkbun.com/llms/link-in-bio) (14) — A Link in Bio page: a single page of links, served on the domain (or, for the free plan that comes with .com registrations, forwarded to `<domain>.l.ink`). Edits made here show…
- [Agent Naming (ANS)](https://porkbun.com/llms/agent-naming-ans) (16) — **Experimental.** ANS is an emerging standard (a Linux Foundation project; normative specs ANS-0..ANS-6 at https://github.com/agentnameservice/ans-spec, still drafts), and Porkb…
- [Cloudflare](https://porkbun.com/llms/cloudflare) (17) — Move a customer's domains into **their own Cloudflare account**: we create the zone, copy across the DNS records we hold, and repoint the registry nameservers at Cloudflare.
- [Email](https://porkbun.com/llms/email) (10) — Email forwarding (forward an address at the domain to another mailbox) and email hosting (mailboxes: buy, set up, passwords)
- [Closeouts](https://porkbun.com/llms/closeouts) (3) — Expired domains that did not sell at auction, offered at a fixed price with no bidding — first buyer at the current price takes the name.
- [Marketplace](https://porkbun.com/llms/marketplace) (2) — Browse domains listed for sale on Porkbun Marketplace (names Porkbun customers list themselves). To search every aftermarket at once (Afternic, Sedo, Atom, NameBright, DAX and P…
- [Aftermarket](https://porkbun.com/llms/aftermarket) (1) — Registered domains that are for sale: partner aftermarkets (Afternic, Sedo, Atom, NameBright, DAX), Porkbun Marketplace and DAX auctions, in one search. Read-only; buying happen…
- [Pricing](https://porkbun.com/llms/pricing) (2) — Domain pricing across all supported TLDs — no authentication required
- [API Key Management](https://porkbun.com/llms/api-key-management) (8) — Request API keys programmatically (`/apikey/request` + `/apikey/retrieve`, approved by the account holder in the browser), and revoke the key making a call (`/apikey/revoke`).
- [Utility](https://porkbun.com/llms/utility) (4) — IP detection and credential verification
- [Webhooks](https://porkbun.com/llms/webhooks) (11) — Register HTTPS endpoints to receive signed, real-time event notifications.
- [Sandbox](https://porkbun.com/llms/sandbox) (3) — Isolated sandbox/test environment (sandbox API keys, pk1_sb_…).
- [Mock](https://porkbun.com/llms/mock) (2) — Credential-free mock server returning schema-accurate example responses for any endpoint.

## Guides (task-oriented how-tos)

- [Getting started: keys, auth, and your first call](https://porkbun.com/llms/guides/getting-started)
- [Register a domain end-to-end (dry-run + idempotency)](https://porkbun.com/llms/guides/register-a-domain)
- [Dynamic DNS: keep an A record on your current IP](https://porkbun.com/llms/guides/dynamic-dns)
- [Recover a broken DNS zone (restore points, diff, undo)](https://porkbun.com/llms/guides/recover-a-broken-zone)
- [Receive and verify webhooks](https://porkbun.com/llms/guides/verify-a-webhook)
- [Verify a user owns a domain (DomainAttest, no DNS records)](https://porkbun.com/llms/guides/verify-domain-ownership)
- [Set up a customer's DNS for your service (DNS Connect, customer approves)](https://porkbun.com/llms/guides/connect-a-service-to-porkbun-dns)
- [Connect ChatGPT or Claude to Porkbun (hosted MCP, no install)](https://porkbun.com/llms/guides/connect-chatgpt-or-claude)
- [Onboard a user in a mobile/native app (get API keys via PKCE)](https://porkbun.com/llms/guides/onboard-a-mobile-app-user)
- [Launch a website from scratch: name, domain, choosing hosting, building, publishing, going live](https://porkbun.com/llms/guides/launch-a-website)
- [Provision a WordPress site, then edit its pages, posts and images (no WordPress password needed)](https://porkbun.com/llms/guides/publish-to-wordpress)
- [Build a Link in Bio page (free or paid, links, look, what needs a paid plan)](https://porkbun.com/llms/guides/build-a-link-in-bio-page)
- [Give an AI agent a verifiable name (ANS): register, validate, trust tiers, directory, revoke](https://porkbun.com/llms/guides/agent-naming)
- [Verify who published a file: resolve an agent-provenance marker, check the signature and the transparency log, compare the hash](https://porkbun.com/llms/guides/verify-agent-content)
- [Publish content an agent can prove it wrote (mark, build, sign, publish; you keep the key)](https://porkbun.com/llms/guides/publish-agent-content)
- [Agent-published content: the format specification (manifest, detached JWS, provenance marker, verification algorithm)](https://porkbun.com/llms/guides/agent-content-format)
- [Share a website with someone and their AI agent (one domain, approved by you, one-time link, QR code and handoff prompt)](https://porkbun.com/llms/guides/share-site-access)
- [Migrate domains from GoDaddy to Porkbun (beta)](https://porkbun.com/llms/guides/godaddy-migration)
- [Move domains to a customer's own Cloudflare account](https://porkbun.com/llms/guides/move-domains-to-cloudflare)
- [Pay with USDC over x402: buy a domain directly, or add account credit](https://porkbun.com/llms/guides/pay-with-usdc-x402)
- [Pay with the user's card from an agent (MPP, Stripe Link): buy directly with a hold, or add credit](https://porkbun.com/llms/guides/pay-with-card-mpp)
- [Buy a domain from an agent, start to finish (who does what, verifying, every way to pay)](https://porkbun.com/llms/guides/buy-a-domain-from-an-agent)
- [Cap what an agent can spend (the monthly API limit)](https://porkbun.com/llms/guides/spend-limits)
- [Verify an account's email and phone from an agent (VERIFICATION_REQUIRED)](https://porkbun.com/llms/guides/verify-the-account)
- [Set up email forwarding (and when it replaces another mail service)](https://porkbun.com/llms/guides/set-up-email-forwarding)
- [Set up a mailbox (email hosting): the free trial, buying one, passwords](https://porkbun.com/llms/guides/set-up-a-mailbox)
- [Before an agent contacts Porkbun support: what you can do yourself, and how to write to support](https://porkbun.com/llms/guides/contacting-support)

## Everything in one file

- Full Markdown reference: https://porkbun.com/llms-full.txt
- Short overview / index: https://porkbun.com/llms.txt
- OpenAPI 3.0 spec (JSON): https://porkbun.com/api/json/v3/spec

## More

- Short overview (start here): https://porkbun.com/llms.txt
- Guides (how-tos): https://porkbun.com/llms/guides
- Help articles (knowledge base) as Markdown: https://porkbun.com/llms/kb
- Topic index: https://porkbun.com/llms
- Full reference (one file): https://porkbun.com/llms-full.txt
- OpenAPI spec (full schemas): https://porkbun.com/api/json/v3/spec
- Official MCP server: https://porkbun.com/mcp (`npx -y @porkbunllc/mcp-server`)
- Create API keys: https://porkbun.com/account/api
