> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aegister.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Cloud Defender activation steps

> Read where a new domain is in its activation: registered, prepared by Aegister, served through Cloud Defender, traffic flowing, and whether you marked your origin as locked. Add `check=1` to resolve and fetch the domain now instead of reading the last result. It is the checklist on the domain's page in the Cyber Console.



## OpenAPI

````yaml get /api/v1/cloud-defender/{id}/activation
openapi: 3.1.0
info:
  title: Aegister API
  version: 2.10.0
servers: []
security: []
paths:
  /api/v1/cloud-defender/{id}/activation:
    get:
      tags:
        - cloud-defender
      summary: Get Cloud Defender activation steps
      description: >-
        The steps that bring a new domain live: registered, ready (Aegister
        wired it), served through

        Cloud Defender, traffic flowing. With `check=1` the domain is resolved
        and fetched now.
      operationId: cloud_defender_activation_retrieve
      parameters:
        - in: query
          name: check
          schema:
            type: boolean
            default: false
          description: >-
            Check the domain now (DNS and HTTPS) instead of reading the last
            hourly check.
        - in: path
          name: id
          schema:
            type: integer
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 0
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
                  data:
                    type: object
                    properties:
                      fqdn:
                        type: string
                      endpoint:
                        type: string
                        description: 'The origin: an address or a host name.'
                      active:
                        type: boolean
                        description: The last hourly check found the domain up.
                      steps:
                        type: object
                        properties:
                          registered:
                            type: object
                            properties:
                              done:
                                type: boolean
                              at:
                                type:
                                  - string
                                  - 'null'
                                description: When it was done, when known.
                          ready:
                            type: object
                            properties:
                              done:
                                type: boolean
                              at:
                                type:
                                  - string
                                  - 'null'
                                description: When it was done, when known.
                          served:
                            type: object
                            properties:
                              done:
                                type: boolean
                              at:
                                type:
                                  - string
                                  - 'null'
                                description: When it was done, when known.
                          traffic:
                            type: object
                            properties:
                              done:
                                type: boolean
                              at:
                                type:
                                  - string
                                  - 'null'
                                description: When it was done, when known.
                          lock:
                            type: object
                            properties:
                              done:
                                type: boolean
                              at:
                                type:
                                  - string
                                  - 'null'
                                description: When it was done, when known.
                        description: >-
                          `registered` (added), `ready` (Aegister set it up),
                          `served` (it answers through Cloud Defender),
                          `traffic` (requests reach it) and `lock` (the customer
                          marked the origin as taking only Cloud Defender's
                          traffic).
                      probe:
                        type:
                          - object
                          - 'null'
                        properties:
                          addresses:
                            type: array
                            items:
                              type: string
                            description: What the name resolves to now.
                          public:
                            type: boolean
                            description: Every address is public. Only then is it fetched.
                          status:
                            type:
                              - integer
                              - 'null'
                            description: >-
                              The HTTPS status of `/`. Null = not fetched or no
                              answer.
                          protected:
                            type: boolean
                            description: It answers through Cloud Defender.
                        description: The check run now with `check=1`, else null.
              examples:
                Served,WaitingForTheOriginLock:
                  value:
                    error: 0
                    messages: []
                    data:
                      fqdn: www.example.com
                      endpoint: 203.0.113.20
                      active: true
                      steps:
                        registered:
                          done: true
                          at: '2026-10-20T08:00:00+00:00'
                        ready:
                          done: true
                          at: '2026-10-20T10:15:00+00:00'
                        served:
                          done: true
                          at: '2026-10-28 10:00:00.412907+01:00'
                        traffic:
                          done: true
                          at: null
                        lock:
                          done: false
                          at: null
                      probe: null
                  summary: Served, waiting for the origin lock
          description: ''
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.