---
title: "Classify SIC codes"
method: GET
path: "/web/sic"
tags: ["Web Extraction"]
---

# Classify SIC codes

`GET /web/sic`

## Request

- Base URL: `https://api.context.dev/v1`
- URL: `https://api.context.dev/v1/web/sic`
- Auth: HTTP bearer

Classify a company into SIC industry codes.

## Query parameters

- `input` string, required: Brand domain or title to retrieve SIC code for. If a valid domain is provided, it will be used for classification, otherwise, we will search for the brand using the provided title.
- `type` 'original_sic' | 'latest_sec': SIC dataset: `original_sic` (1987) or `latest_sec` (current SEC list).
- `minResults` integer: Minimum number of SIC codes to return. Must be at least 1. Defaults to 1.
- `maxResults` integer: Maximum number of SIC codes to return. Must be between 1 and 10. Defaults to 5.
- `timeoutOpts` PartialTimeout: Request deadline and what to return when it passes.
  - `milliseconds` integer, required: Deadline in milliseconds.
  - `behavior` 'fail' | 'return-partial': "fail" returns 408 at the deadline. "return-partial" returns available results; inspect the response’s partial flag.
- `zdr` 'enabled' | 'disabled': `enabled` turns on zero data retention. Returns 403 `ZDR_NOT_ENABLED` unless your organization has ZDR.
- `tags` string[]: Labels for filtering usage in the dashboard.

## Response `200`

Successful response

- object
  - `partial` boolean: True when the timeout ended processing and this response contains only usable results completed so far. Unfinished results are omitted.
  - `status` string: Always `ok` on success.
  - `domain` string: Domain found for the brand
  - `type` string: Industry classification type, for sic api it will be `sic`
  - `classification` 'original_sic' | 'latest_sec': Echoes back which SIC dataset was used to classify the brand.
  - `codes` object[]: Array of SIC codes with confidence scores. Extra fields depend on the requested classification: `original_sic` results include `majorGroup` and `majorGroupName`; `latest_sec` results include `office`.
    - `code` string, required: SIC code (4-digit).
    - `name` string, required: SIC industry title.
    - `confidence` 'high' | 'medium' | 'low', required: Confidence level for how well this SIC code matches the company description.
    - `majorGroup` string: 2-digit major group identifier (the leading two digits of the code). Only present when `classification` is `original_sic`.
    - `majorGroupName` string: Description of the 2-digit major group. Only present when `classification` is `original_sic`.
    - `office` string: SEC review office responsible for filings under this code. Only present when `classification` is `latest_sec`.
  - `key_metadata` KeyMetadata: Credits this request used and your remaining balance.
    - `credits_consumed` integer, required: Credits charged for this request.
    - `credits_remaining` integer, required: Credits remaining for your organization.
  - `request_id` string, uuid, required: Unique ID of this request, also in `X-Request-Id`. Include it when contacting support.

## Other responses

- `400`: Invalid input, company not found (`NOT_FOUND`), or the website could not be read.
- `401`: Missing or invalid API key.
- `402`: Insufficient credits (`USAGE_EXCEEDED`); authentication is valid. Retry once funded. Legacy deployments may return 401.
- `408`: Request Timeout
- `429`: Rate limit exceeded. Organization concurrency rejections include structured error_data and subscription settings; follow Retry-After before retrying.

## Changes

- **2026-10-21** `61627728926b`: 1 warning
  - added the new `NO_PUBLISHED_MARKDOWN` enum value to the `error_code` response property for the response status `402`
- **2026-10-19** `aeb64a2b7925`: 1 warning
  - added the new `USAGE_EXCEEDED` enum value to the `error_code` response property for the response status `401`
- **2026-10-19** `4ddcf49b9fe5`: 3 info
  - added the non-success response with the status `402`
  - added the optional property `error_data` to the response with the `429` status
  - removed the `USAGE_EXCEEDED` enum value from the `error_code` response property for the response status `401`
- **2026-10-16** `2125f3e94e52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context/apis/brand-api/changes/web/sic/get.md)

---

[API](https://skmtc.dev/context/apis/brand-api.md) · [All operations](https://skmtc.dev/context/apis/brand-api/llms.txt) · [OpenAPI document](https://skmtc.dev/context/apis/brand-api/revisions/9e2ab7841fb1?raw)