{
"id": "at.marque.partner.getOrder",
"defs": {
"item": {
"type": "object",
"required": [
"domain",
"status"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253
},
"status": {
"type": "string",
"description": "Per-domain provisioning status.",
"knownValues": [
"pending",
"active",
"failed"
]
},
"expiresAt": {
"type": "string",
"format": "datetime"
},
"nameServers": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
}
},
"registeredAt": {
"type": "string",
"format": "datetime"
}
}
},
"main": {
"type": "query",
"errors": [
{
"name": "NotFound",
"description": "No order with that id is owned by the authenticated user."
}
],
"output": {
"schema": {
"type": "object",
"required": [
"orderId",
"status",
"items"
],
"properties": {
"error": {
"type": "string",
"description": "Failure reason when status is failed."
},
"items": {
"type": "array",
"items": {
"ref": "#item",
"type": "ref"
}
},
"status": {
"type": "string",
"knownValues": [
"awaitingPayment",
"paid",
"provisioning",
"provisioned",
"failed"
]
},
"orderId": {
"type": "string"
}
}
},
"encoding": "application/json"
},
"parameters": {
"type": "params",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"description": "The order id returned by createCheckout."
}
}
},
"description": "Poll an order created by createCheckout. Call it proxied through the user's PDS (atproto-proxy: did:web:marque.at:api#marque_registrar) with an at.marque.partnerApi-scoped token; only orders owned by the authenticated user (the JWT iss) are returned. Status flows awaitingPayment (user has not finished paying) -> paid -> provisioning -> provisioned (or failed). Poll every few seconds until provisioned or failed. Once provisioned, each item carries the registeredAt, expiresAt, and nameServers the partner needs to write the at.marque.domain and at.marque.dns records into the user's repository. Individual items can be failed even when the order is provisioned (a partial failure); check each item's status."
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1,
"description": "Get the status of a partner checkout order and the resulting domain details."
}