Get Company Jobs

Display company-specific job listings on profile pages, highlight job opportunities from targeted companies, and track hiring trends by filtering jobs by category, employment type, and location type.

Endpoint

GET /v2/hirebase/companies/:company_slug/jobs

Path Parameters

company_slug

string

Unique identifier for the target company to search

Query Parameters

page

integer

Page number for pagination (default: 1)

limit

integer

Number of results per page (default: 10)

Response

jobs

array

An array of job objects associated with the company

Show child attributes

_id

string

Unique identifier for the job

company_name

string

Name of the company posting the job

job_title

string

Title or designation of the job

description

string

Full HTML-formatted job description, including responsibilities, requirements, and benefits

application_link

string

URL where users can apply for the job

location_raw

string

Free-text version of the job location (e.g., “Dallas, TX, US”)

job_categories

string[]

List of categories or tags associated with the job (e.g., “Engineering”, “Other”)

job_type

string

Type of job, such as “Full Time” or “Part Time”

location_type

string

Work setup for the job, such as “Remote”, “Hybrid”, or “In-Person”

yoe_range

object

Represents the required years of experience

Show child attributes

min

number

Minimum years of experience

max

number

Maximum years of experience

salary_range

object | null

Salary details for the job. Can be null if not provided

Show child attributes

min

number

Minimum salary offered

max

number

Maximum salary offered

currency

string

Currency code for the salary range(e.g., “USD”). May be omitted if salary data is not available

date_posted

string

Date the job was posted, in ISO format (YYYY-MM-DD)

company_link

string

Official website URL of the company

company_logo

string

URL to the company’s logo image

job_board

string | null

Name of the job board where this job is hosted (e.g., “iCIMS”)

job_board_link

string | null

URL to the job board listing page for this company

requirements_summary

string

Short plain-text summary of the core job requirements

visa_sponsored

boolean

Indicates whether the company sponsors visas for this job

company_data

object

Basic company information relevant to this job. May duplicate the top-level company object

Show child attributes

description_summary

string

Brief description of the company

linkedin_link

string

LinkedIn profile URL for the company

size_range

object

Company size in terms of number of employees

Show child attributes

min

number

Minimum number of employees

max

number

Maximum number of employees

industries

string[]

Primary industry categories the company operates in

subindustries

string[]

More specific categories within the industries

company_slug

string

URL-friendly identifier for the company

job_slug

string

URL-friendly identifier for the job

expired

boolean

Indicates whether the job posting has expired

locations

object[]

Structured location breakdown for the job

Show child attributes

city

string

City of the job

region

string

State, province, or region

country

string

Country name

job_categories

array

Array of job category objects representing classifications of jobs (e.g., “Engineering Jobs”, “Human Resources Jobs”)

Show child attributes

Example Request

