> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Get checkout domain approval status using the API

Four new operations let you list and inspect the domains approved to serve Paddle Checkout for your account, and trigger Apple Pay verification.

---

## What's new?

We added a new [checkout domain](https://developer.paddle.com/api-reference/checkout-domains.md) entity to the Paddle API, along with four operations to list, get, delete, and verify payment methods for the domains approved to serve Paddle Checkout for your account.

{% api-endpoint method="GET" path="/checkout-domains" href="/api-reference/checkout-domains/list-checkout-domains" /%}
{% api-endpoint method="GET" path="/checkout-domains/{domain_id}" href="/api-reference/checkout-domains/get-checkout-domain" /%}
{% api-endpoint method="DELETE" path="/checkout-domains/{domain_id}" href="/api-reference/checkout-domains/delete-checkout-domain" /%}
{% api-endpoint method="POST" path="/checkout-domains/{domain_id}/verify-payment-method" href="/api-reference/checkout-domains/verify-checkout-domain-payment-method" /%}

List and get operations require the `checkout_domain.read` [permission](https://developer.paddle.com/api-reference/about/permissions.md). Delete and verifying a payment method require `checkout_domain.write`.

## How it works

Checkout domains are the domains that you've submitted for approval to serve [Paddle Checkout](https://developer.paddle.com/concepts/sell/self-serve-checkout.md) for your account. Paddle reviews each domain before it can be used to load a checkout, so customers can only purchase from sites you control.

You can submit domains for approval from the dashboard. Now, you can use the API to track their approval status and manage them:

- **List** returns checkout domains for your account.
- **Get** returns a single checkout domain by ID.
- **Delete** removes a checkout domain. Deleted domains can no longer load checkouts for your account.
- **Verify a payment method** starts payment method verification for an approved domain. Currently supports [Apple Pay](https://developer.paddle.com/concepts/payment-methods/apple-pay.md).

Checkout domain entities include the domain name, its approval status, and the Apple Pay verification status under `payment_method_verification.apple_pay`.

## Next steps

This change is available in version `1` of the Paddle API.

These are new endpoints. There are no breaking changes to existing integrations. Existing API keys don't inherit the new checkout domains permissions, so you'll need to update them.

Make sure your API key has the relevant permission, then call any of the [`/checkout-domains` endpoints](https://developer.paddle.com/api-reference/checkout-domains.md) to inspect or manage your approved domains.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `GET /checkout-domains` | API operation | added | CheckoutDomain | List checkout domains for your account. |
| `GET /checkout-domains/{domain_id}` | API operation | added | CheckoutDomain | Get a checkout domain using its ID. |
| `DELETE /checkout-domains/{domain_id}` | API operation | added | CheckoutDomain | Delete a checkout domain so it can no longer load checkouts for your account. |
| `POST /checkout-domains/{domain_id}/verify-payment-method` | API operation | added | CheckoutDomain | Trigger payment method verification for an approved checkout domain. Currently supports Apple Pay. |
| `checkout_domain.read` | Permission | added | API keys | New permission required to list or get checkout domains. |
| `checkout_domain.write` | Permission | added | API keys | New permission required to delete a checkout domain or verify a payment method for it. |