API reference / KYC / Identity

IFSC lookup

Bank + branch for an IFSC.

GET/v1/lookup/ifsc
Authentication
Bearer token
Scope
kyc:verify

Query parameters

FieldTypeRequiredDescription
ifscstringYesIFSC to look up: four letters, a zero, then six letters or digits, for example ICIC0000001.

Sample code

Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.

curl -sS -X GET 'https://grappi.ai/v1/lookup/ifsc?ifsc=ICIC0000001' \
  -H "Authorization: Bearer $GRAPPI_API_KEY"

Sample response

{
  "request_id": "req_01HZY3K8M2",
  "result": {
    "ifsc": "ICIC0000001",
    "valid": true,
    "bank": "EXAMPLE BANK",
    "branch": "EXAMPLE BRANCH"
  }
}

Response fields

FieldTypeDescription
ifscstringThe IFSC that was looked up, in upper case.
validbooleanTrue when the IFSC belongs to a branch.
bankstringName of the bank, or null when the IFSC is not found.
branchstringName of the branch, or null when the IFSC is not found.

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.