IP Address Validation API - Onboarding Buddy

The Onboarding Buddy IP Address Validation API enables developers to validate IP addresses, verifying format, geolocation, and potential risks. Ideal for secure onboarding, fraud prevention, and compliance workflows, this API supports real-time and batch validation to enhance security and trust.

Why Use the Onboarding Buddy IP Address Validation API?

Validate IP addresses to detect suspicious activity, ensure geolocation accuracy, and strengthen security in your applications. The Onboarding Buddy API analyzes IP addresses for format validity, geolocation data, and risk indicators, making it perfect for fraud prevention, compliance, and user verification in onboarding or authentication processes.

Key Features

Single IP Validation: Instantly verify an IP address for format, geolocation, and risk factors.
Batch Validation: Process multiple IP addresses efficiently in a single request.
Geolocation Insights: Retrieve country, city, and ISP details for precise user profiling.
Risk Detection: Identify VPNs, proxies, or known malicious IPs to prevent fraud.
Secure API Access: Use App Key, API Key, and API Secret for authenticated requests.

Relevant Endpoints

Endpoint	Method	Purpose
`POST /validation-service/validation/ip-address`	POST	Validates a single IP address and returns the validation response.
`POST /validation-service/batch/ip-address`	POST	Validates a batch of IP addresses and returns a batch validation response.
`GET /validation-service/batch/poll/{batchId}`	GET	Polls the status of a submitted batch validation request using the batch ID.
`GET /validation-service/batch/ip-address/{batchId}`	GET	Retrieves the validation results for a batch of IP addresses using the batch ID.

Code Samples

Validate a Single IP Address

Use the POST /validation-service/validation/ip-address endpoint to validate a single IP address. Include your API credentials in the headers for secure access.


        curl -X POST https://api.onboardingbuddy.co/validation-service/validation/ip-address \
        -H "ob-app-key: your-app-key" \
        -H "ob-api-key: your-api-key" \
        -H "ob-api-secret: your-api-secret" \
        -H "Content-Type: application/json" \
        -d '{"ipAddress": "192.168.1.1"}'

Example Response:


        {
          "isValid": true,
          "details": {
            "format": "valid",
            "type": "IPv4",
            "geolocation": {
              "country": "United States",
              "city": "Ashburn",
              "isp": "Example ISP"
            },
            "isProxy": false,
            "isMalicious": false
          }
        }

Validate a Batch of IP Addresses

Use the POST /validation-service/batch/ip-address endpoint to validate multiple IP addresses efficiently.


        curl -X POST https://api.onboardingbuddy.co/validation-service/batch/ip-address \
        -H "ob-app-key: your-app-key" \
        -H "ob-api-key: your-api-key" \
        -H "ob-api-secret: your-api-secret" \
        -H "Content-Type: application/json" \
        -d '{"ipAddresses": ["192.168.1.1", "10.0.0.1", "invalid-ip"]}'

Example Response:


        {
          "batchId": "batch-78901",
          "status": "processing"
        }

Poll Batch Validation Status

Check the status of a batch validation request using the GET /validation-service/batch/poll/{batchId} endpoint.


        curl -X GET https://api.onboardingbuddy.co/validation-service/batch/poll/batch-78901 \
        -H "ob-app-key: your-app-key" \
        -H "ob-api-key: your-api-key" \
        -H "ob-api-secret: your-api-secret"

Example Response:


        {
          "batchId": "batch-78901",
          "status": "completed"
        }

Retrieve Batch Validation Results

Retrieve the results of a completed batch validation using the GET /validation-service/batch/ip-address/{batchId} endpoint.


        curl -X GET https://api.onboardingbuddy.co/validation-service/batch/ip-address/batch-78901 \
        -H "ob-app-key: your-app-key" \
        -H "ob-api-key: your-api-key" \
        -H "ob-api-secret: your-api-secret"

Example Response:


        {
          "batchId": "batch-78901",
          "results": [
            {
              "ipAddress": "192.168.1.1",
              "isValid": true,
              "details": {
                "format": "valid",
                "type": "IPv4",
                "geolocation": {
                  "country": "United States",
                  "city": "Ashburn",
                  "isp": "Example ISP"
                },
                "isProxy": false,
                "isMalicious": false
              }
            },
            {
              "ipAddress": "10.0.0.1",
              "isValid": true,
              "details": {
                "format": "valid",
                "type": "IPv4",
                "geolocation": {
                  "country": "Private Network",
                  "city": null,
                  "isp": null
                },
                "isProxy": false,
                "isMalicious": false
              }
            },
            {
              "ipAddress": "invalid-ip",
              "isValid": false,
              "details": {
                "error": "Invalid IP address format"
              }
            }
          ]
        }

Applications of IP Address Validation

The Onboarding Buddy IP Address Validation API is ideal for:

Fraud Prevention: Detect proxies, VPNs, or malicious IPs to block suspicious activity.
User Onboarding: Verify IP addresses during registration for secure user verification.
Geolocation Targeting: Personalize user experiences based on accurate location data.
Compliance: Ensure IP data accuracy for KYC and regulatory workflows.

Next Steps

Get started with the Onboarding Buddy IP Address Validation API today. Sign up to obtain your API credentials, explore the full API documentation, or discover other use cases like email validation or sanctions screening. For technical details, view all API endpoints.

Start Validating IP Addresses Now