GET /v1/accounts/{account_id} — Get Account by ID

The Get Account endpoint retrieves the complete profile for a single identified company account. You can look up an account using its Knock2 account ID or by passing a company domain directly as the path parameter — making it easy to integrate without first running a List Accounts query. The response includes full firmographic details, CRM sync fields, and a summary of the account’s visit activity on your website.

Endpoint

GET https://api.knock2.ai/v1/accounts/{account_id}

Required Scope

Your API key must have the accounts:read scope (or the broader all:read scope) to call this endpoint.

Path Parameters

string

required

The unique identifier of the account to retrieve. Accepts either:

A Knock2 account ID (e.g. acc_01HX...), or
A company domain (e.g. acme.com) for a domain-based lookup.

When you pass a domain, Knock2 returns the account associated with that domain, if one has been identified.

Request Parameters

string

Read a direct child tenant’s account instead of your own (multi-tenant partners only). The X-Knock-Tenant header takes precedence if both are supplied. See Reading a Child Tenant’s Data.

string

Same as product_slug above, as a header instead of a query param. Naming a slug that isn’t a direct child of your key returns 404, never 403.

Example Requests

curl https://api.knock2.ai/v1/accounts/acc_01HX... \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.knock2.ai/v1/accounts/acme.com \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Returns 200 OK with a data object containing the full account record.

Example response

{
  "data": {
    "id": "acc_01HX...",
    "name": "Acme Corp",
    "domain": "acme.com",
    "logo_url": "https://logo.clearbit.com/acme.com",
    "linkedin_url": "https://www.linkedin.com/company/acme-corp",
    "industry": "Software",
    "sector": "Technology",
    "description": "Acme Corp builds enterprise workflow automation tools.",
    "estimated_employee_count": "51-200",
    "estimated_annual_revenue": "10M-50M",
    "phone_numbers": ["+14155550100"],
    "tags": ["hot-lead", "enterprise"],
    "technology_tags": ["Salesforce", "HubSpot"],
    "address_city": "San Francisco",
    "address_state": "CA",
    "address_zip_code": "94105",
    "address_country": "US",
    "location": "San Francisco, CA, US",
    "last_funding_date": "2023-09-01",
    "last_funding_round_type": "Series B",
    "last_funding_amount": "25M",
    "crm_deal_source": "Inbound",
    "crm_deal_name": "Acme Corp — Enterprise",
    "crm_deal_stage": "Proposal",
    "crm_deal_value_usd": 48000,
    "crm_deal_close_datetime": "2024-09-30T00:00:00Z",
    "crm_deal_owner_email": "alice@yourcompany.com",
    "crm_deal_owner_first_name": "Alice",
    "crm_deal_owner_last_name": "Johnson",
    "crm_company_owner_email": "alice@yourcompany.com",
    "crm_company_owner_first_name": "Alice",
    "crm_company_owner_last_name": "Johnson",
    "hubspot_company_id": "1234567890",
    "salesforce_account_id": "0015g00000AbCdEf",
    "latest_visit_datetime": "2024-06-01T14:23:00Z",
    "latest_visit_page": "/pricing",
    "page_visits": [
      {
        "page": "/pricing",
        "start_time": "2024-06-01T14:20:00Z",
        "end_time": "2024-06-01T14:23:45Z"
      },
      {
        "page": "/product",
        "start_time": "2024-06-01T14:10:00Z",
        "end_time": "2024-06-01T14:18:30Z"
      }
    ],
    "total_browsing_time_seconds": 1842,
    "utms": {},
    "document_referrer": "https://www.google.com",
    "utm_source": "google",
    "utm_medium": "cpc",
    "utm_campaign": "brand",
    "utm_term": null,
    "utm_content": null,
    "is_from_enrichment": false,
    "created_at": "2024-05-15T09:00:00Z"
  }
}

Response Fields

object

required

The full account record.

Show Account object fields

string

The unique Knock2 identifier for this account.

string

The company’s display name (e.g. "Acme Corp").

string

