Welcome to ICICI Developer Portal!

Equipped with our services inventory and open API platform, we provide you the chance to reach, test and use ICICI Bank’s digital services. Using these, you now have the power of ICICI Bank supporting you to develop the next generation of applications. Let’s look how you can do it;

Getting Started

If you already have an account, then sign in and jump to step 2. Else follow the steps to create an account

# 1

Go to our sign-up page.

# 2

Complete the registration by entering your details and create an account.

# 3

When authorized, an email will be sent to your registered email-id with a link to activate your account by logging in.

You now have access to your dashboard. From here you can create and configure your apps.

create-an-app

test-code

test-it-out

get-sample-code

HI
sdhf
v-pills-collect-from-VPA
Payments / List Customer Account

List Customer Account

This API will return all the accounts mapped to the user. If same account is mapped to multiple account then multiple entries of same account will be present in the result.

Request parameter details

Name Description Mandatory
RequestFrom

String

Indicates requester.

YES

RequestType

String

Type of Request

YES

CorpID

String

Client ID

YES

UserID

String

User ID under Client ID

YES

AggrName

String

Name of the partner.

YES

AggrID

String

ID of the partner.

YES

BankID

String

Unique ID of the Bank.

YES

URN

String

This a unique value that partner will assign to each registration from his end for security and recon.

YES

AliasID

String

If user created Alias id before registration then user need to pass this parameter in Reg API.

NO

Output Parameters Details

Name Description
Success

String

Denotes if services all has successfully copleted.

Response

Int

Response code of the API. Response code "0" indicates the success response.

Message

String

Response code description message.

BankRRN

Int

The reference number of the transaction.

UpiTranlogID

Int

The Transaction ID generated by Switch.

UserProfile

String

Profile Id of the user.

MobileAppData

String

Denotes the extra data or information to be shared with mobile APP.

SeqNo

String

Seq-no input parameter will be echoed back.

Request parameter details

Error Code Error Name Error Logs
8001

INVALID_JSON

JSON Schema request empty.

8002

INVALID_JSON

JSON Schema request empty.

8003

INVALID_FIELD FORMAT OR LENGTH

JSON Schema request empty.

8004

MISSING_REQUIRED_FIELD_Date

JSON Schema request empty.

8005

MISSING_REQUIRED_FIELD

JSON Schema request empty.

8006

INVALID_FIELD_LENGTH

JSON Schema request empty.

8007

Invalid JSON,OPEN CURLY BRACE MISSING.

JSON Schema request empty.

8008

Invalid JSON,END CURLY BRACE MISSING.

JSON Schema request empty.

8009

Internal Server Error

White space characters.

8010

Internal Service Failure

Routing failure.

8011

INVALID_FIELD

Receive additional properties.

Sample Request Packet

{

"REQUESTFROM": "AGTR",

"REQUESTTYPE": "AGRSTXXXX",

"CORPID": "CIBNEXT",

"USERID": "CIBTESTXXXX",

"AGGRNAME": "MMSOFT",

"AGGRID": "AGGR00XX",

"BANKID": "IXX",

"URN": "2634AB",

"ALIASID": "CIBXXXX",

}

API URL

https://apigwuat.icicibank.com:8443

v-pills-Validate-Virtual-Address-tab
v-pills-transaction-enquiry
v-pills-mobile-fetch
v-pills-de-egisteration
v-pills-transaction

Copyright 2017 ICICI Bank Ltd. All rights reserved.

Frequently Asked Questions

On the developer portal, click the Sign up button at right top corner. The portal is a self-service tool that will guide you through account creation. After creating an account and accepting the ICICI Bank API Portal and Services Agreement, you can start developing apps.

We are currently publishing this for new developers or existing partners with a new initiative. If you do not have an integration with ICICI Bank, use these APIs to get started.

You can sign up for a new Developer account and create an API key on your Developer Console. For more information, see our Documentation page. If you are an Enterprise Developer interested in adding or updating an application, please contact your Account Manager before creating an API key. If you are not able to access your Developer Console, contact your Account Manager.

API is the abbreviation for “Application Programming Interface”. An API allows a third party application to use a common set of services via a defined interface.

Simply create an account on the developer portal and then create one or more applications. Each application will get its own API key. Once your application is ready to go live you can request for an account plan upgrade via your Developer Console.

OAuth is an authentication protocol. For more information, please visit oauth.net.

REST (Representational State Transfer) is a simple stateless architecture i.e. each operation is entirely defined by the information sent to and received from the service. When a web service uses this architecture, it is known as a REST API.

