Look up a Cloudflare zone ID by domain name and list zones with filtering and pagination via the API

Documented steps

1. Authenticate with an API token holding the 'Zone Read' permission scope; send it on every request as header `Authorization: Bearer $CLOUDFLARE_API_TOKEN`.
2. To find a zone ID by domain, call GET https://api.cloudflare.com/client/v4/zones?name=example.com — the `name` query parameter is an exact-match filter on the domain name (Punycode form).
3. For partial matching use operator suffixes: `name.contains=example`, `name.starts_with=api`, `name.ends_with=.com` (plus case-sensitive variants). Combine multiple filters with `match=any` or `match=all`.
4. Filter by zone state with `status` (initializing | pending | active | moved) and by zone type with `type` (comma-separated: full, partial, secondary, internal).
5. Sort with `order` (name | status | account.id | account.name | plan.id) and `direction` (asc | desc).
6. Paginate with `page` and `per_page`. The response carries a `result_info` object with page, per_page, count, total_count and total_pages — use total_pages to decide whether to fetch more.
7. Parse the standard envelope {"success":bool,"result":[{Zone}],"result_info":{...},"errors":[],"messages":[]}. Take result[0].id as the zone ID and result[0].status to confirm the zone is active.
8. Optionally re-read a single zone with GET https://api.cloudflare.com/client/v4/zones/{zone_id}, which returns the same Zone object shape in the same envelope. Docs: https://developers.cloudflare.com/api/resources/zones/methods/list/ and https://developers.cloudflare.com/api/resources/zones/methods/get/