Organizations

You can find organizations matching a particular filter (analogous to what you can do on our homepage).

Successful calls to this endpoint consume API credits from your account. The cost of each retrieved organization depends on the number of filters you apply. The organization cost is 5 credits per filter, with a minimum of 5 credits (requests with no filters applied cost 5 credits per organization).

When filtering by technology categories, we apply each technology as a filter. A technology category with 3 technologies then costs 15 credits per organization found.

Find organizations

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

filtersany ofRequired

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

or

order_by_columnany ofOptional

Column to order by

string · enumOptionalPossible values:

or

nullOptional

order_by_directionany ofOptional

Direction to order by

string · enumOptionalPossible values:

or

nullOptional

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

/v3/organizations/find

HTTPcURLJavaScriptPython

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

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

Example with filtersExample with advanced query

{
  "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_teams_count": 1,
      "matching_job_posts_count": 1,
      "headquarters_country": "US",
      "headquarters_state": "California",
      "domain": "sumble.com",
      "linkedin_organization_url": "https://www.linkedin.com/company/sumble",
      "matching_tags": [
        "digital_native"
      ],
      "matching_entities": [
        {
          "type": "technologies",
          "term": "react",
          "job_post_count": 1,
          "people_count": 1,
          "team_count": 1
        }
      ]
    }
  ],
  "total": 1
}

Enrich an organization with technology data. When providing technology categories, all the technologies in those categories will be used.

Successful calls to this endpoint consume API credits from your account. The number of credits used depends on the number of technologies found. Each technology found costs 5 credits.

Enrich an organization with technology data

post

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

organizationany ofRequired

Organization to enrich

or

or

filtersany ofRequired

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

or

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

/v3/organizations/enrich

HTTPcURLJavaScriptPython

POST /v3/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"
  }
}

Example with filtersExample with advanced query

{
  "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"
    }
  ]
}