The Organisation Administrator is your company’s representative for the ICICI Bank Developer Portal. This person has overall responsibility for the ICICI Bank Developer Portal account, and has access to all the services and functions available on the site. The Organisation Administrator’s main responsibilities include:

  • Adding, deleting and managing your organisation’s developers
  • Adding, deleting and managing your organisation’s applications
  • Editing organisational details
  • Requesting API keys and authentication
  • Changing API Plans or Account Plans
  • Checking API usage and analytics.

The Organisation Administrator is ICICI's first point of contact regarding the ICICI Bank Developer Portal.

Only users with the enterprise administrator role can add users. You can manage your users and permissions at User Managament page.

You will see details of various error responses within the API specifications. The Error description field in a response is meant to detail a message for the user. Refer to the error code information which details what the error code means and how this error code should be handled.

An Account Plan is a collection of one or more APIs. Every developer organization has an Account Plan. When a developer registers for a new organization account, the organization is automatically assigned to ‘Bronze Account Plan’. Using ‘Bronze Account Plan’ you can only consume ‘Test’ APIs. In order to consume ‘Production’ APIs, you have to upgrade your account plan to ‘Production Account Plan’.

An API Plan is a predefined set of rules and quotes of how to consume an API. Currently, we provide ‘Sandbox’ and ‘Production’ API plans. ’Test’ APIs are only available via ‘Sandbox API Plan’ and they are restricted to some quotes which means you will have limited access. On the other hand ‘Production’ APIs available via ‘Production API Plan’ can be consumed with higher quotes and they process live data. As mentioned under the title ‘What is an API Plan?’ you have to upgrade your account plan to ‘Production Account Plan’ in order to consume ‘Production’ APIs.

Yes, sandbox APIs are currently restricted to a limited number of calls, according to API Plan’s context.

Developers have to be invited by their Organisation Administrator to join the portal. Once joined, they can access most of the same functions as the Organisation Administrator. There are a few things developers won’t be able to do, and this includes inviting other developers to join, changing API or Account plans, or editing organisational details.

Your organisation has a choice of two Account Plans:

  • Our Standard Plan is a free service that gives you up to 10,000 hits per day over your applications and standard technical support through our portal.
  • Our Premium Plan is a chargeable service that gives you a higher number of hits per day or hour - with enhanced, personalised technical support as well as the standard support available through our portal.

If you’re an Organisation Administrator, you can change your Account Plan by going to Dashboard/Applications. Simply select your preferred plan under ‘Account Plan Change’ in the first table. We’ll automatically be notified of your request and be in touch with any further requirements we may need from you.

If you’re an Organisation Administrator, you can request to move from Sandbox to Production for each API within a specific application using this portal:

  • Go to Dashboard/Applications.
  • Click on the cog icon next to your application and select ‘Edit’.
  • Click on the ‘API Management’ tab.
  • Under ‘API Plan Change’ select ‘Production’.

We’ll then be in touch with any further requirements we may need from you.

No, so please make sure you’re certain you don’t want the application before deleting it.

Yes. Go to Dashboard/Applications, click on the cog to the right of the application, then ‘Disable’.

No. But your Application may be suspended or deleted which will suspend or delete the associated API key.

dashboard

Applications

Quota usage across all applications

Application API Key Status Platform
GTU Reuslt App

l7xx1234f60026a64e82b12a0608178ccee3

Active

iOS
Phone pe

l7xx1234f60026a64e82b12a0608178c

Active

iOS
Ease Tap

l7xx1234f60026a64e82b12a0608178ccee3

Active

android Android
Google Analytics

l7xx1234f60026a64e82b12a0608178c

Active

Android
Adsense

l7xx1234f60026a64e82b12a

Active

iOS
GTU Reuslt App

l7xx1234f60026a64e82b12a0608178ccee3

Active

Web
Truecaller Money

l7xx1234f60026a64e82b12a0608178cc

Active

Web
analytics
horizontal tab 3
search

Terms & Conditions

ICICI Appathon is a virtual mobile application development programme that aims to attract developers, technology companies, start-ups, freelance technology enthusiasts and students to create the next generation of banking applications on mobile platform.

ICICI Appathon will offer the most diverse set of banking and financial services application program interface ("API") from ICICI Bank . Using the APIs, Participants will have to create innovative working prototypes of mobile applications that provides a superior customer experience.

A Request has been raised for Production Environment. We will notify you soon via registered Email Address. Check Email

IP Whitelisted

I.P. Address Status
143.172.168.101

Active

192.168.117.107

Inactive

192.168.117.107

Active

143.172.168.101

Inactive

192.168.117.107

Active

192.168.117.107

Active