Skip to Content
CompanySpec
API referenceAccount

Get account and usage

GET
/account

Your plan, your current billing month and how much of each allowance you have used. Free.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Your API key, sent as Authorization: Bearer <key>. Create keys in the dashboard.

Response Body

Account details.

application/json
  1. response
plan*string

Your plan. See Billing & usage for what each plan includes.

Value in"free""starter""growth""pro""scale"
period*

Your current billing month. Allowances and "already paid" companies reset when it ends.

lookups*
discoveries*
Example Request
curl -X GET 'https://api.companyspec.com/v1/account'
Example Response
{  "plan": "starter",  "period": {    "start": "2026-11-03",    "end": "2026-12-02"  },  "lookups": {    "used": 250,    "limit": 10000  },  "discoveries": {    "used": 23,    "limit": 2000  }}

API reference

Base URL, conventions and the endpoint groups.

List filter values GET

Valid values for a filter, with the number of companies that have each value (across all companies). Use these values in `/companies/search`, `/companies/count`, `/companies/similar`, `/pages/search` and `/job-postings/search`. Free.