Eko Platform Services Logo

    GETGet IFSC Details

    Resolve a bank and branch from an IFSC code.

    GET/tools/reference/banks/ifsc/{ifsc}

    Returns the bank name, branch, Eko bank_id, and verification availability for a given IFSC code.

    Path parameters

    ifscstringRequired

    IFSC code of the bank branch.

    example: IOBA0002248

    Query parameters

    initiator_idstringRequired

    Registered mobile number of the API user (see Platform Credentials).

    example: 9962981729

    user_codestringRequired

    User code of the retailer/agent the service is run for.

    example: 20810200

    Headers

    developer_keystringRequired

    Static API key issued to your account after KYC.

    secret-keystringRequired

    Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

    secret-key-timestampstringRequired

    Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

    content-typestringRequired

    application/json

    example: application/json

    Responses

    • statusnumber

      Primary success indicator (0 = success).

    • messagestring

      Human-readable response / error message.

    • response_status_idnumber

      Granular status id; see the shared error-codes table.

    • response_type_idnumber

      A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.

    • dataobject

      API-specific response payload.

      • bankstring

        Bank name for the IFSC.

      • branchstring

        Branch for the IFSC.

      • ifscstring

        IFSC code (echoed back).

      • bank_idnumber

        Eko bank identifier.

      • isverificationavailablestring

        Whether account verification is available (1) or not (0).