# 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 /v6/jobs/find

> Find job listings

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"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":{"/v6/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 /v6/jobs/{job\_id}

> Get job details

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"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":{"/v6/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 /v6/jobs/find-related-people

> Find people related to a job listing

```json
{"openapi":"3.1.0","info":{"title":"Sumble API","version":"v6"},"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":{"/v6/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"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sumble.com/api/jobs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.