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

FieldTypeRequiredDescription
member_typestringYesMembership class: ACS (associate) or FCS (fellow). Case is ignored.
member_numberstringYesICSI 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

FieldTypeDescription
organizationstringOrganisation the member is attached to.
typestringMembership type.
citystringCity on the member's record.
addressstringAddress on the member's record.
split_addressobjectThe member's address broken into parts.
split_address.districtarrayDistrict name, as a list.
split_address.statearrayState name, as a list.
split_address.cityarrayCity name, as a list.
split_address.pincodestringSix-digit pincode.
split_address.countryarrayCountry name, as a list.
split_address.address_linestringStreet-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.