A free numerology API

Plans

Get a free key: sign up with GitHub, Google, or your email and a password, then create your key on the account page.

What the free plan includes

• Every endpoint: Pythagorean charts, personal cycles and compatibility.
• The full 47-field chart.
• The OpenAPI 3.1 spec and quickstarts for Python and JavaScript.
• No expiry. The quota resets every 30 days, for as long as you use it.

When you outgrow it

Starter and Pro add higher quotas and optional overage: when enabled, requests continue past the quota and the extra is billed per 1,000 instead of returning 402. On every plan, a batch request computes up to 100 charts at once.

Upgrades, downgrades and cancellations are self-service from your account page. Cancelling a paid plan drops you back to the free quota rather than revoking your keys, so an expired card never breaks your integration.

How limits work

Each chart, cycles or compatibility call counts as one request, and a batch counts one per chart. Every response carries X-Quota-Limit, X-Quota-Remaining and X-Quota-Reset headers, and we email you at 80% and 100% of your quota. The rate limit is 5 requests a second on Free, 25 on Starter and 100 on Pro. See quotas and rate limits for details.

Frequently asked questions

Is the numerology API really free?

Yes. The free plan costs nothing, needs no credit card and does not expire. It includes 100 requests a month on every endpoint.

Do I need a credit card to get an API key?

No. You only need an email address. A card is required only when you choose a paid plan.

What happens when I reach 100 requests?

The API returns HTTP 402 with quota headers until the quota resets. Nothing is billed automatically. You can upgrade at any time from your account page.

Can I use the free numerology API in a commercial app?

Yes. The free plan can be used in production, within its monthly quota and the terms of service.