Error message

Invalid head parameters

Last updated 25 June 2026

Invalid head parameters

In short

The "Invalid head parameters" error almost always means one of your API credentials is wrong. It shows up on the 5paisa and IIFL brokers. Check every field for typos, fix any format or extra-space issues, and if you just generated IIFL APIs, wait 2-3 hours for them to activate.

When this happens

  1. 1 One of the many API parameters is wrong.
  2. 2 The security answer (2FA), which is your date of birth, is not entered in YYYYMMDD format.
  3. 3 The App Name contains two spaces but the user enters only one space.
  4. 4 Extra space is copied into the API parameters while copying them from the IIFL website.
  5. 5 IIFL takes 2-3 hours to activate the APIs, so an account added right after generating IIFL APIs can fail.
  6. 6 The API key has expired. You can check the API key expiration date in the IIFL trading platform.

Solution

  • Verify your credentials (all fields) for any mistakes. Setup help is available for IIFL and 5paisa.
  • Wait for 2-3 hours if you have just generated the API keys for your trading account.
  • If the API key has expired, contact your broker’s customer care to get it re-activated.
  • If nothing helps, save your account without validating it. Then write a mail to IIFL (apisupport.broking@iifl.com) or 5paisa (support@5paisa.com) and keep us in cc (help@stocksdeveloper.in).
Did this solve your problem?
Contact support