The Soracom API has a "maximum number of requests" per minute (i.e. a rate limit) for related APIs (hereinafter referred to as "API groups").

If a system using the Soracom API calls an API at a higher rate than the set limit, the HTTP status code 429 is returned from the Soracom platform and the system must wait up to one minute before calling the API again.

Since the "maximum number of requests" is different for each API group, and since the rate limits are subject to change, we have not historically listed rate limits on the Soracom Developers site.

Instead, with this new change, when your system calls an API the following information about the rate limits will be returned so you can determine the "maximum number of requests".

• X-Soracom-Ratelimit-Limit
• X-Soracom-Ratelimit-Remaining
• X-Soracom-Ratelimit-Seconds-Before-Refresh

Based on the returned information, your system can invoke the API according to the rate limit. Alternatively, you may apply for a rate limit increase by contacting Soracom Support with details of your use case.

For more information, see Rate Limits. (Japanese)