Gradient

Get Company Details

Retrieve detailed information about a specific company including basic profile and active job count.

Endpoint

GET/api/v1/companies/:id

Parameters

idRequiredstring

Unique 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.

Try it out

Parameters