Skip to main content
GET
/
organizations
/
{orgId}
/
business-verification
Get business verification status
curl --request GET \
  --url https://api.helloannie.com/v1/organizations/{orgId}/business-verification
import requests

url = "https://api.helloannie.com/v1/organizations/{orgId}/business-verification"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://api.helloannie.com/v1/organizations/{orgId}/business-verification', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.helloannie.com/v1/organizations/{orgId}/business-verification",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"net/http"
"io"
)

func main() {

url := "https://api.helloannie.com/v1/organizations/{orgId}/business-verification"

req, _ := http.NewRequest("GET", url, nil)

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.helloannie.com/v1/organizations/{orgId}/business-verification")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.helloannie.com/v1/organizations/{orgId}/business-verification")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "success": true,
  "data": {
    "orgId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "missing_information",
    "canUpdate": true,
    "reason": "<string>",
    "issues": [
      {
        "field": "<string>",
        "code": "<string>",
        "message": "<string>"
      }
    ],
    "steps": {
      "businessProfile": {
        "status": "missing_information",
        "reason": "<string>",
        "providerStatus": "<string>"
      },
      "calling": {
        "status": "missing_information",
        "reason": "<string>",
        "providerStatus": "<string>"
      },
      "messaging": {
        "status": "missing_information",
        "reason": "<string>",
        "providerStatus": "<string>"
      }
    },
    "submittedAt": "2023-11-07T05:31:56Z",
    "reviewedAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}
{
"success": false,
"data": {},
"message": "<string>"
}
{
"success": false,
"data": {},
"message": "<string>"
}

Path Parameters

orgId
string<uuid>
required

Organization ID

Response

Response returned when submitting or checking business verification. Use the top-level status for product logic and steps/issues for user-facing detail.

success
enum<boolean>
required
Available options:
true
data
object
required

Business verification proves the legal organization, responsible representative, calling identity, and messaging consent materials before Annie can complete carrier setup for calls and SMS. This object is designed for polling after submission and for showing users what action, if any, is required.