at.marque.partner.checkAvailability
Schema Diff
+1 -1
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "at.marque.partner.checkAvailability",
3
3
"defs": {
4
4
"main": {
5
5
"type": "query",
6
6
"output": {
7
7
"schema": {
8
8
"type": "object",
9
9
"required": [
10
10
"results"
11
11
],
12
12
"properties": {
13
13
"results": {
14
14
"type": "array",
15
15
"items": {
16
16
"ref": "#result",
17
17
"type": "ref"
18
18
},
19
19
"description": "One result per domain, in request order; blank entries are skipped."
20
20
}
21
21
}
22
22
},
23
23
"encoding": "application/json"
24
24
},
25
25
"parameters": {
26
26
"type": "params",
27
27
"required": [
28
28
"domains"
29
29
],
30
30
"properties": {
31
31
"domains": {
32
32
"type": "array",
33
33
"items": {
34
34
"type": "string",
35
35
"maxLength": 253
36
36
},
37
37
"maxLength": 500,
38
38
"minLength": 1,
39
39
"description": "Fully qualified domain names to check, e.g. example.com."
40
40
}
41
41
}
42
42
},
43
-
"description": "Check up to 500 domains at once. Call it proxied through the user's PDS (atproto-proxy: did:web:marque.at:api#marque_registrar) with an at.marque.partnerApi-scoped token. Each result carries its own error field, so a single bad domain does not fail the batch. Prices are in whole US dollars and are indicative; the binding amount is set when createCheckout builds the Stripe session. Premium domains are flagged with isPremium and priced via premiumPrice."
43
+
"description": "Check up to 500 domains at once. Call it proxied through the user's PDS (atproto-proxy: did:web:marque.at#marque_registrar) with an at.marque.partnerApi-scoped token. Each result carries its own error field, so a single bad domain does not fail the batch. Prices are in whole US dollars and are indicative; the binding amount is set when createCheckout builds the Stripe session. Premium domains are flagged with isPremium and priced via premiumPrice."
44
44
},
45
45
"result": {
46
46
"type": "object",
47
47
"required": [
48
48
"domain",
49
49
"available"
50
50
],
51
51
"properties": {
52
52
"error": {
53
53
"type": "string",
54
54
"description": "Per-domain failure reason when the domain could not be checked or priced, e.g. invalid format, unsupported TLD, or not available via the registrar. When set, the pricing fields are absent or zero."
55
55
},
56
56
"price": {
57
57
"type": "integer",
58
58
"description": "Registration price per year, in whole US dollars. Absent for unavailable or errored domains."
59
59
},
60
60
"domain": {
61
61
"type": "string",
62
62
"maxLength": 253,
63
63
"description": "The fully qualified domain name that was checked, lowercased."
64
64
},
65
65
"status": {
66
66
"type": "string",
67
67
"description": "Registry status of the domain: free (available), premium (available at a premium price), or active (already registered, not available). Absent when the domain could not be checked (see error).",
68
68
"knownValues": [
69
69
"free",
70
70
"premium",
71
71
"active"
72
72
]
73
73
},
74
74
"available": {
75
75
"type": "boolean",
76
76
"description": "Whether the domain can be registered now. True when status is free or premium."
77
77
},
78
78
"isPremium": {
79
79
"type": "boolean",
80
80
"description": "Whether this is a premium domain, priced individually by the registry rather than at the standard TLD price."
81
81
},
82
82
"maxPeriod": {
83
83
"type": "integer",
84
84
"description": "Maximum registration period in years for this TLD."
85
85
},
86
86
"minPeriod": {
87
87
"type": "integer",
88
88
"description": "Minimum registration period in years for this TLD."
89
89
},
90
90
"renewPrice": {
91
91
"type": "integer",
92
92
"description": "Renewal price per year, in whole US dollars."
93
93
},
94
94
"premiumPrice": {
95
95
"type": "integer",
96
96
"description": "Premium registration price, in whole US dollars, when isPremium is true."
97
97
},
98
98
"transferPrice": {
99
99
"type": "integer",
100
100
"description": "Transfer price, in whole US dollars. 0 when transferring this TLD does not cost a registration period."
101
101
},
102
102
"transferAddsYear": {
103
103
"type": "boolean",
104
104
"description": "Whether transferring this TLD adds a year of registration (and so is charged)."
105
105
},
106
106
"whoisPrivacyAllowed": {
107
107
"type": "boolean",
108
108
"description": "Whether WHOIS privacy can be enabled for this TLD at registration."
109
109
}
110
110
}
111
111
}
112
112
},
113
113
"$type": "com.atproto.lexicon.schema",
114
114
"lexicon": 1,
115
115
"description": "Check availability and pricing for a batch of domains, for partner integrations."
116
116
}