Get Company Details
Retrieve detailed information about a specific company including basic profile and active job count.
Endpoint
GET
/api/v1/companies/:idParameters
idRequiredstringUnique company identifier
Responses
200Successful response with company details
{
"data": {
"id": "64a1b2c3d4e5f678901234a",
"name": "Tech Innovators Inc",
"slug": "tech-innovators-inc",
"logo": "https://example.com/logo.png",
"description": "Leading technology company specializing in AI and machine learning solutions. We build cutting-edge products that transform how businesses operate.",
"status": true,
"active_jobs_count": 12,
"recent_jobs": [
{
"id": "64a1b2c3d4e5f6789012345",
"title": "Senior Frontend Developer",
"location": "New York, NY",
"posted_at": "2025-07-25"
},
{
"id": "64a1b2c3d4e5f6789012346",
"title": "Machine Learning Engineer",
"location": "San Francisco, CA",
"posted_at": "2025-07-20"
}
],
"created_at": "2025-01-15T10:00:00Z"
},
"meta": {
"api_version": "v1",
"timestamp": "2025-08-01T12:00:00Z"
}
}401Unauthorized - invalid or missing API key
404Company not found
{
"error": {
"code": "COMPANY_NOT_FOUND",
"message": "The requested company does not exist"
}
}Code Examples
curl -X GET https://essence-api.gradientgroup.com/api/v1/companies/:id \
-H "Authorization: Bearer YOUR_API_KEY"API Configuration
Your API key is stored locally and used for testing.