curl -X GET "https://api.hirebase.org/v2/hirebase/companies/companyxyz/jobs?page=1&limit=10" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
    "jobs": [
        {
            "_id": "652e6f6e8b858c1c6ad2bv42",
            "company_name": "CompanyXYZ",
            "job_title": "Mid level GIS Professional",
            "description": "<p>CompanyXYZ is seeking a Mid-level GIS professional to work on projects in our Dallas TX Office. This is an excellent career opportunity for an experienced individual to join a team of professionals, while working in a multidisciplinary consulting and engineering firm.</p><h2>Requirements</h2><ul><li>Bachelor’s degree in geography or GIS degrees preferred</li><li>3 - 6 years of professional work experience in geography (preferably in FIRM production)</li><li>Knowledge of the National Flood Insurance Program (NFIP), FEMA Flood Insurance Studies, MT-2, and/or other flood study related programs and processes</li><li>Knowledge of FEMA Guidelines and Standards for Flood Risk Analysis and Mapping</li><li>Knowledge of FEMA's MIP tracking and reporting system a plus</li><li>Knowledge, interest, and project experience in GIS applications, including ArcGIS Desktop 10.x, ArcGIS Pro, and ArcGIS Online</li><li>Strong oral, people, and written communication skills</li><li>Strong MS Excel and MS Access skills to leverage various data sources for use in GIS projects</li><li>CFM (Certified Floodplain Manager) is a strong plus</li><li>Intermediate proficiency in python modeling/scripting and model builder for ArcGIS</li><li>Experience with GIS application and/or web development a plus</li><li>Intermediate experience with FEMA’s HAZUS application for multi-hazard risk analysis</li><li>Knowledge of Flood Mitigation and other Grant Programs a plus</li><li>Knowledge of Environmental Regulations a plus</li><li>Knowledge of Watershed Planning a plus</li></ul><h2>Benefits</h2><ul><li>Fantastic working environment</li><li>Opportunity to apply the latest technology to flood studies and water resource projects</li><li>Professional growth opportunity</li><li>Multidisciplinary consulting and engineering firm</li></ul>",
            "application_link": "https://careers-companyxyz.icims.com/jobs/14289/mid-level-gis-professional/job",
            "location_raw": "Dallas, TX, US",
            "job_categories": [
                "Other"
            ],
            "job_type": "Full Time",
            "location_type": "In-Person",
            "yoe_range": {
                "min": 3,
                "max": 6
            },
            "salary_range": null,
            "date_posted": "2025-03-07",
            "company_link": "https://www.companyxyz.com",
            "company_logo": "https://c-1720-20210302-www-companyxyz-com.i.icims.com/images/default-source/site-assets/logos/companyxyz-logo.png?sfvrsn=ba6fa825_0",
            "job_board": "iCIMS",
            "job_board_link": "https://careers-companyxyz.icims.com",
            "requirements_summary": "Bachelor’s degree in geography or GIS degrees preferred, 3 - 6 years of professional work experience in geography, knowledge of GIS applications and flood study related programs and processes",
            "visa_sponsored": false,
            "company_data": {
                "description_summary": "CompanyXYZ provides professional services, creating innovative solutions for built and natural environments nationwide.",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {
                    "min": 1001,
                    "max": 5000
                },
                "industries": [
                    "Design",
                    "Construction"
                ],
                "subindustries": [
                    "Architecture",
                    "Building Construction"
                ]
            },
            "company_slug": "companyxyz",
            "job_slug": "mid-level-gis-professional-8",
            "expired": false,
            "locations": [
                {
                    "city": "Dallas",
                    "region": "Texas",
                    "country": "United States"
                }
            ]
        },
        {
            "_id": "672e6f5f8b838d1c6ad2df62",
            "company_name": "CompanyXYZ",
            "job_title": "Senior Drainage Engineer",
            "description": "<p>CompanyXYZ is seeking a Senior Drainage Engineer with strong organizational and technical skills to support our growing Transportation design practice. This position will be based in our Orlando, FL office and offers career advancement opportunities, an excellent working environment, great work-life balance, and the chance to work on a variety of impactful projects.</p><h2>Requirements</h2><ul><li>Serve as Engineer-of-Record, Senior Engineer, or Project Manager on Transportation projects</li><li>Perform and collaborate on drainage analyses with other Drainage staff</li><li>Prepare drainage plans, reports, construction quantities, cost estimates and specifications for transportation projects</li></ul><h2>Benefits</h2><ul><li>Comprehensive medical, dental, vision, and supplemental life insurance programs</li><li>401(k) profit sharing plan with employer matching</li><li>529 college savings plans</li></ul>",
            "application_link": "https://careers-companyxyz.icims.com/jobs/14197/senior-drainage-engineer/job",
            "location_raw": "Orlando, FL, US",
            "job_categories": [
                "Other"
            ],
            "job_type": "Full Time",
            "location_type": "Hybrid",
            "yoe_range": {
                "min": 7,
                "max": 7
            },
            "salary_range": null,
            "date_posted": "2025-03-07",
            "company_link": "https://www.companyxyz.com",
            "company_logo": "https://c-1720-20210302-www-companyxyz-com.i.icims.com/images/default-source/site-assets/logos/companyxyz-logo.png?sfvrsn=ba6fa825_0",
            "job_board": "iCIMS",
            "job_board_link": "https://careers-companyxyz.icims.com",
            "requirements_summary": "Bachelor’s degree in Civil Engineering or a related discipline and 7+ years of relevant FDOT drainage/water resources design experience",
            "visa_sponsored": true,
            "company_data": {
                "description_summary": "CompanyXYZ provides professional services, creating innovative solutions for built and natural environments nationwide.",
                "linkedin_link": "https://www.linkedin.com/company/companyxyz",
                "size_range": {
                    "min": 1001,
                    "max": 5000
                },
                "industries": [
                    "Design",
                    "Construction"
                ],
                "subindustries": [
                    "Architecture",
                    "Building Construction"
                ]
            },
            "company_slug": "companyxyz",
            "job_slug": "senior-drainage-engineer-19",
            "expired": false,
            "locations": [
                {
                    "city": "Orlando",
                    "region": "Florida",
                    "country": "United States"
                }
            ]
        }
    ],
    "job_categories": [
        {
            "category": "Other"
        },
    ],
    "total_count": 161,
    "page": 1,
    "limit": 2,
    "total_pages": 81
}

Error Responses

401 Unauthorized

Returns when the API key is missing, invalid, or incorrect.

404 Not Found

Returns when the specified company_slugdoes not exist in the database.

The company does not exist or has been deleted.
There’s a typo in the company_slugvalue.
The slug is incorrectly cased (e.g., uppercase vs lowercase letters).

500 Internal Server Error

Returns when an unexpected error occurs on the server.

Occurs during unhandled server-side failures or bugs that prevent the request from being processed.

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

Endpoint

Path Parameters

Query Parameters

Response

Example Request

Example Response

Error Responses

Jobs API

Companies API

Resume (Embeddings) API

Tasks API

Error Handling

​Endpoint

​Path Parameters

​Query Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Query Parameters

Response

Example Request

Example Response

Error Responses