Ventia
Company groups

Get a company

Returns a single company (company group) of your account.

GET
/company-groups/{id}

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key sent as Authorization: Bearer <API_KEY>.

Path Parameters

id*string

Unique identifier of the company.

Response Body

OK

application/json
curl -X GET 'https://api.getventia.com/api/v1.0/company-groups/67bca48d5fc32659c854f83c'
{  "_id": "67bca48d5fc32659c854f83c",  "displayName": "Ventia",  "businessName": "Ventia S.A.",  "description": "CRM provider",  "origin": "API Pública",  "taxCode": "218765430017",  "direction": {    "location": true,    "route": "Av. Italia",    "street_number": "6201",    "locality": "Montevideo",    "country": "Uruguay",    "formatted_address": "Av. Italia 6201, Montevideo, Uruguay",    "place_id": "ChIJXXXXXXXXXXXXXXXXXXXX",    "geoLocation": {      "type": "Point",      "coordinates": [        -56.1645,        -34.8836      ]    }  },  "sectors": false,  "status": "active",  "additionalData": {    "industry": "Software",    "employees": 120  },  "company": "5f2b1c8e9f1b4a0017a1b2c3",  "createdBy": "61a5f9d6c4e2b30017c9d123",  "createdAt": "2026-02-24T18:21:01.000Z",  "updatedAt": "2026-02-24T18:21:01.000Z"}

Create a company POST

Creates a new company (company group). `additionalData` is validated against the additional company fields configured on your company.

Update a company PATCH

Updates a company (company group). Only the sent fields are modified. Keys sent inside `additionalData` are merged with the stored ones, so the additional fields that are not sent keep their value.