> For the complete documentation index, see [llms.txt](https://infinitode-docs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://infinitode-docs.gitbook.io/docs/api-documentation.md).

# API Documentation

View our API documentation.

## Get started with APIs

Choose an endpoint from the navigation, then send a request with an API token. Each endpoint page defines its required parameters, response shape, rate limits, and examples.

Use a developer token while testing. Use a normal token when you need production output.

<a href="https://infinitode.netlify.app/openapi" class="button primary" data-icon="file-code">Browse OpenAPI specifications</a>

## Types of API calls

Our APIs offer two types of calls, namely:

1. Developer API calls
2. Normal API calls

{% hint style="info" %}
Our APIs will always default to the latest version available. The endpoint URL does not include the API version.\
You cannot switch between different API versions, as we only maintain the most recent stable version on our servers.
{% endhint %}

***

### Developer API calls

Use your developer API token to validate inputs and test an integration. Developer calls return validation details and dummy output. Do not use their output in production.

### Normal API calls

Use your normal API token for production requests. Normal calls return the endpoint's actual output.

{% hint style="info" %}
You can view more information, and questions about APIs, here:\
[Questions about APIs](https://infinitode-docs.gitbook.io/faqs/questions-about-apis)
{% endhint %}

***

## Plans and limits

Every account has a monthly allowance of normal and developer calls.

| Plan       | Price      | API calls / month | Developer calls / month |
| ---------- | ---------- | ----------------- | ----------------------- |
| Free       | $0         | 250               | 1,000                   |
| Business   | $9 / month | 25,000            | 50,000                  |
| Enterprise | Custom     | 250,000+          | 500,000+                |

Free allowances reset on the 1st of each month. Business allowances reset on your billing date, the same day each month PayPal charges you, once PayPal confirms the payment.

### Top-up packs (calls that never expire)

Need more calls without changing plan? Buy a pack from your account page. It works on any plan, including Free.

| Pack    | Price | API calls | Developer calls |
| ------- | ----- | --------- | --------------- |
| Boost   | $5    | 10,000    | 20,000          |
| Builder | $15   | 35,000    | 70,000          |
| Scale   | $40   | 100,000   | 200,000         |

* **Bought calls never expire.** They stay on your account through resets, plan changes and cancellations.
* **Your monthly allowance is always used first.** Bought calls are only used after it runs out, so they last as long as possible.
* **Normal and developer calls are separate.** A normal key uses the plan allowance, then bought API calls. A developer key uses the developer allowance, then bought developer calls. A developer key never uses up your bought normal calls.
* Prices are in US dollars and payment is handled by PayPal.
* **Unused packs can be refunded within 14 days** of the payment being confirmed. Refunded packs have their calls removed from your balances; see the [Refund Policy](https://infinitode.netlify.app/legal/refund-policy).

***

## :key: API Authentication

Our APIs require an API token. Upon registration, you receive a developer token and a normal token. The token you send determines the call type.

Use the developer token for test calls. Use the normal token for production calls.

#### Resetting a token

If a token leaks, you can replace it yourself — no support ticket needed. Each token has a **Reset** button on your account page, usable up to **3 times per week per token**, and the old token stops working the moment you press it. See [Keeping your API key safe](/docs/api-documentation/keeping-your-api-key-safe.md#reset-a-leaked-key-yourself).

#### API call history

Your account page lists every call made with either token for the **last 30 days**: the endpoint you hit, the method, the response status and error message, and whether the request used a call. See [See what your keys were used for](/docs/api-documentation/keeping-your-api-key-safe.md#see-what-your-keys-were-used-for).

#### Error responses

| Status                                      | Meaning                                                                             | Uses a call? |
| ------------------------------------------- | ----------------------------------------------------------------------------------- | ------------ |
| `400`                                       | Missing or invalid parameters                                                       | No           |
| `405`                                       | Wrong HTTP method                                                                   | No           |
| `429`                                       | Rate limit exceeded (25 requests per minute per key)                                | No           |
| `401` `"Invalid API key."`                  | The key is wrong, revoked, replaced by a reset, or missing its `INF-`/`DEV-` prefix | No           |
| `401` `"No remaining API calls."`           | Your monthly allowance **and** your bought calls are used up                        | No           |
| `401` `"No remaining developer API calls."` | Same, for developer calls                                                           | No           |
| `401` with another message                  | The request was accepted but failed while processing (e.g. an invalid expression)   | **Yes**      |

When you see "No remaining API calls.", wait for your reset date, upgrade to Business, or buy a [top-up pack](#top-up-packs-calls-that-never-expire).

{% hint style="danger" %}
If your API token is compromised, reset it yourself from your account page — you don't need to wait for support. Each token has a **Reset** button, usable up to 3 times per week per token, and the old token stops working the moment you press it. Check your [API call history](/docs/api-documentation/keeping-your-api-key-safe.md#see-what-your-keys-were-used-for) to see what was done with the leaked token, then update your deployment. Calls it already spent, including bought calls, can't be restored. Treat your normal key like a password. Anyone who has it can spend your calls, including calls you paid for.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://infinitode-docs.gitbook.io/docs/api-documentation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.