Skip to main content

​
Search Companies by Keyword

GET /api/active/buscarEmpresasContains/{keyWord}
Searches for active companies by business name (razonSocial) containing the keyword.
​
keyWord
string
required
Search keyword
curl -X GET "https://api.investgo.com/api/active/buscarEmpresasContains/Tech" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
List Companies (Paginated)

GET /api/buscarEmpresas/{page}
Retrieves companies with pagination (6 per page).
​
page
integer
required
Page number (0-indexed)
curl -X GET "https://api.investgo.com/api/buscarEmpresas/0" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "content": [
    {
      "idEmpresa": 1,
      "representanteLegal": "Carlos Mendoza",
      "nomEmpresa": "Tech Solutions SAC",
      "ruc": "20123456789",
      "razonSocial": "Tech Solutions Sociedad Anónima Cerrada",
      "fechaDeInicioActv": "2020-01-15",
      "direccion": "Av. Principal 123, Lima",
      "telefono": "987654321",
      "correo": "[email protected]",
      "sector": "Tecnología",
      "fechRegistro": "2024-01-10",
      "enable": "Activo",
      "idRiesgo": 3
    }
  ],
  "totalPages": 3,
  "totalElements": 15,
  "pageNumber": 0,
  "pageSize": 6
}

​
List Active Companies

GET /api/active/listaEmpresas
Retrieves all active companies (excludes “No Activo” companies). 
curl -X GET "https://api.investgo.com/api/active/listaEmpresas" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
List All Companies

GET /api/listaEmpresas
Retrieves all companies in the system. 
curl -X GET "https://api.investgo.com/api/listaEmpresas" \
  -H "Authorization: Bearer YOUR_TOKEN"

[
  {
    "idEmpresa": 1,
    "representanteLegal": "Carlos Mendoza",
    "nomEmpresa": "Tech Solutions SAC",
    "ruc": "20123456789",
    "razonSocial": "Tech Solutions Sociedad Anónima Cerrada",
    "fechaDeInicioActv": "2020-01-15",
    "direccion": "Av. Principal 123, Lima",
    "telefono": "987654321",
    "correo": "[email protected]",
    "sector": "Tecnología",
    "fechRegistro": "2024-01-10",
    "enable": "Activo",
    "idRiesgo": 3
  }
]

​
Register Company

POST /api/registrarEmpresa
Creates a new company profile.
  • Email, RUC, and business name (razonSocial) must be unique
  • Registration date is automatically set to current date
  • Status is automatically set to “Activo”
  • Risk level (idRiesgo) is automatically set to 3 (medium risk)

​
Request Body

​
representanteLegal
string
required
Legal representative’s name
​
nomEmpresa
string
required
Company name
​
ruc
string
required
Company tax ID (RUC - must be unique)
​
razonSocial
string
required
Business legal name (must be unique)
​
fechaDeInicioActv
date
required
Business start date (format: yyyy-MM-dd)
​
direccion
string
required
Company address
​
telefono
string
required
Company phone number
​
correo
string
required
Company email (must be unique)
​
sector
string
required
Business sector/industry
curl -X POST "https://api.investgo.com/api/registrarEmpresa" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "representanteLegal": "Carlos Mendoza",
    "nomEmpresa": "Tech Solutions SAC",
    "ruc": "20123456789",
    "razonSocial": "Tech Solutions Sociedad Anónima Cerrada",
    "fechaDeInicioActv": "2020-01-15",
    "direccion": "Av. Principal 123, Lima",
    "telefono": "987654321",
    "correo": "[email protected]",
    "sector": "Tecnología"
  }'

{
  "mensaje": "Empresa registrada exitosamente",
  "empresa": {
    "idEmpresa": 1,
    "representanteLegal": "Carlos Mendoza",
    "nomEmpresa": "Tech Solutions SAC",
    "ruc": "20123456789",
    "razonSocial": "Tech Solutions Sociedad Anónima Cerrada",
    "fechaDeInicioActv": "2020-01-15",
    "direccion": "Av. Principal 123, Lima",
    "telefono": "987654321",
    "correo": "[email protected]",
    "sector": "Tecnología",
    "fechRegistro": "2024-03-15",
    "enable": "Activo",
    "idRiesgo": 3
  }
}

​
Update Company

PUT /api/actualizarEmpresa
Updates an existing company profile.
Email, RUC, and business name must remain unique. Registration date and status are preserved from the original record.

​
Request Body

​
idEmpresa
integer
required
Company ID to update
​
representanteLegal
string
Updated legal representative name
​
nomEmpresa
string
Updated company name
​
ruc
string
Updated RUC (must be unique)
​
razonSocial
string
Updated business legal name (must be unique)
​
fechaDeInicioActv
date
Updated business start date
​
direccion
string
Updated address
​
telefono
string
Updated phone
​
correo
string
Updated email (must be unique)
​
sector
string
Updated business sector
​
idRiesgo
integer
Updated risk level
curl -X PUT "https://api.investgo.com/api/actualizarEmpresa" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "idEmpresa": 1,
    "representanteLegal": "Carlos Mendoza García",
    "nomEmpresa": "Tech Solutions SAC",
    "ruc": "20123456789",
    "razonSocial": "Tech Solutions Sociedad Anónima Cerrada",
    "fechaDeInicioActv": "2020-01-15",
    "direccion": "Av. Principal 456, Lima",
    "telefono": "987654322",
    "correo": "[email protected]",
    "sector": "Tecnología",
    "idRiesgo": 2
  }'

{
  "mensaje": "Empresa actualizada exitosamente",
  "empresa": {
    "idEmpresa": 1,
    "representanteLegal": "Carlos Mendoza García",
    "direccion": "Av. Principal 456, Lima",
    "telefono": "987654322"
  }
}

​
Delete Company (Soft Delete)

DELETE /api/eliminarEmpresa/{id}
Soft deletes a company by setting status to “No Activo”.
This is a soft delete - the company is marked as inactive but not removed from the database.
​
id
integer
required
Company ID to delete
curl -X DELETE "https://api.investgo.com/api/eliminarEmpresa/1" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "mensaje": "Se elimino exitosamente la empresa"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us