Skip to main content
GET
https://api.hirebase.org
/
v2
/
hirebase
/
companies
/
:company_slug
Get Company
curl --request GET \
  --url https://api.hirebase.org/v2/hirebase/companies/:company_slug \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_slug": "<string>"
}
'
{
  "company": {
    "company_slug": "<string>",
    "company_name": "<string>",
    "company_logo": "<string>",
    "job_board": {},
    "linkedin_link": "<string>",
    "company_link": "<string>",
    "description_summary": "<string>",
    "size_range": {
      "min": 123,
      "max": 123
    },
    "industries": [
      "<string>"
    ],
    "subindustries": [
      "<string>"
    ]
  },
  "jobs": [
    {
      "_id": "<string>",
      "company_name": "<string>",
      "job_title": "<string>",
      "description": "<string>",
      "application_link": "<string>",
      "location_raw": "<string>",
      "job_categories": [
        "<string>"
      ],
      "job_type": "<string>",
      "location_type": "<string>",
      "yoe_range": {
        "min": 123,
        "max": 123
      },
      "salary_range": {
        "min": 123,
        "max": 123
      },
      "date_posted": "<string>",
      "job_board": {},
      "job_board_link": {},
      "requirements_summary": "<string>",
      "visa_sponsored": true,
      "company_data": {
        "description_summary": "<string>",
        "linkedin_link": "<string>",
        "size_range": {
          "min": 123,
          "max": 123
        },
        "industries": [
          "<string>"
        ],
        "subindustries": [
          "<string>"
        ]
      },
      "company_slug": "<string>",
      "job_slug": "<string>",
      "expired": true,
      "locations": [
        {
          "city": "<string>",
          "region": "<string>",
          "country": "<string>"
        }
      ]
    }
  ]
}
Get complete company details by providing the company_slug. This information, such as a detailed profile and, if available, an example job. Using this endpoint, you can display information of an individual company in detail alongwith the job previews associated with that company.

​
Endpoint

GET /v2/hirebase/companies/:company_slug

​
Path Parameters

​
company_slug
string
Unique identifier for the target company

​
Response

​
company
object
Details of the company.
​
jobs
array
List of active jobs for the company

​
Example Request

curl -X GET "https://api.hirebase.org/v2/hirebase/companies/companyxyz" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

{
  "company": {
    "company_slug": "companyxyz",
    "company_name": "CompanyXYZ",
    "company_logo": "https://recruiting.cdn.greenhouse.io/external_greenhouse_job_boards/logos/000/000/114/resized/CompanyXYZ_logo_badge-circle_RGB.png?1613807682",
    "job_board": null,
    "linkedin_link": "https://www.linkedin.com/company/companyxyz-com",
    "company_link": "about.companyxyz.com",
    "description_summary": "CompanyXYZ is a social platform connecting neighbors for community support and local engagement.",
    "size_range": null,
    "industries": ["Tech, Software & IT Services"],
    "subindustries": ["Internet of Things (IoT)", "Digital Media & Entertainment"]
  },
"jobs": [
        {
            "_id": "66ccecd72a2001139e9ecf62",
            "company_name": "CompanyXYZ",
            "job_title": "Didn't See What You Are Looking For?",
            "description": "<p>CompanyXYZ is a platform where neighbors connect to build real-world connections. As a Software Engineer, you'll join a team passionate about using technology to cultivate a kinder world.</p><h2>Requirements</h2><ul><li>Ability to learn from coworkers and teach them</li><li>Experience working in multiple languages and services</li><li>Strong focus on quality and reliability</li></ul>",
            "application_link": "https://about.companyxyz.com/careers-list/?gh_jid=2387416",
            "location_raw": "San Francisco, CA",
            "job_categories": [
                "Software Engineer Jobs"
            ],
            "job_type": "Full Time",
            "location_type": "In-Person",
            "yoe_range": null,
            "salary_range": null,
            "date_posted": "2024-07-08",
            "company_link": "about.companyxyz.com",
            "company_logo": "https://recruiting.cdn.greenhouse.io/external_greenhouse_job_boards/logos/000/100/123/resized/CompanyXYZ_logo_badge-circle_RGB.png?1613798682",
            "job_board": "Greenhouse",
            "job_board_link": "https://job-boards.greenhouse.io/companyxyz",
            "requirements_summary": "Ability to learn, experience in multiple languages, strong focus on quality",
            "visa_sponsored": false,
            "company_data": null,
            "company_slug": "companyxyz",
            "job_slug": "didn-t-see-what-you-are-looking-for",
            "expired": false,
            "locations": [
                {
                    "city": "San Francisco",
                    "region": "California",
                    "country": "United States"
                }
            ]
        }
    ]
}

​
Error Responses

Returns when the API key is missing, invalid, or incorrect.
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).
Returns when an unexpected error occurs on the server.
  • Occurs during unhandled server-side failures or bugs that prevent the request from being processed.