Company groups
Authorization
apiKey api-key<token>
In: query
Query Parameters
page?integer
Page number to return (1-indexed). Defaults to 1.
Default
1Range
1 <= valuelimit?integer
Number of companies per page. Defaults to 50, maximum 200.
Default
50Range
1 <= value <= 200status?string
Filters by status.
Value in
"active" | "inactive"taxCode?string
Filters by exact tax code.
search?string
Case insensitive search over displayName, businessName and taxCode.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.getventia.com/api/v1.0/company-groups?page=1&limit=50"{
"data": [
{
"_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"
}
],
"pagination": {
"totalItems": 1,
"totalPages": 1,
"currentPage": 1
}
}{
"success": false,
"error": "Invalid query",
"details": "limit: Number must be less than or equal to 200"
}{
"success": false,
"error": "Invalid API Key"
}{
"success": false,
"error": "Internal server error"
}