Search Profile

This API allows you to search for politically exposed entities using different full name or aliases.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Header Parameters

NameTypeDescriptionMandatory (M) , Optional (O)Provided by INSTANTPAY (Y/N)
X-Ipay-Auth-CodeStringAuth Code is "1" (Fixed)MY
X-Ipay-Client-IdStringUnique Client Id Provided by InstantpayMY
X-Ipay-Client-SecretStringUnique Client Secret Provided by InstantpayMY
X-Ipay-Endpoint-IpStringEnd customer IP AddressMY

Request Parameters

Parameter NameTypeRequirementDescription
queryTextStringMandatoryFull name or known aliases of the the Individual
latitudeStringMandatoryEnd Customer Latitude.
longitudeStringMandatoryEnd Customer Longitude
externalRefStringMandatoryYour Unique Transaction id
consentStringMandatoryConsent should be
accepted by
customer
limitStringOptionalNumber of result to return in the response
offsetStringOptionalStart at result with given offset

Sample Request

GET /identity/sanctions/search?queryText=Yadav&consent=y&latitude=0&longitude=0&externalRef=1716180569&limit=10&offset= HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: {{clientId}
X-Ipay-Client-Secret: {{clientSecret}
X-Ipay-Endpoint-Ip: {{ipAddress}
X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234
X-Ipay-Request-Timestamp: 1659943695791
X-Ipay-Hash-Check: OFF
User-Agent: InstantPayAPITest/1.0.0
GET /identity/sanctions/search?queryText=Yadav&consent=y&latitude=0&longitude=0&externalRef=1716180569&limit=10&offset= HTTP/1.1
Host: api.instantpay.in
X-Ipay-Auth-Code: 1
X-Ipay-Client-Id: YWY3OTAzYzNlM2ExZTJlOfh549Gzt+5IEcETrD5Yx+Q=
X-Ipay-Client-Secret: 82e4755d7c1cf636816addfe1460936d7b64612208df87f3000aa5b56fc926d1
X-Ipay-Endpoint-Ip: 14.142.186.142
X-Ipay-Request-Hash: 123456789|123456789|123456789|123456789|123456789|123456789|1234
X-Ipay-Request-Timestamp: 1659943695791
X-Ipay-Hash-Check: OFF
User-Agent: InstantPayAPITest/1.0.0

Response Parameters

Parameter NameTypeDescription
statuscodeStringInstantpay Status Code
actcodeStringAction Code
statusArrayStatus message
dataStringResponse Data(if Present)
timestampStringResponse time (YYYY-MM-DD HH:II:SS)
ipay_uuidStringRequest reference number
orderidStringTransaction Id(if transaction otherwise it is null)
environmentStringLive/Sandbox
internalCodeStringIt will be null

Sample Response

{
    "statuscode": "TXN",
    "actcode": null,
    "status": "Transaction Successful",
    "data": {
        "searchData": {
            "limit": 10,
            "offset": 0,
            "total": {
                "value": 1,
                "relation": "eq"
            },
            "results": [
                {
                    "id": "Q122304",
                    "caption": "Nitish Kumar",
                    "schema": "Person",
                    "properties": {
                        "keywords": [
                            "State government",
                            "National government"
                        ],
                        "name": [
                            "ニティーシュ・クマール",
                            "نتيش كمار",
                            "नीतिश कुमार",
                            "Нитиш Кумар",
                            "尼特·庫馬爾",
                            "Nitish Kumar",
                            "नीतीश कुमार",
                            "ניטיש קומאר",
                            "نیتیش کمار",
                            "ನಿತೀಶ್ ಕುಮಾರ್"
                        ],
                        "alias": [
                            "尼蒂什·库玛尔",
                            "尼特·库马尔",
                            "尼蒂什·库马尔",
                            "尼蒂什·庫瑪爾"
                        ],
                        "wikidataId": [
                            "Q122304"
                        ],
                        "position": [
                            "Member of the 11th Lok Sabha",
                            "Chief Minister of Bihar (2015-)",
                            "Member of the 13th Lok Sabha",
                            "member of a Legislative Assembly of India",
                            "Member of the 9th Lok Sabha (1989-1991)",
                            "Member of the 12th Lok Sabha",
                            "Chief Minister of Bihar (2005-2014)"
                        ],
                        "topics": [
                            "role.pep"
                        ],
                        "country": [
                            "in"
                        ],
                        "religion": [
                            "Hinduism"
                        ],
                        "modifiedAt": [
                            "2024-05-03"
                        ],
                        "website": [
                            "http://gov.bih.nic.in/Governance/NitishKumar.htm"
                        ],
                        "birthPlace": [
                            "Bakhtiarpur"
                        ],
                        "gender": [
                            "male"
                        ],
                        "education": [
                            "National Institute of Technology, Patna"
                        ],
                        "birthDate": [
                            "1951-03-01"
                        ],
                        "nationality": [
                            "in"
                        ],
                        "notes": [
                            "Indian politician and Current Chief Minister of Bihar"
                        ]
                    },
                    "target": true,
                    "firstSeen": "2023-04-20T10:30:17",
                    "lastSeen": "2024-05-19T12:48:01",
                    "lastChange": "2024-05-08T00:47:01"
                }
            ],
            "facets": {
                "topics": {
                    "label": "Topics",
                    "values": [
                        {
                            "name": "role.pep",
                            "label": "Politican",
                            "count": 1
                        }
                    ]
                },
                "countries": {
                    "label": "Countries",
                    "values": [
                        {
                            "name": "in",
                            "label": "India",
                            "count": 1
                        }
                    ]
                }
            }
        },
        "poolReferenceId": "1240520094857ZNSYR",
        "pool": {
            "openingBal": "23.64",
            "mode": "DR",
            "amount": "0.00",
            "closingBal": "23.64"
        }
    },
    "timestamp": "2024-05-20 09:48:57",
    "ipay_uuid": "h0059c15e665-84b9-422b-9baa-6324f0284ecc-zFCN75SrVyTx",
    "orderid": "1240520094857ZNSYR",
    "environment": "LIVE"
}
Body Params
string

Name of the Individual

string

End Customer Latitude.

string

End Customer Longitude.

string

Your Unique Transaction id

string
string
Headers
string
Defaults to 1

Auth Code

string

Unique Client Id Provided by Instantpay

string

Unique Client Secret Provided by Instantpay

string

End Customer IP Address

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json