const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"orgId": "<string>",
"domain": "<string>",
"status": "PendingVerification",
"createdTime": "2023-11-07T05:31:56Z",
"lastUpdateTime": "2023-11-07T05:31:56Z",
"exampleSipUri": "<string>",
"dns": {
"verification": {
"type": "<string>",
"name": "<string>",
"value": "<string>",
"target": "<string>"
},
"routing": {
"type": "<string>",
"name": "<string>",
"value": "<string>",
"target": "<string>"
},
"sipTarget": "<string>"
},
"lastError": "<string>",
"verifiedTime": "2023-11-07T05:31:56Z",
"defaultAgentId": "<string>",
"defaultAgentName": "<string>",
"routingRecordsDetected": true
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Verify custom SIP domain
Looks up the DNS TXT verification record. When it matches, the domain is registered on the Dasha platform and becomes Active. When it does not, the domain stays PendingVerification and lastError explains what was expected; the call still returns 200. The response also reports whether routing records already point at Dasha.
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify \
--header 'Authorization: Bearer <token>'import requests
url = "https://blackbox.dasha.ai/api/v1/sip-domains/{id}/verify"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"orgId": "<string>",
"domain": "<string>",
"status": "PendingVerification",
"createdTime": "2023-11-07T05:31:56Z",
"lastUpdateTime": "2023-11-07T05:31:56Z",
"exampleSipUri": "<string>",
"dns": {
"verification": {
"type": "<string>",
"name": "<string>",
"value": "<string>",
"target": "<string>"
},
"routing": {
"type": "<string>",
"name": "<string>",
"value": "<string>",
"target": "<string>"
},
"sipTarget": "<string>"
},
"lastError": "<string>",
"verifiedTime": "2023-11-07T05:31:56Z",
"defaultAgentId": "<string>",
"defaultAgentName": "<string>",
"routingRecordsDetected": true
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>"
}Path Parameters
Domain identifier
Response
Verification attempted; see status and lastError
Custom SIP domain with its verification state and the DNS records to publish.
Unique identifier of the domain record. Pass it as sipDomainId when registering a call.
Organization that owns the domain.
1Normalized hostname.
1PendingVerification until the TXT record is found and the platform registration succeeds; Active when usable; Failed when the platform refused the domain.
PendingVerification, Active, Failed Timestamp when the domain was added.
Timestamp of the last change.
Example of the SIP URI registered calls will get on this domain.
1DNS records to publish for verification and routing.
Show child attributes
Show child attributes
Reason for the last failed verification or registration attempt, if any.
When the domain became Active.
Agent that answers inbound calls on this domain whose SIP user part is not a registered call id. Null means such calls are rejected with SIP 404.
Display name of the default agent, when set.
Result of the last routing DNS check: true when the domain already resolves to the Dasha SIP host (CNAME or copied A records). Only set by the verify endpoint.
Was this page helpful?