API reference / KYC / Identity
ICSI membership
Company secretary membership (ACS or FCS) checked against the ICSI register.
POST
/v1/verify/icsi-membership- Authentication
- Bearer token
- Scope
kyc:verify
Request body
| Field | Type | Required | Description |
|---|---|---|---|
member_type | string | Yes | Membership class: ACS (associate) or FCS (fellow). Case is ignored. |
member_number | string | Yes | ICSI membership number, 1 to 7 digits. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/verify/icsi-membership' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"member_type": "ACS",
"member_number": "41228"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"organization": "Example & Associates",
"type": "ACS",
"city": "Pune",
"address": "12 Example Lane, Pune, Maharashtra, 411001",
"split_address": {
"district": [
"Pune"
],
"state": [
"Maharashtra"
],
"city": [
"Pune"
],
"pincode": "411001",
"country": [
"India"
],
"address_line": "12 Example Lane"
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
organization | string | Organisation the member is attached to. |
type | string | Membership type. |
city | string | City on the member's record. |
address | string | Address on the member's record. |
split_address | object | The member's address broken into parts. |
split_address.district | array | District name, as a list. |
split_address.state | array | State name, as a list. |
split_address.city | array | City name, as a list. |
split_address.pincode | string | Six-digit pincode. |
split_address.country | array | Country name, as a list. |
split_address.address_line | string | Street-level part of the address. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.