Question 1

Can I test the API before subscribing?

Accepted Answer

Yes. You can subscribe to the **Free Tier** to run tests with full access to standard endpoints. You can also send live test queries directly from the JoJ API interactive playground in your browser.

Question 2

How does billing work?

Accepted Answer

All subscriptions and metered usage are managed directly through your unified JoJ API balance. Plans renew on a 30-day billing cycle.

Question 3

What happens if I exceed my Rate Limit (RPM)?

Accepted Answer

If you send requests faster than your plan's RPM allowance, the gateway returns an immediate `429 Too Many Requests` error. We recommend implementing exponential backoff in your code.

Question 4

How do I track my usage and remaining quota?

Accepted Answer

Every API response returns real-time quota counters directly in the HTTP response headers:

* `x-jojapi-api-calls-used`: Number of units charged for the current call (typically `1`).
* `x-jojapi-api-calls-remaining`: Remaining monthly quota or prepaid balance for your key.

Question 5

Can I upgrade or downgrade my plan at any time?

Accepted Answer

Yes. Upgrades apply immediately, updating your RPM limit and prorating your monthly request allowance through the JoJ API billing portal.

Question 6

Errors & Troubleshooting

Accepted Answer

#### Common Status Codes

| Code | Reason | Resolution |
| --- | --- | --- |
| `401 Unauthorized` | Invalid or missing API key | Check your `Authorization` header and ensure your key has not been revoked. |
| `403 Forbidden` | Key scope restriction | Ensure your API key has permissions enabled for this specific API. |
| `429 Too Many Requests` | RPM or quota exceeded | Throttle your client request frequency or check your monthly quota balance. |
| `500 / 502 Server Error` | Upstream network or temporary issue | Safe to retry with a brief backoff delay. |

Question 7

Need help or enterprise limits?

Accepted Answer

If your application requires higher throughput than 1,000 RPM or custom dedicated SLAs, contact us via the JoJ API developer portal.

ItsRose

Frequently Asked Questions