Skip to main content
POST
/
api
/
v1
/
providers
/
{id}
/
verify
Verify provider
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://blackbox.dasha.ai/api/v1/providers/{id}/verify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "status": "pending",
  "checks": [
    {
      "checkName": "<string>",
      "message": "<string>",
      "status": "passed",
      "timestamp": "2023-11-07T05:31:56Z",
      "details": {}
    }
  ],
  "lastVerifiedAt": "2023-11-07T05:31:56Z"
}

​
Verification Checks

The verification process performs the following checks:
  • Credentials: Validates that the provider’s API credentials are still valid and have sufficient permissions
  • Trunk: Verifies the SIP trunk exists and is properly configured
  • Credential List: Confirms the credential list is attached to the trunk
  • Phone Numbers: Checks that imported phone numbers are still attached to the trunk

​
Verification Status

Based on the check results, the provider status is updated to one of:
StatusDescription
verifiedAll checks passed successfully
warningNon-critical issues detected (e.g., phone detached from trunk)
failedCritical failure (e.g., invalid credentials, trunk not found)

​
Automatic Verification

Providers are automatically verified on an hourly schedule. Use this endpoint to trigger an immediate verification when needed.

Path Parameters

​
id
string<uuid>
required

Provider identifier

Response

Verification completed successfully with detailed results

Result of a provider verification operation. Contains the overall verification status, individual check results, and timestamp of when the verification was performed.

​
status
enum<string>

Overall verification status. Indicates the aggregate result of all verification checks. Supported values: pending, verified, warning, failed.

Available options:
pending,
verified,
warning,
failed
​
checks
object[] | null

Individual verification check results. Contains details about each check performed including credentials validation, API connectivity, and configuration verification.

​
lastVerifiedAt
string<date-time>

Timestamp when the verification was performed. Recorded in UTC.