Verify IP
Use this API to verify location, proxy details, city risk score, and proxy type risk score of an IP address. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.
Response Codes
Sub Code | Status | Message | Next Action |
---|---|---|---|
200 | SUCCESS | VALID | - |
400 | ERROR | x-client-id is missing in the request. | Enter all the header information in the request. |
400 | ERROR | verification_id already exists. | Enter a unique verification ID to identify the request. |
400 | ERROR | Client secret belongs to test environment | Enter the correct environment credentials in the request. |
400 | ERROR | please enter a valid IP address | Enter a valid IP address in the request. |
401 | ERROR | Invalid clientId and clientSecret combination | Ensure you enter valid x-client-id and x-client-secret information in the API request. |
403 | ERROR | IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://www.cashfree.com/docs/secure-id/get-started/integration/ip-whitelisting-verification | Whitelist the IP address. |
404 | ERROR | unable to find IP details | Enter a valid IP address in the request. |
422 | ERROR | Insufficient balance to process this request | Try again with sufficient balance. |
500 | ERROR | something went wrong, please try after some time | Try again after some time. |
Authorizations
Client ID. You can find your ID in the Merchant Dashboard.
Client secret key. You can find your secret key in the Merchant Dashboard.
Body
Find the request parameters to verify IP address
It is the IP address that you need to verify which is assigned to a device connected to a computer network.
It is the unique ID you create to identify the verification request. The maximum character limit is 50. Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
Response
Verify IP success response
It displays the name of the city associated with the geographical location of the device or network to which the IP address is assigned.
It displays the risk score associated with a particular city based on factors such as cybersecurity threats, crime rates, or other relevant data.
It displays the country code associated with the geographical location of the device or network to which the IP address is assigned.
It displays the name of the country associated with the geographical location of the device or network to which the IP address is assigned.
It displays the entered IP address.
It displays the category or classification of a proxy server based on its functionality and how it handles network requests.
It displays the risk score associated with a particular city based on factors such as cybersecurity threats, crime rates, or other relevant data.
It displays the unique ID created by Cashfree Payments for reference purposes.
format: int64
It displays the name of the region associated with the geographical location of the device or network to which the IP address is assigned.
It displays the status of the IP address.
It displays the unique ID you created to identify the verification request.
Was this page helpful?