BixelDocs
API reference

Get a company's change history

GET
/v1/companies/{company}/history

One company's dated change log, filterable by dimension, date range, exact fact_key, or derivation class (default serves confirmed + historical). Access ladder: keyless = masked (90 days / 50 events); free key = values within the last 90 days, with cursors; Pro = full depth back to the earliest event (2020 for the deepest members).

Authorization

AuthorizationBearer <token>

bx_-prefixed API key. Free keys: https://bixel.com/account/

In: header

Path Parameters

company*string

Apex domain (canonical, e.g. pinecone.io). Bare values are resolved as legacy slugs. Unknown names: resolve via /v1/search first.

Query Parameters

dimension?string

Value in

  • "pricing"
  • "features"
  • "security"
  • "positioning"
  • "stack"
  • "hiring"
  • "reliability"
  • "funding"
  • "location"
  • "legal"
since?string
Formatdate
until?string
Formatdate
fact_key?string
derivation?string

Filter to one derivation class. Unset serves the default feed: confirmed + historical. baseline/legacy/orphaned are inspectable but never pose as live change.

Value in

  • "confirmed"
  • "historical"
  • "baseline"
  • "legacy"
  • "orphaned"
limit?integer

Page size, default 50, max 200.

Range1 <= value <= 200
Default50
cursor?string

Opaque keyset cursor from meta.next_cursor; pass back exactly as received.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/companies/pinecone.io/history"
{  "data": {    "company": {      "name": "string",      "domain": "string",      "slug": "string"    },    "events": [      {        "id": "string",        "company": "string",        "dimension": "string",        "fact_key": "string",        "type": "pricing_changed",        "significance": "normal",        "detected_at": "2019-08-24",        "derivation": "confirmed",        "masked": true,        "old_value": null,        "new_value": null,        "summary": "string"      }    ]  },  "meta": {    "generated_at": "2019-08-24T14:15:22Z",    "count": 0,    "total": 0,    "next_cursor": "string",    "notice": "string"  }}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}