For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Docs

Get a checkout domain

Returns a checkout domain using its ID.

GET /checkout-domains/{domain_id}
Returns a checkout domain using its ID. The response includes the domain's approval status and payment method verification details.

Path parameters

domain_idstringrequired
Paddle ID of the checkout domain entity to work with.

Response (200)

dataobjectrequired
Represents a checkout domain entity.
idstringrequired
Example: chedom_01kkertpke0gv2t61p1pq8v23x
Unique Paddle ID for this checkout domain entity, prefixed with chedom_.
Pattern: ^chedom_[a-z\d]{26}$
domainstring (hostname)required
Example: example.com
Checkout domain name.
statusstringrequired
Approval status of this checkout domain. Checkout domains are created as pending_review. Other statuses are automatically set by Paddle when reviewing the domain.
Values
  • pending_review
    Domain is newly added and is pending review.
  • approved
    Domain has been approved and can be used for checkouts.
  • rejected
    Domain has been rejected and cannot be used for checkouts.
  • in_review
    Domain is currently under review by Paddle.
payment_method_verificationobjectrequired
Payment method verification status for this checkout domain.
apple_payobjectrequired
Apple Pay verification status for this checkout domain.
statusstringrequired
Payment method verification status for this checkout domain.
Values
  • verified
    Payment method is verified for this checkout domain.
  • unverified
    Payment method isn't verified for this checkout domain.
created_atstring (date-time)required
Example: 2024-10-12T07:20:50.52Z
RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.
updated_atstring (date-time)required
Example: 2024-10-13T07:20:50.52Z
RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
metaobjectrequired
Information about this response.
request_idstringrequired
Example: b15ec92e-8688-40d4-a04d-f44cbec93355
Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
Response
{
  "data": {
    "id": "chedom_01j2abc3def4ghi5jkl6mno7pq",
    "domain": "app.example.com",
    "status": "approved",
    "payment_method_verification": {
      "apple_pay": {
        "status": "verified"
      }
    },
    "created_at": "2026-03-04T12:00:00.000Z",
    "updated_at": "2026-03-04T14:30:00.000Z"
  },
  "meta": {
    "request_id": "b15ec92e-8688-40d4-a04d-f44cbec93355"
  }
}

Was this page helpful?