Get Company by id

get/v1/companies/{company_id}

Fetches a single company by id with its relationships and included related resources. Read-only; no side effects. 404 when the company does not exist in the caller's workspace.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
company_id	string <uuid>	Yes	Public UUID of the company.e.g. b2c3d4e5-6f70-4812-93a4-b5c6d7e8f9a0

Headers

Name	Type	Required	Description
Accept	string	No	Standard content negotiation. JSON is always returned for these resources.e.g. application/json

Request

cURL

curl -X GET https://api.wellapp.ai/v1/companies/{company_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The company with its included related resources.

{
  "data": {
    "type": "companies",
    "id": "b2c3d4e5-6f70-4812-93a4-b5c6d7e8f9a0",
    "attributes": {
      "name": "Anthropic",
      "description": "Frontier AI lab, vendor for model inference.",
      "domain": "anthropic.com",
      "registered_name": "Anthropic, PBC",
      "trade_name": "Anthropic",
      "registered_value": "C3981221",
      "registry_name": "Delaware Division of Corporations",
      "registry_country": "US",
      "tax_id_value": "82-1990113",
      "tax_id_type": "EIN",
      "created_at": "2026-01-15T10:00:00.000Z",
      "updated_at": "2026-05-10T12:00:00.000Z"
    },
    "relationships": {
      "people": {
        "data": []
      },
      "emails": {
        "data": [
          {
            "type": "email",
            "id": "e6f7a8b9-0c1d-42e3-94f5-a6b7c8d9e0f1"
          }
        ]
      }
    }
  },
  "included": [
    {
      "type": "email",
      "id": "e6f7a8b9-0c1d-42e3-94f5-a6b7c8d9e0f1",
      "attributes": {
        "value": "remy@foldspace.ai",
        "created_at": "2026-01-12T09:31:05.000Z",
        "updated_at": null
      },
      "relationships": {
        "relations": {
          "data": [
            {
              "type": "company_relation",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "people": {
          "data": [
            {
              "type": "company_person",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "social_links": {
          "data": [
            {
              "type": "company_web_link",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "locations": {
          "data": [
            {
              "type": "company_location",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "emails": {
          "data": [
            {
              "type": "company_email",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "phones": {
          "data": [
            {
              "type": "company_phone",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "categories": {
          "data": [
            {
              "type": "company_category",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "media": {
          "data": [
            {
              "type": "company_media",
              "id": "00000000-0000-4000-8000-000000000001"
            }
          ]
        },
        "company_financial": {
          "data": {
            "type": "company_financial",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        }
      }
    }
  ]
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

403 — Forbidden

{
  "code": "FORBIDDEN",
  "status": 403,
  "title": "Forbidden",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not Found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}