OrderDetailResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/justdomain-ai/json-schema/justdomain-ai-order-detail-response-schema.json",
  "title": "OrderDetailResponse",
  "x-generated": "2026-11-13",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mcp-openapi.json#/components/schemas/OrderDetailResponse",
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id"
    },
    "registrant_email_verification": {
      "anyOf": [
        {
          "$ref": "#/$defs/RegistrantEmailVerificationView"
        },
        {
          "type": "null"
        }
      ]
    },
    "status": {
      "type": "string",
      "title": "Status"
    },
    "domain": {
      "type": "string",
      "title": "Domain"
    },
    "years": {
      "type": "integer",
      "title": "Years"
    },
    "amount_minor": {
      "type": "integer",
      "title": "Amount Minor"
    },
    "currency": {
      "type": "string",
      "title": "Currency"
    },
    "created_at": {
      "type": "string",
      "title": "Created At"
    },
    "registered_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Registered At"
    },
    "error_message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Error Message"
    },
    "registrant": {
      "anyOf": [
        {
          "$ref": "#/$defs/RegistrantInfo"
        },
        {
          "type": "null"
        }
      ]
    },
    "nameservers": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "title": "Nameservers"
    },
    "can_edit_registrant": {
      "type": "boolean",
      "title": "Can Edit Registrant",
      "default": false
    },
    "can_edit_nameservers": {
      "type": "boolean",
      "title": "Can Edit Nameservers",
      "default": false
    },
    "whois_privacy": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Whois Privacy"
    },
    "whois_privacy_available": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Whois Privacy Available"
    },
    "expires_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Expires At"
    },
    "renew_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Renew By"
    },
    "expiry_checked_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Expiry Checked At"
    },
    "expiry_source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Expiry Source"
    },
    "auto_renew": {
      "anyOf": [
        {
          "$ref": "#/$defs/AutoRenewStateResponse"
        },
        {
          "type": "null"
        }
      ]
    },
    "registrant_change_notice": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Registrant Change Notice"
    },
    "retry_pending": {
      "type": "boolean",
      "title": "Retry Pending",
      "default": false
    }
  },
  "type": "object",
  "required": [
    "order_id",
    "status",
    "domain",
    "years",
    "amount_minor",
    "currency",
    "created_at"
  ],
  "$defs": {
    "AutoRenewStateResponse": {
      "properties": {
        "requested": {
          "type": "boolean",
          "title": "Requested"
        },
        "effective": {
          "type": "boolean",
          "title": "Effective"
        },
        "degrade_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Degrade Reason"
        },
        "card_brand": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Card Brand"
        },
        "card_last4": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Card Last4"
        },
        "billing_pending": {
          "type": "boolean",
          "title": "Billing Pending",
          "default": false
        },
        "can_manage_payment_methods": {
          "type": "boolean",
          "title": "Can Manage Payment Methods",
          "default": false
        }
      },
      "type": "object",
      "required": [
        "requested",
        "effective"
      ],
      "title": "AutoRenewStateResponse",
      "description": "The auto-renew state of one order, as every surface should say it.\n\nMore than a boolean on purpose. `requested` is what the customer asked\nfor and `effective` is what the system can actually do; they differ in\nexactly the case that matters (F1: auto-renew on, nothing we may\ncharge), and a single flag would have to lie in one direction or the\nother.\n\n`billing_pending` is true while the setting is on and the machinery that\nacts on it has not shipped (W5). Any surface that would otherwise\npromise \"on {date} we will charge {amount}\" reads this and says the true\nthing instead. It disappears when automatic billing goes live."
    },
    "RegistrantEmailVerificationView": {
      "properties": {
        "status": {
          "type": "string",
          "enum": [
            "starting",
            "pending",
            "verified",
            "failed"
          ],
          "title": "Status"
        },
        "email": {
          "type": "string",
          "title": "Email"
        },
        "last_sent_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Last Sent At"
        },
        "can_resend_at": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Can Resend At"
        },
        "deadline": {
          "anyOf": [
            {
              "type": "string",
              "format": "date-time"
            },
            {
              "type": "null"
            }
          ],
          "title": "Deadline"
        },
        "suspended": {
          "type": "boolean",
          "title": "Suspended",
          "default": false
        },
        "unpausing": {
          "type": "boolean",
          "title": "Unpausing",
          "default": false
        },
        "window_days": {
          "type": "integer",
          "title": "Window Days",
          "default": 14
        }
      },
      "type": "object",
      "required": [
        "status",
        "email"
      ],
      "title": "RegistrantEmailVerificationView",
      "description": "The owner address's confirmation state on an order (EV-B07 item 6).\n\n`null` on the order when no verification is tracked for its address. The\n14-day window is the registrar's schedule; `deadline` is the registrar's\nown date for THIS domain when it has one, `window_days` comes from the\nregistrar backend's capabilities."
    },
    "RegistrantInfo": {
      "properties": {
        "first_name": {
          "type": "string",
          "title": "First Name"
        },
        "last_name": {
          "type": "string",
          "title": "Last Name"
        },
        "org_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Org Name"
        },
        "email": {
          "type": "string",
          "title": "Email"
        },
        "phone": {
          "type": "string",
          "title": "Phone"
        },
        "country": {
          "type": "string",
          "title": "Country"
        },
        "address1": {
          "type": "string",
          "title": "Address1"
        },
        "city": {
          "type": "string",
          "title": "City"
        },
        "state": {
          "type": "string",
          "title": "State"
        },
        "postal_code": {
          "type": "string",
          "title": "Postal Code"
        },
        "additional_data": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "title": "Additional Data",
          "description": "Extra registrant data a registry demands beyond standard contacts - a .us nexus declaration, an ISOC-IL registrant ID. Keyed by OUR checkout form keys (`us_nexus_category`, `registrant_id`), NOT by a registrar's wire field names: the translation happens in the provider adapter, so a registrar swap does not rewrite the checkout form. Validated against the ending's JSON Schema BEFORE a card is charged - see `shared.services.requirements`."
        }
      },
      "type": "object",
      "required": [
        "first_name",
        "last_name",
        "email",
        "phone",
        "country",
        "address1",
        "city",
        "state",
        "postal_code"
      ],
      "title": "RegistrantInfo",
      "description": "WHOIS registrant contact, persisted alongside an `Order`.\n\nInternal DTO. The HTTP API (`/api/buy-domain`) accepts and validates\nthese fields; the Openprovider registration job reads them off the\nOrder row when fulfilling."
    }
  }
}