> ## Documentation Index > Fetch the complete documentation index at: https://jobo.world/docs/llms.txt > Use this file to discover all available pages before exploring further. # List a company's jobs ## OpenAPI ````yaml /openapi.yaml get /api/companies/{id}/jobs openapi: 3.0.3 info: title: Jobo Enterprise API description: > The Jobo Enterprise API provides programmatic access to job listings, intelligent search, real-time feeds, geocoding services, and a contract preview for callback-driven job applications. Auto Apply is coming soon and is not available in beta or production. version: '2026-07-21' contact: name: Jobo Support url: https://jobo.world email: support@jobo.world license: name: Proprietary — see terms of service url: https://jobo.world/terms termsOfService: https://jobo.world/terms servers: - url: https://connect.jobo.world description: Production security: - ApiKeyAuth: [] tags: - name: Jobs description: Search and retrieve job listings - name: Feed description: Bulk job feeds and expiration tracking - name: Companies description: Company profiles and company-scoped job listings - name: Auto Apply description: >- Coming soon: profileless applications answered through signed, typed HTTPS callbacks - name: Locations description: Geocoding and location services paths: /api/companies/{id}/jobs: get: tags: - Companies summary: List a company's jobs operationId: listJobsByCompany parameters: - name: id in: path required: true schema: type: string format: uuid description: Unique company identifier - name: posted_after in: query schema: type: string format: date-time description: >- Only return jobs whose employer posting date is on or after this date - name: page in: query schema: type: integer default: 1 minimum: 1 description: Page number (1-indexed) - name: page_size in: query schema: type: integer default: 25 minimum: 1 maximum: 100 description: Number of results per page (max 100) responses: '200': description: Paginated list of jobs scoped to this company headers: X-Total-Count: schema: type: integer description: Total number of jobs for this company X-Total-Pages: schema: type: integer description: Total number of pages X-Page: schema: type: integer description: Current page number X-Page-Size: schema: type: integer description: Number of results per page content: application/json: schema: $ref: '#/components/schemas/JobSearchResponse' '400': description: Invalid pagination parameters content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': $ref: '#/components/responses/Unauthorized' x-codeSamples: - lang: cURL source: > curl -G "https://connect.jobo.world/api/companies/b5e6f7a8-1234-5678-9abc-def012345678/jobs" \ -H "X-Api-Key: $JOBO_API_KEY" \ --data-urlencode "page_size=50" - lang: Python source: | from jobo_enterprise import JoboClient with JoboClient(api_key="YOUR_API_KEY") as client: jobs = client.companies.get_jobs( "b5e6f7a8-1234-5678-9abc-def012345678", page_size=50, ) print(f"{jobs.total} open roles") components: schemas: JobSearchResponse: type: object required: - jobs - total - page - page_size - total_pages - facets properties: jobs: type: array items: $ref: '#/components/schemas/JobDto' total: type: integer format: int64 page: type: integer page_size: type: integer total_pages: type: integer facets: type: object additionalProperties: type: array items: $ref: '#/components/schemas/JobFacetDto' ProblemDetails: type: object description: Problem Details object returned for error responses. properties: type: type: string nullable: true title: type: string nullable: true status: type: integer nullable: true detail: type: string nullable: true instance: type: string nullable: true code: type: string nullable: true description: Stable machine-readable code for Auto Apply domain errors. api_version: $ref: '#/components/schemas/AutoApplyApiVersion' JobDto: type: object required: - id - title - normalized_title - company - description - summary - listing_url - apply_url - locations - compensation - employment_type - workplace_type - experience_level - source - created_at - updated_at - date_posted - valid_through - qualifications - responsibilities - benefits - is_work_auth_required - is_h1b_sponsor - is_clearance_required properties: id: type: string format: uuid title: type: string normalized_title: type: string nullable: true company: $ref: '#/components/schemas/JobCompanyDto' description: type: string summary: type: string nullable: true listing_url: type: string apply_url: type: string locations: type: array items: $ref: '#/components/schemas/JobLocationDto' compensation: type: object allOf: - $ref: '#/components/schemas/JobCompensationDto' nullable: true description: | Compensation as published by the employer. USD annualization is used for salary filters but is not returned in this object. employment_type: type: string nullable: true enum: - Full-time - Part-time - Contract - Internship - Freelance - Temporary workplace_type: type: string nullable: true enum: - Remote - Hybrid - On-site experience_level: type: string nullable: true enum: - Intern - Entry Level - Mid Level - Senior - Lead - Executive source: type: string example: greenhouse description: | ATS provider identifier. This remains an open string so newly supported providers do not break generated clients. created_at: type: string format: date-time updated_at: type: string format: date-time date_posted: type: string format: date-time nullable: true valid_through: type: string format: date-time nullable: true qualifications: $ref: '#/components/schemas/JobQualificationsDto' responsibilities: type: array items: type: string benefits: type: array items: type: string is_work_auth_required: type: boolean nullable: true is_h1b_sponsor: type: boolean nullable: true is_clearance_required: type: boolean nullable: true JobFacetDto: type: object required: - key - count properties: key: type: string count: type: integer format: int64 AutoApplyApiVersion: type: string description: Version of the profileless Auto Apply API contract. enum: - '2026-07-21' example: '2026-07-21' JobCompanyDto: type: object required: - id - name - website - logo_url - summary - industries - categories - linkedin_url - crunchbase_url - details_url properties: id: type: string format: uuid name: type: string website: type: string nullable: true logo_url: type: string nullable: true summary: type: string nullable: true industries: type: array items: type: string description: Industry tags describing what the company does. categories: type: array items: type: string description: Business-model bucket tags (b2b / b2c / saas / service-provider). linkedin_url: type: string nullable: true crunchbase_url: type: string nullable: true details_url: type: string nullable: true description: > Direct Jobo API URL to the full company profile endpoint (`GET https://connect.jobo.world/api/companies/{id}`). RapidAPI consumers should rebuild `/api/companies/{id}` on their marketplace gateway instead of following this URL with a RapidAPI key. JobLocationDto: type: object required: - location - city - region - country - latitude - longitude properties: location: type: string nullable: true city: type: string nullable: true region: type: string nullable: true country: type: string nullable: true latitude: type: number format: double nullable: true longitude: type: number format: double nullable: true JobCompensationDto: type: object required: - min - max - currency - period properties: min: type: number format: decimal nullable: true max: type: number format: decimal nullable: true currency: type: string nullable: true period: type: string nullable: true enum: - hourly - daily - weekly - monthly - yearly - per-diem JobQualificationsDto: type: object required: - must_have - preferred properties: must_have: $ref: '#/components/schemas/QualificationBucketDto' preferred: $ref: '#/components/schemas/QualificationBucketDto' QualificationBucketDto: type: object required: - education - certifications - skills properties: education: type: array items: type: string certifications: type: array items: type: string skills: type: array items: $ref: '#/components/schemas/QualificationSkillDto' QualificationSkillDto: type: object required: - name - type properties: name: type: string type: type: string default: hard responses: Unauthorized: description: Missing or invalid API key content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: API key provided by Jobo ````