Ir al contenido principal
Companies

Get company by ID

Retrieves a single company by its Featurebase ID.

GET
/v2/companies/{id}

Path Parameters

  • id - The Featurebase internal ID of the company (MongoDB ObjectId)

Response

Returns a company object with:

  • id - Featurebase internal ID
  • companyId - External company ID from your system
  • name - Company name
  • monthlySpend - Monthly spend/revenue
  • industry - Industry
  • website - Company website URL
  • plan - Plan/tier name
  • linkedUsers - Number of users linked to this company
  • companySize - Employee headcount
  • lastActivity - Last activity timestamp
  • customFields - Custom field values
  • createdAt - Creation timestamp
  • updatedAt - Last update timestamp

Example Response

{
  "object": "company",
  "id": "507f1f77bcf86cd799439011",
  "companyId": "comp_12345",
  "name": "Acme Inc",
  "monthlySpend": 5000,
  "industry": "Technology",
  "website": "https://acme.com",
  "plan": "enterprise",
  "linkedUsers": 15,
  "companySize": 250,
  "lastActivity": "2025-01-15T00:00:00.000Z",
  "customFields": { "location": "Europe" },
  "createdAt": "2025-01-01T12:00:00.000Z",
  "updatedAt": "2025-01-10T15:30:00.000Z"
}

Error Responses

  • 404 Not Found - Company with the specified ID does not exist

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de ruta

idstringobligatorio

The Featurebase internal ID of the company (MongoDB ObjectId)

Ejemplo: 507f1f77bcf86cd799439011

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Ejemplo: 2026-08-19.orbit

Respuesta

application/json

Success

companyIdstringobligatorio

External company ID from your system

Ejemplo: comp_12345
companySizenumber | nullobligatorio

Company employee headcount

Ejemplo: 250
createdAtstring | nullobligatorio

ISO date when company was created

Ejemplo: 2025-01-01T12:00:00.000Z
customFieldsobject

Custom field values

idstringobligatorio

Featurebase internal ID

Ejemplo: 507f1f77bcf86cd799439011
industrystring | nullobligatorio

Industry

Ejemplo: Technology
lastActivitystring | nullobligatorio

ISO date of last activity

Ejemplo: 2025-01-15T00:00:00.000Z
linkedUsersnumber | nullobligatorio

Number of users linked to this company

Ejemplo: 15
monthlySpendnumber | nullobligatorio

Monthly spend

Ejemplo: 5000
namestringobligatorio

Company name

Ejemplo: Acme Inc
objectenum<string>obligatorio

Object type identifier

Opciones disponibles: company
Ejemplo: company
planstring | nullobligatorio

Plan or tier name

Ejemplo: enterprise
updatedAtstring | nullobligatorio

ISO date when company was last updated

Ejemplo: 2025-01-10T15:30:00.000Z
websitestring | nullobligatorio

Company website URL

Ejemplo: https://acme.com

¿Aún necesitas ayuda? Pregunta al equipo