Organizations

Find organizations

Find organizations matching a set of filters. This is the API equivalent of the organization search on sumble.com.

Credit cost

Credit cost depends on whether you pass include_entity_details: true:

Without include_entity_details (or set to false): 5 credits per row returned.
With include_entity_details: true: results include technology counts per organization. The cost is 5 credits per filter term (technologies, job functions, or projects) per organization, with a minimum of 5 credits per organization. When filtering by technology categories, each technology in the category counts as a separate filter term — a category with 3 technologies costs 15 credits per organization.

Find organizations

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

require_mcpbooleanOptionalDefault: false

Body

filtersany ofRequired

Filters to apply to the people search. Can be either a Filters object or a Query object.

order_by_columnany ofOptional

Column to order by

string · enumOptionalPossible values:

nullOptional

order_by_directionany ofOptional

Direction to order by

string · enumOptionalPossible values:

nullOptional

include_entity_detailsbooleanOptional

Whether to include entity-specific data (matching_entities) in the response

Default: false

limitinteger · min: 1 · max: 200Optional

Maximum number of results to return

Default: 10

offsetinteger · max: 10000Optional

Number of results to skip

Default: 0

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

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

totalintegerRequired

422

Validation Error

application/json

post

/v6/organizations/find

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

{
  "filters": {
    "technologies": [
      "python",
      "react"
    ],
    "technology_categories": [
      "cybersecurity"
    ]
  },
  "include_entity_details": true
}

{
  "id": "0199f400-4123-7eca-9082-be2c94676bfc",
  "credits_used": 5,
  "credits_remaining": 9487,
  "organizations": [
    {
      "id": 1726684,
      "name": "Sumble",
      "url": "https://sumble.com/l/org/TH2y9mGkRr1q",
      "industry": "Information",
      "total_employees": 12,
      "matching_people_count": 1,
      "matching_team_count": 1,
      "matching_job_post_count": 1,
      "headquarters_country": "US",
      "headquarters_state": "California",
      "domain": "sumble.com",
      "linkedin_organization_url": "https://www.linkedin.com/company/sumble",
      "account_score": 82.5,
      "account_score_fit": "good",
      "matching_tags": [
        "digital_native"
      ],
      "matching_entities": [
        {
          "type": "technologies",
          "term": "react",
          "job_post_count": 1,
          "people_count": 1,
          "team_count": 1
        }
      ],
      "funding_last_round_type": "series_a",
      "funding_last_round_date": "2024-06-15",
      "funding_total_raised": 12000000,
      "funding_sources": [
        "https://example.com/funding-story"
      ]
    }
  ],
  "total": 1
}

Enrich an organization

Enrich an organization with technology data. Provide a domain or organization slug, plus optional technology filters, and get back which of those technologies appear in the organization's job posts and team activity.

When providing technology categories, all individual technologies in those categories will be used.

Credit cost

Each technology found costs 5 credits. If you filter by 10 technologies and 3 are found, that costs 15 credits.

Enrich an organization with technology data

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

require_mcpbooleanOptionalDefault: false

Body

organizationany ofRequired

Organization to enrich

filtersany ofRequired

Filters to apply to the people search. Can be either a Filters object or a Query object.

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

technologies_foundstringRequired

technologies_countintegerRequired

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

422

Validation Error

application/json

post

/v6/organizations/enrich

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

{
  "organization": {
    "domain": "sumble.com"
  },
  "filters": {
    "technologies": [
      "python",
      "react"
    ],
    "technology_categories": [
      "cybersecurity"
    ],
    "since": "2025-01-01"
  }
}

