Global Biz Verify API – Technical documentation

# Global Biz Verify API full example code

# Step 1: Check if the business registration format is valid avoid useless business registry checks

curl \
-H "Authorization: Bearer <access-token--contact-us-for-test-tokens>" \
https://eu-central-1.global-biz-verify-api.open-automation.io/check_registration_number/SK/35742739

# Step 2: Request a buisiness registry check and get back a request_id 
#         or the result directly if it is ready immediately

curl \
-H "Authorization: Bearer <access-token--contact-us-for-test-tokens>" \
-H "Content-Type: application/json" \
-d '{"registration_number": "35742739", "business_name": "APPLE SLOVAKIA", "country": "SK"}' \
https://eu-central-1.global-biz-verify-api.open-automation.io/check_business

# Step 3: Get the result using the previously provided result_id

curl \
-H "Authorization: Bearer <access-token--contact-us-for-test-tokens<" \
-H "Content-Type: application/json" \
-d '{"request_id": "1749407497620978713"}' \
https://eu-central-1.global-biz-verify-api.open-automation.io/get_result

# Check the technical documentation for detailed exaplanation of the 3 endpoints

import requests
import time

# Replace this with your actual token
access_token = "<access-token--contact-us-for-test-tokens<"
headers = {
    "Authorization": f"Bearer {access_token}"
}

# Step 1: Validate business registration format
country_code = "SK"
registration_number = "35742739"

response_step1 = requests.get(
    f"https://eu-central-1.global-biz-verify-api.open-automation.io/check_registration_number/{country_code}/{registration_number}",
    headers=headers
)
print("Step 1 - Registration Format Validation:")
print(response_step1.json())

# Step 2: Perform business registry check
headers_with_content_type = {
    **headers,
    "Content-Type": "application/json"
}

payload_step2 = {
    "registration_number": "35742739",
    "business_name": "APPLE SLOVAKIA",
    "country": "SK"
}

response_step2 = requests.post(
    "https://eu-central-1.global-biz-verify-api.open-automation.io/check_business",
    headers=headers_with_content_type,
    json=payload_step2
)
print("\nStep 2 - Business Check Request:")
step2_result = response_step2.json()
print(step2_result)

# Extract request_id if present
request_id = step2_result.get("request_id")
if request_id:
    # Step 3: Get result using request_id
    payload_step3 = {
        "request_id": request_id
    }

    time.sleep(10)
    response_step3 = requests.post(
        "https://eu-central-1.global-biz-verify-api.open-automation.io/get_result",
        headers=headers_with_content_type,
        json=payload_step3
    )
    print("\nStep 3 - Get Result:")
    print(response_step3.json())
else:
    print("\nStep 3 skipped: No request_id returned; result might be immediate.")
    
# Check the technical documentation for detailed exaplanation of the 3 endpoints

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var accessToken = "<access-token--contact-us-for-test-tokens>";
        var client = new HttpClient();

        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);

        // Step 1: Validate business registration format
        var countryCode = "SK";
        var registrationNumber = "35742739";

        var step1Url = $"https://eu-central-1.global-biz-verify-api.open-automation.io/check_registration_number/{countryCode}/{registrationNumber}";
        var responseStep1 = await client.GetAsync(step1Url);
        var step1Json = await responseStep1.Content.ReadAsStringAsync();

        Console.WriteLine("Step 1 - Registration Format Validation:");
        Console.WriteLine(step1Json);

        // Step 2: Perform business registry check
        var step2Url = "https://eu-central-1.global-biz-verify-api.open-automation.io/check_business";
        var payloadStep2 = new
        {
            registration_number = "35742739",
            business_name = "APPLE SLOVAKIA",
            country = "SK"
        };
        var step2Content = new StringContent(JsonSerializer.Serialize(payloadStep2), Encoding.UTF8, "application/json");
        var responseStep2 = await client.PostAsync(step2Url, step2Content);
        var step2Json = await responseStep2.Content.ReadAsStringAsync();

        Console.WriteLine("\nStep 2 - Business Check Request:");
        Console.WriteLine(step2Json);

        // Parse step2 JSON and extract request_id
        using var doc = JsonDocument.Parse(step2Json);
        if (doc.RootElement.TryGetProperty("request_id", out var requestIdElement))
        {
            string requestId = requestIdElement.GetString();

            // Step 3: Get result using request_id
            var step3Url = "https://eu-central-1.global-biz-verify-api.open-automation.io/get_result";
            var payloadStep3 = new
            {
                request_id = requestId
            };
            await Task.Delay(10000); // sleep for 10 seconds
            var step3Content = new StringContent(JsonSerializer.Serialize(payloadStep3), Encoding.UTF8, "application/json");
            var responseStep3 = await client.PostAsync(step3Url, step3Content);
            var step3Json = await responseStep3.Content.ReadAsStringAsync();

            Console.WriteLine("\nStep 3 - Get Result:");
            Console.WriteLine(step3Json);
        }
        else
        {
            Console.WriteLine("\nStep 3 skipped: No request_id returned; result might be immediate.");
        }
    }
}

// Check the technical documentation for detailed exaplanation of the 3 endpoints