The company’s primary web domain (e.g. "acme.com").

string

URL to the company’s logo image, if available.

string

URL to the company’s LinkedIn profile page.

string

The company’s industry classification (e.g. "Software", "Financial Services").

string

The broader sector the company belongs to (e.g. "Technology", "Healthcare").

string

A short company description sourced from enrichment data.

string

A bucketed range representing the company’s headcount (e.g. "51-200", "201-500").

string

A bucketed range representing the company’s estimated annual revenue (e.g. "10M-50M", "50M-200M").

array

A list of phone numbers associated with the company.

array

A list of tags applied to this account in Knock2.

array

A list of technologies detected in use at this company (e.g. "Salesforce", "HubSpot").

string

The city where the company is located.

string

The state or province where the company is located.

string

The postal or ZIP code for the company’s address.

string

The country where the company is located (ISO 3166-1 alpha-2 code, e.g. "US").

string

A human-readable location string combining city, state, and country.

string

ISO 8601 date of the company’s most recent funding event, if available.

string

The type of the most recent funding round (e.g. "Series A", "Seed").

string

The amount raised in the most recent funding round.

string

The lead source of the associated CRM deal, if synced.

string

The name of the associated CRM deal, if synced.

string

The pipeline stage of the associated CRM deal (e.g. "Proposal", "Closed Won").

number

The monetary value of the associated CRM deal in USD.

string

ISO 8601 timestamp of the expected or actual close date for the associated CRM deal.

string

Email address of the deal owner in your CRM.

string

First name of the deal owner in your CRM.

string

Last name of the deal owner in your CRM.

string

Email address of the company owner in your CRM.

string

First name of the company owner in your CRM.

string

Last name of the company owner in your CRM.

string

The corresponding HubSpot Company record ID, if synced.

string

The corresponding Salesforce Account record ID, if synced.

string

ISO 8601 timestamp of the account’s most recent visit.

string

The URL path of the most recent page this account visited on your website (e.g. "/pricing").

array

The account’s most recent page visits (up to 100), newest first. Each entry has page (string), start_time (ISO 8601), and end_time (ISO 8601, null if the visit is still open).

integer

The total cumulative time in seconds this account has spent on your website across all sessions.

object

A map of all UTM parameters captured from this account’s visits.

string

The referrer URL from the account’s most recent visit.

string

The utm_source value from the most recent tracked visit.

string

The utm_medium value from the most recent tracked visit.

string

The utm_campaign value from the most recent tracked visit.

string

The utm_term value from the most recent tracked visit.

string

The utm_content value from the most recent tracked visit.

boolean

true if this account record was created via enrichment rather than a live website visit.

string

ISO 8601 timestamp of when this account was first identified by Knock2.

Error Responses

HTTP Status	`code`	Description
`401`	`unauthorized`	Your API key is missing or invalid.
`403`	`forbidden`	Your API key does not have the `accounts:read` scope.
`404`	`not_found`	No account was found for the given ID or domain.
`422`	`validation_error`	The request parameters failed validation.
`429`	`rate_limit_exceeded`	You have exceeded the rate limit. Apply exponential backoff and retry.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key.",
    "details": null
  }
}

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No account found for the provided ID or domain.",
    "details": null
  }
}

422 Validation Error

{
  "error": {
    "code": "validation_error",
    "message": "Invalid account_id format.",
    "details": null
  }
}

429 Rate limit exceeded

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Please slow down and retry with exponential backoff.",
    "details": null
  }
}

Overview

Accounts

Contacts

Activity & Scores

Filter Sets

Webhooks

Enrichment & Auth

Tenants & Script

GET /v1/accounts/{account_id} — Get Account by ID

Endpoint

Required Scope

Path Parameters

Request Parameters

Example Requests

Response

Response Fields

Error Responses

​Endpoint

​Required Scope

​Path Parameters

​Request Parameters

​Example Requests

​Response

​Response Fields

​Error Responses

Endpoint

Required Scope

Path Parameters

Request Parameters

Example Requests

Response

Response Fields

Error Responses