{
  "id": "01998090-e970-732b-9d68-740f1a830902",
  "credits_used": 10,
  "credits_remaining": 69258,
  "organization": {
    "id": 1726684,
    "slug": "sumble",
    "name": "Sumble",
    "domain": "sumble.com"
  },
  "technologies_found": "Python, React",
  "technologies_count": 2,
  "source_data_url": "https://sumble.com/l/org/fa82oqKqXpW",
  "technologies": [
    {
      "name": "Python",
      "last_job_post": "2025-09-23",
      "jobs_count": 1,
      "jobs_data_url": "https://sumble.com/l/org/t5BLxGT4tLs/jobs",
      "people_count": 0,
      "people_data_url": "https://sumble.com/l/org/t5BLxGT4tLs/people",
      "teams_count": 1,
      "teams_data_url": "https://sumble.com/l/org/t5BLxGT4tLs/teams"
    },
    {
      "name": "React",
      "last_job_post": "2025-09-23",
      "jobs_count": 1,
      "jobs_data_url": "https://sumble.com/l/org/8nQuDcManoc/jobs",
      "people_count": 0,
      "people_data_url": "https://sumble.com/l/org/8nQuDcManoc/people",
      "teams_count": 1,
      "teams_data_url": "https://sumble.com/l/org/8nQuDcManoc/teams"
    }
  ]
}

Retrieve an intelligence brief

Retrieve an AI-generated intelligence brief for an organization. The brief summarizes the account angle, relevant contacts, technology signals, teams, and recent changes, and includes a link to view the same brief in Sumble.

Intelligence briefs are generated asynchronously. If the brief is still being prepared, the API returns HTTP 202 with a Retry-After header. Retry the same URL after that interval to get the completed brief.

Credit cost

Completed intelligence briefs cost 50 credits. HTTP 202 pending responses do not consume credits.

Retrieve the intelligence brief for an organization

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_idintegerRequired

Query parameters

require_mcpbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

202

The brief is being generated. Retry the same URL after the Retry-After header. No credits are consumed.

application/json

422

The organization/domain does not have enough data to generate an intelligence brief. No credits are consumed.

application/json

get

/v6/organizations/{organization_id}/intelligence-brief

GET /v6/organizations/{organization_id}/intelligence-brief HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "019d25ba-90e8-7a3c-a008-7f0bf41ac79a",
  "credits_used": 50,
  "credits_remaining": 9900,
  "organization_id": 1726684,
  "organization_slug": "vanta",
  "title": "Vanta intelligence brief for Sumble",
  "body": "Vanta intelligence brief for Sumble\n\nThis brief is also [available on Sumble.com](https://sumble.com/l/org/MIkfQDbGSbraK/overview?intelligence_brief=1)\n\n## What's the Angle\n\nVanta is hiring into teams...\n\n## Who To Contact First\n\nPrioritize engineering leaders...",
  "sumble_url": "https://sumble.com/l/org/MIkfQDbGSbraK/overview?intelligence_brief=1"
}

Match organizations

Submit a list of up to 1,000 organizations and get back which ones Sumble can identify. For each organization you provide a name, URL, and/or location — at least a name or URL is required. Sumble's entity resolution engine matches your input against its database and returns the matched organization details.

This is useful for syncing a CRM export or target-account list with Sumble's data before running enrichment or search queries.

Credit cost

1 credit per matched organization. Unmatched organizations are returned in the response but do not consume credits.

Match a list of organizations

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

require_mcpbooleanOptionalDefault: false

Body

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

matched_countintegerRequired

totalintegerRequired

422

Validation Error

application/json

post

/v6/organizations/match

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

{
  "organizations": [
    {
      "name": "Sumble",
      "url": "sumble.com"
    },
    {
      "name": "Google",
      "location": "US"
    }
  ]
}

{
  "id": "019d06c6-9d55-75a4-bf7f-2bde9b85b772",
  "credits_used": 2,
  "credits_remaining": 98908,
  "results": [
    {
      "input": {
        "name": "Sumble",
        "url": "sumble.com"
      },
      "match": {
        "id": 1726684,
        "slug": "sumble",
        "name": "Sumble",
        "domain": "sumble.com"
      }
    },
    {
      "input": {
        "name": "Google",
        "location": "US"
      },
      "match": {
        "id": 59,
        "slug": "google",
        "name": "Google",
        "domain": "google.com"
      }
    }
  ],
  "matched_count": 2,
  "total": 2
}

PreviousAPI NextJobs

Last updated 17 days ago