Querying Account Stats (V3 Developer API)

Querying Account Stats (V3 Developer API)

If you find you are in need of information about whether you can continue to query - or if you need to hold off to conserve quotas - you can call on our Stats Endpoint.

Understanding your current API usage is helpful, not only for billing purposes, but also within your application. For example, if you are nearing or have exceeded your usage limits for our Enrich API, you may want your application to behave differently, possibly limiting or preventing further requests until you have upgraded your plan to avoid overages. The Account Stats API will give you the insights needed to make these sorts of decisions by providing usage information for the current billing period.

Retrieving Usage

To get current usage, post a request to the Account Stats API. If you are interested in stats for particular APIs only, you can provide those in the statsproperty of the request post body.

Example Code: 

curl -X POST https://api.fullcontact.com/v3/stats.get \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{"stats":["person","company"]}'

    • Related Articles

    • Issues Verifying Your API Account

      When trying to verify your API account through the Platform via an international number, if you run into any issues please contact us and provide the following: Provide your phone number The country you were in when attempting to verify We will be ...
    • How to Cancel Your Account

      To cancel your account on one of our Premium Plans, fill out the "cancellation" form available on the FullContact Platform. Login to the FullContact Platform. Click on Plan & Billing at the bottom left corner. To the right of your plan name, you will ...
    • How to add Additional Users to Your FullContact Account

      In this short guide you will learn how to add other co-workers and users to your organizational account or "Organization" with FullContact. When you invite another user to your organization they will have the ability to: Login and view API usage data ...
    • Getting Started: Permission API

      FullContact's Permission API helps partners, agencies and brands monitor a range of permissions and preference activities over time and obtain information about an individual's consent, which includes: Acknowledgment and purpose of consented data ...
    • How to setup Multi Factor Authentication (MFA) on your FullContact account

      1. Login to Platform 2. Go to the Account Preferences page. Once logged in click on "My Account" -> "Account" in the bottom left menu bar: 3. Click "Edit" in the MFA row. Once on the "Account - Settings" tab, click "Edit" under the "MFA" field. 4. ...