RErecruitwithatlas
Companies

Get company by ID

Changed on

Returns full company details including location, identities, custom attributes, and owners (the Atlas users managing the company relationship).

Merged companies: Unlike Get a person, this endpoint does not follow merges. A company merged into another company is soft-deleted and its ID returns 404, the same as a deleted company. The company it was merged into keeps its own ID.

get/api/v1/companies/{id}

Request

Path parameters

idstring uuid required

Company ID

Example:550e8400-e29b-41d4-a716-446655440000

Response

Company found

status'ok' required

Example response

{
  "data": {
    "name": "Acme Corp",
    "websiteUrl": "https://acme.com",
    "linkedinUrl": "https://linkedin.com/company/acme",
    "relationship": "client",
    "industry": [
      "Technology"
    ],
    "employeeCount": 150,
    "ticker": "AAPL",
    "location": {
      "formattedAddress": "San Francisco, California, United States",
      "city": "San Francisco",
      "region": "California",
      "country": "United States",
      "metro": "San Francisco Bay Area",
      "raw": "London, England, United Kingdom",
      "latitude": 37.7749,
      "longitude": -122.4194
    },
    "identities": [
      {
        "type": "linkedin",
        "value": "linkedin.com/company/acme"
      }
    ],
    "owners": [
      {
        "name": "Jane Smith",
        "email": "jane@agency.com"
      }
    ]
  }
}

Changes

  • 158ee454751cRevision changes
    • warning

      added the new undefined enum value to the /// response property for the response status

    • warning

      added the new undefined enum value to the / response property for the response status

    • warning

      added the new undefined enum value to the / response property for the response status