Public API Version 2

Major change in this version is in the response format, now response body contains only the information of objects (pagination and other stuff is moved to headers). Response body will contain the object or array of objects. Incase of error, response body structure will be {message:"message description"}

Pagination Headers

  • X-Pagination-Total total number of results.
  • X-Pagination-Pages total number of pages.
  • X-Pagination-Page current page number.
  • X-Pagination-Limit results per page.

Rate Limiting

Rate limiting is introduced with this version ( applicable for old versions of the API also ). You can create new tokens or modify/regenerate existing token at https://gorest.co.in/my-account/access-tokens with optional expiry date and mandatory rate limit per minute (default is 90 max is 300). To know the current rate limits please check the headers after each call

  • X-RateLimit-Limit number of allowed requests/minute.
  • X-RateLimit-Remaining remaining requests within the current period.
  • X-RateLimit-Reset seconds to wait before having maximum number of allowed requests again.

Little markdown supported