Get Your Account
Retrieve your account information, including remaining credits and usage by data type.
curl -X GET "https://api.datafiniti.co/v4/account" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://api.datafiniti.co/v4/account"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.datafiniti.co/v4/account", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.datafiniti.co/v4/account", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.datafiniti.co/v4/account')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"email": "user@example.com",
"first_name": "John Doe",
"last_name": "John Doe",
"num_credits_used": 42,
"business_credits_allotted": 42,
"business_credits_used": 42,
"people_credits_allotted": 42,
"people_credits_used": 42,
"product_credits_allotted": 42,
"product_credits_used": 42,
"property_credits_allotted": 42,
"property_credits_used": 42
}
{
"error": "Bad Request",
"message": "The request contains invalid parameters or malformed data",
"code": 400,
"details": [
{
"field": "email",
"message": "Invalid email format"
}
]
}
/account
Bearer token obtained from the /auth endpoint. Include in requests as: Authorization: Bearer <token>
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Bearer token obtained from the /auth endpoint. Include in requests as: Authorization: Bearer <token>
Responses
Account email address
First name
Last name
Total credits used (legacy plans)
Business data credits allotted
Business data credits used
People data credits allotted
People data credits used
Product data credits allotted
Product data credits used
Property data credits allotted
Property data credits used
Error message describing what went wrong
This allows you to retrieve your account information, which is useful for checking how many credits you have remaining for the period.
Your credits used are based on the data plan you are using. These credits are split between business, people, products, and property. Each having their own separate limits for credit usage. Using this GET request will verify how many credits you have used.
If you are on a legacy plan, reference num_credits_used to verify overall credit consumption. Consult your plan's credits_allotted field for total limits.
Last updated Mar 26, 2026
Built with Documentation.AI