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

# Organisation API

Your integrations spend credits and add companies and contacts to your dataset, and it helps to know how much room is left before they do. The Organisation API reports your account's credit balances and dataset limits in a single call.

It reads your own account, so any of your API keys can use it.

Common uses:

* Checking there are enough credits before starting an enrichment run.
* Warning your team before your dataset reaches its company or contact limit.
* Showing your balance in your own tools, alongside your Goodfit data.

### **In this section**

* API reference: the endpoint, authentication, rate limits and error codes.

### **What you get back**

Two things, both covering your whole account:

* **Credits** are consumable balances, spent when enrichment runs. A contact credit is spent when a contact is granted, whether or not an email was found. A phone number credit is spent only when a phone number is actually found.
* **Limits** are ceilings on the size of your dataset, one for companies and one for contacts, each reported with its current usage.

A `null` value means no limit is set, not that nothing is remaining.

### **Credit usage**

Checking your balance is free. Calls to this API don't spend credits.

### **Support**

Contact your account manager if your balance or limits don't look right.

***

####