# Get Technographics Time Series

Returns monthly intensity time series per product for a single company. Dense arrays with null-filled gaps, ready for charting.

Endpoint: POST /data-api/v2/technographics/time-series
Security: authorization

## Security:

  - `authorization` (unknown)
    http bearer API_KEY

## Request body:

  - `application/json` (unknown)
    Technographics Time Series Request

## Request fields (application/json):

  - `company` (object, required)
    Company identifier. Provide exactly one of `id` or `domain`.
    Example: {"domain":"microsoft.com"}

  - `company.domain` (string)
    Company domain
    Example: microsoft.com

  - `company.id` (string)
    Hexadecimal identifier (unsigned 128-bit base 16 integer)
    Example: 1698C53EBC888758570396E0334965C1

  - `filters` (object)
    Example: {"vendors":{"ids":[376]}}

  - `filters.categories` (object)

  - `filters.categories.ids` (array)

  - `filters.country` (object)

  - `filters.country.codes` (array)
    ISO 3166-1 alpha-2 country codes to filter by

  - `filters.granularity` (string)
    Controls the shape of returned products. "country" returns one entry per product per country with `country_code` populated. "global" returns deduplicated entries per product with `country_code` null. Defaults to "global".
    Enum: "global", "country"

  - `filters.products` (object)

  - `filters.products.ids` (array)

  - `filters.vendors` (object)

  - `filters.vendors.ids` (array)

  - `max_products` (integer)

  - `time_range` (object)

  - `time_range.end_date` (string)

  - `time_range.relative_range` (string)
    Enum: "last_6m", "last_12m", "last_24m", "last_36m"

  - `time_range.start_date` (string)

## Response 200:

  - `200` (unknown)
    Technographics Time Series Response

## Response 200 fields (application/json):

  - `company` (object)

  - `products` (array)

  - `products.category` (string)

  - `products.country_code` (string)
    ISO 3166-1 alpha-2 country code. Populated when granularity is "country", null when "global".

  - `products.current_intensity` (integer)

  - `products.data_points` (array)

  - `products.data_points.date` (string)
    YYYY-MM

  - `products.data_points.intensity` (integer)

  - `products.intensity_momentum` (integer)

  - `products.is_active` (boolean)

  - `products.product_id` (integer)

  - `products.product_name` (string)

  - `products.vendor_name` (string)

  - `time_range` (object)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: The api key provided is not valid

  - `errors.source` (string)

  - `errors.title` (string, required)
    Example: Unauthorized

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.detail` (null, required)

  - `errors.source` (null)

  - `errors.title` (string, required)
    Example: Not Found

## Response 422:

  - `422` (unknown)
    Unprocessable Entity

## Response 422 fields (application/json):

  - `errors` (array, required)

  - `errors.detail` (string, required)
    Example: null value where string expected

  - `errors.source` (object, required)

  - `errors.source.pointer` (string, required)
    Example: /data/attributes/petName

  - `errors.title` (string, required)
    Example: Invalid value

## Response 503:

  - `503` (unknown)
    Service Unavailable

## Response 503 fields (application/json):

  - `errors` (array)

  - `errors.detail` (string, required)
    Example: Unable to verify credit availability. Please try again later. If the error persists, contact customersupport@hginsights.com.

  - `errors.source` (string)

  - `errors.title` (string, required)
    Example: Service unavailable