# Jobs

Find job postings by organization and filters. Jobs can be scoped to a specific organization or searched broadly.

## Credit cost

Each job returned costs **2 credits**, or **3 credits** if `include_descriptions` is set to `true`.

## POST /v5/jobs/find

> Find job listings

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v5"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"FindJobsRequest":{"properties":{"organization":{"anyOf":[{"$ref":"#/components/schemas/OrganizationByDomain"},{"$ref":"#/components/schemas/OrganizationById"},{"$ref":"#/components/schemas/OrganizationBySlug"},{"$ref":"#/components/schemas/OrganizationByLinkedinUrl"},{"type":"null"}],"title":"Organization","description":"Organization to enrich"},"filters":{"anyOf":[{"$ref":"#/components/schemas/app__schemas__paid_api__jobs__FindJobsRequest__Filters"},{"$ref":"#/components/schemas/Query"}],"title":"Filters","description":"Filters to apply to the jobs search. Can be either a Filters object or a Query object."},"include_descriptions":{"type":"boolean","title":"Include Descriptions","description":"Whether to include job descriptions in the response. If false, each job costs 2 credits instead of 3.","default":false},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum number of people to return","default":10},"offset":{"type":"integer","maximum":10000,"minimum":0,"title":"Offset","description":"Number of results to skip","default":0}},"type":"object","required":["filters"],"title":"FindJobsRequest"},"OrganizationByDomain":{"properties":{"domain":{"type":"string","title":"Domain","description":"Company web domain"}},"type":"object","required":["domain"],"title":"OrganizationByDomain"},"OrganizationById":{"properties":{"id":{"type":"integer","title":"Id","description":"Organization Id on Sumble"}},"type":"object","required":["id"],"title":"OrganizationById"},"OrganizationBySlug":{"properties":{"slug":{"type":"string","title":"Slug","description":"Organization Slug on Sumble"}},"type":"object","required":["slug"],"title":"OrganizationBySlug"},"OrganizationByLinkedinUrl":{"properties":{"linkedin_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Linkedin Url","description":"Organization LinkedIn URL"}},"type":"object","required":["linkedin_url"],"title":"OrganizationByLinkedinUrl"},"app__schemas__paid_api__jobs__FindJobsRequest__Filters":{"properties":{"technologies":{"items":{"type":"string"},"type":"array","title":"Technologies","description":"Technologies to search for","default":[]},"technology_categories":{"items":{"type":"string"},"type":"array","title":"Technology Categories","description":"Technology categories to search for","default":[]},"countries":{"items":{"type":"string"},"type":"array","title":"Countries","description":"Countries to filter by (e.g. US, CA)","default":[]},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since","description":"Only consider data since this date. Format: YYYY-MM-DD"}},"type":"object","title":"Filters"},"Query":{"properties":{"query":{"type":"string","title":"Query"}},"type":"object","required":["query"],"title":"Query"},"FindJobsResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"jobs":{"items":{"$ref":"#/components/schemas/Job"},"type":"array","title":"Jobs"},"source_data_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Source Data Url"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["id","credits_used","credits_remaining","jobs","source_data_url","total"],"title":"FindJobsResponse"},"Job":{"properties":{"id":{"type":"integer","title":"Id"},"organization_id":{"type":"integer","title":"Organization Id"},"organization_name":{"type":"string","title":"Organization Name"},"organization_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Domain"},"job_title":{"type":"string","title":"Job Title"},"datetime_pulled":{"type":"string","format":"date-time","title":"Datetime Pulled"},"primary_job_function":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Job Function"},"location":{"type":"string","title":"Location"},"teams":{"type":"string","title":"Teams"},"matched_projects":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Projects"},"projects_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Projects Description"},"matched_technologies":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Technologies"},"matched_job_functions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Job Functions"},"projects":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Projects"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"url":{"type":"string","title":"Url"}},"type":"object","required":["id","organization_id","organization_name","organization_domain","job_title","datetime_pulled","primary_job_function","location","teams","matched_projects","projects_description","matched_technologies","matched_job_functions","projects","url"],"title":"Job"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v5/jobs/find":{"post":{"tags":["jobs"],"summary":"Find job listings","operationId":"find_jobs__api_version__jobs_find_post","parameters":[{"name":"require_mcp","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Mcp"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindJobsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindJobsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

***

## Get job details

Retrieve a job's title and full description by its ID. Use the `id` field returned from the find endpoint.

### Credit cost

Each request costs 1 credit.

## GET /v5/jobs/{job\_id}

> Get job details

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v5"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"JobDetailsResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"job":{"$ref":"#/components/schemas/JobDetails"}},"type":"object","required":["id","credits_used","credits_remaining","job"],"title":"JobDetailsResponse"},"JobDetails":{"properties":{"job_title":{"type":"string","title":"Job Title"},"description":{"type":"string","title":"Description"}},"type":"object","required":["job_title","description"],"title":"JobDetails"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v5/jobs/{job_id}":{"get":{"tags":["jobs"],"summary":"Get job details","operationId":"get_job_details__api_version__jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"integer","title":"Job Id"}},{"name":"require_mcp","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Mcp"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

***

## Find related people

Find people related to a specific job listing. Given a job ID, returns the people most relevant to that role — typically hiring managers and team members at the organization.

### Credit cost

Each person returned costs 1 credit.

## POST /v5/jobs/find-related-people

> Find people related to a job listing

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v5"},"servers":[{"url":"https://api.sumble.com"}],"security":[{"api_token":[]}],"components":{"securitySchemes":{"api_token":{"type":"http","scheme":"bearer"}},"schemas":{"FindRelatedPeopleRequest":{"properties":{"job_id":{"type":"integer","title":"Job Id","description":"Job post ID to find related people for"},"limit":{"type":"integer","maximum":100,"minimum":1,"title":"Limit","description":"Maximum number of people to return","default":10},"offset":{"type":"integer","maximum":10000,"minimum":0,"title":"Offset","description":"Number of results to skip","default":0}},"type":"object","required":["job_id"],"title":"FindRelatedPeopleRequest"},"FindRelatedPeopleResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"type":"integer","title":"Credits Remaining"},"total":{"type":"integer","title":"Total"},"people":{"items":{"$ref":"#/components/schemas/PersonResult"},"type":"array","title":"People"},"source_data_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Source Data Url"}},"type":"object","required":["id","credits_used","credits_remaining","total","people","source_data_url"],"title":"FindRelatedPeopleResponse"},"PersonResult":{"properties":{"id":{"type":"integer","title":"Id"},"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"linkedin_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Linkedin Url"},"name":{"type":"string","title":"Name"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"job_function":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Function"},"job_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Level"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"}},"type":"object","required":["id","url","linkedin_url","name","job_title","job_function","job_level","location","country","start_date","country_code"],"title":"PersonResult"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v5/jobs/find-related-people":{"post":{"tags":["jobs"],"summary":"Find people related to a job listing","operationId":"find_related_people__api_version__jobs_find_related_people_post","parameters":[{"name":"require_mcp","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Mcp"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindRelatedPeopleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindRelatedPeopleResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```