Organizations

Find, match, and enrich organizations

The single endpoint for working with organizations. Provide either a list of organizations to resolve (match mode) or an advanced query filter (search mode), and compose exactly which attributes and per-entity metrics you get back. This replaces the previous find, enrich, and match endpoints.

Input

Provide exactly one of:

• organizations — a list of up to 1,000 organizations to resolve, each identified by any combination of Sumble id, slug, name, url (domain), and location. At least a name or URL is required when you don't pass an id or slug. Covers the previous match and enrich flows.

• filter — an advanced query selecting the organizations to return (firmographics, technologies, job functions, and more). Covers the previous find flow.

Composable response

The select block dictates exactly which attributes return — nothing is mandatory:

• attributes — baseline company attributes such as employee_count, industry, jobs_count, teams_count, headquarters_country, sumble_score, funding fields, and the parent/subsidiary ids. id, name, slug, url, and sumble_url are always included for free.

• entities — per-entity metrics: for a technology, job function, project, advanced query, or technology category, request counts like job_post_count, people_count, team_count, growth, and concentration. Each result also includes a deep link to view the underlying data in Sumble.

Credit cost

Charged per matched organization (match mode) or per returned organization (search mode). Unmatched inputs are free.

Per organization the cost is:

• 1 base credit, plus:

• 1 credit per paid attribute requested (id, name, slug, url, and sumble_url are free), plus

• per entity selection, the number of metrics requested. metrics: "all" expands to every metric valid for that entity type. A technology_category entity with granularity: "exploded" multiplies by the number of technologies in the category.

For example, matching one organization and requesting 3 paid attributes plus one technology with 2 metrics costs 1 + 3 + 2 = 6 credits. The API checks affordability up front and returns HTTP 402 before doing any work you can't pay for.

Unified organizations endpoint

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

limitinteger · min: 1 · max: 200Optional

Maximum number of results to return.

Default: 10

offsetinteger · max: 10000Optional

Number of results to skip.

Default: 0

order_by_columnany of · nullableOptional

Column to order by (filter mode only). Parameterized sorts (this endpoint only): people_concentration and people_count_growth_1y sort by the named job function's people metrics — the all-time fraction of the org's tracked people in it, and its current YoY people growth % (latest month vs. one year earlier; orgs without growth data sort last) respectively — and require order_by_job_function. job_post_concentration sorts by the all-time fraction of the org's job posts matching order_by_advanced_query, which it requires. source_data_url is omitted for all three, since the listing page cannot reproduce their ordering.

string · enumOptionalPossible values:

or

string · enumOptionalPossible values:

or

const: job_post_concentrationOptional

order_by_directionstring · enum · nullableOptional

Direction to order by (filter mode only).

Possible values:

order_by_job_functionstring · nullableOptional

Job function whose people metrics drive the sort. Required with (and only valid with) order_by_column="people_concentration" or order_by_column="people_count_growth_1y".

order_by_advanced_querystring · nullableOptional

Advanced query whose matching job posts form the sort numerator. Required with (and only valid with) order_by_column="job_post_concentration". Allowed fields: technology, technology_category, job_function, project, job_level, country. Both the matching and total job counts are all-time.

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

matched_countinteger · nullableOptional

totalintegerRequired

source_data_urlstring · uri · min: 1 · max: 2083 · nullableOptional

422

Validation Error

application/json

post/v9/organizations

HTTPcURLJavaScriptPython

POST /v9/organizations HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 46

{
  "organizations": [
    {
      "id": 1726684
    }
  ],
  "select": {}
}

Lookup by Sumble id (no attributes requested)Filter (advanced query) instead of a listFilter sorted by a job function's people concentration (no source_data_url)Filter sorted by an advanced query's job post concentration (no source_data_url)Match by name/URL, request attributes

{
  "id": "019d06c6-9d55-75a4-bf7f-2bde9b85b772",
  "credits_used": 73,
  "credits_remaining": 98927,
  "organizations": [
    {
      "input": {
        "name": "Sumble",
        "url": "sumble.com"
      },
      "attributes": {
        "id": 1726684,
        "slug": "sumble",
        "name": "Sumble",
        "url": "sumble.com",
        "employee_count": 120,
        "industry": "Information",
        "jobs_count": 42,
        "teams_count": 8,
        "headquarters_country": "US",
        "sumble_score": 82.5,
        "sumble_url": "https://sumble.com/l/org/TH2y9mGkRr1q",
        "subsidiary_ids": [],
        "tags": [
          "digital_native",
          "b2b",
          "is_ai_native",
          "is_venture_backed"
        ]
      },
      "entities": [
        {
          "type": "technology",
          "term": "kubernetes",
          "job_post_count": 3,
          "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs",
          "people_count": 2,
          "people_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/people",
          "job_post_count_growth_1y": 51.9,
          "job_post_count_growth_1y_url": "https://sumble.com/l/org/TH2y9mGkRr1q/trends/technologies"
        },
        {
          "type": "job_function",
          "term": "Data Engineer",
          "job_post_count": 1,
          "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs",
          "team_count": 1,
          "team_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/teams",
          "people_count": 0,
          "people_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/people",
          "people_concentration": 0,
          "people_count_growth_1y": 0.25,
          "people_count_growth_1y_url": "https://sumble.com/l/org/TH2y9mGkRr1q/trends/job_functions_people"
        },
        {
          "type": "advanced_query",
          "term": "technology EQ 'react'",
          "job_post_count": 2,
          "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs",
          "team_count": 1,
          "team_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/teams",
          "people_count": 1,
          "people_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/people",
          "job_post_concentration": 0.0476
        },
        {
          "type": "technology_category",
          "term": "logging-observability-monitoring",
          "granularity": "aggregate",
          "job_post_count": 4,
          "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs",
          "team_count": 2,
          "team_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/teams",
          "people_count": 3,
          "people_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/people"
        },
        {
          "type": "technology_category",
          "term": "logging-observability-monitoring",
          "granularity": "exploded",
          "components": [
            {
              "type": "technology",
              "term": "datadog",
              "job_post_count": 3,
              "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs"
            },
            {
              "type": "technology",
              "term": "prometheus",
              "job_post_count": 1,
              "job_post_count_url": "https://sumble.com/l/org/TH2y9mGkRr1q/jobs"
            }
          ]
        }
      ]
    },
    {
      "input": {
        "name": "Nonexistent",
        "url": "nonexistent.example"
      },
      "attributes": {},
      "entities": []
    }
  ],
  "matched_count": 1,
  "total": 2
}

---

Organization signals

Recent signals for a single organization — champion movements, recent hires and promotions, technology and product mentions, projects and initiatives, and technology or job function trends — now have their own page: see Organization signals.