---
title: "Endpoint para consultar el listado de empresas"
method: GET
path: "/companies"
tags: ["Empresas"]
---

# Endpoint para consultar el listado de empresas

`GET /companies`

## Request

- Base URL: `https://sandbox-api.alegra.com/e-provider/col/v1`
- URL: `https://sandbox-api.alegra.com/e-provider/col/v1/companies`
- Auth: HTTP bearer

Retorna el listado de empresas asociadas al token

## Query parameters

- `limit` integer
- `from` string
- `identification` string

## Response `200`

Objeto que representa la respuesta cuando se consultan el listado de empresas

- object
  - `metadata` object
    - `from` string: Id de la empresa desde la cual se inició la consulta
    - `to` string: Id de la última empresa en la página actual. Usar como valor de 'from' para obtener la siguiente página
    - `results_count` number: Cantidad de empresas en la página actual
  - `companies` object[]: Array con empresas
    - `name` string, required: Nombre/Razón Social de la empresa
    - `tradeName` string: Nombre Comercial de la empresa
    - `identification` string, required: Identificación de la empresa
    - `dv` string, required: Dígito verificador de la identificación de la empresa
    - `useAlegraCertificate` boolean, required: True si deseas usar el certificado de Alegra
    - `governmentStatus` object: Objeto que contiene la información de los estados de la compañía ante la DIAN para cada uno de los documentos electrónicos
      - `payrolls` 'AUTHORIZED' | 'UNAUTHORIZED' | 'IN_PROCESS': Indica el estado de la compañía ante la DIAN para nómina electrónica
      - `invoices` 'AUTHORIZED' | 'UNAUTHORIZED' | 'IN_PROCESS': Indica el estado de la compañía ante la DIAN para factura electrónica
    - `certificate` object: Objeto que contiene la información del certificado, obligatorio únicamente si el atributo useAlegraCertificate es false
      - `name` string, required: Nombre del archivo
      - `extension` string, required: Extensión del archivo
      - `content` string, byte, required: Archivo de certificado en base 64
      - `password` string, required: Contraseña del certificado
    - `notificationByEmail` object
      - `enabled` boolean, required: Indica si se quiere enviar un email de notificación automáticamente después de que la empresa genere un documento electrónico valido. Valido para Factura Electrónica, Nota Débito y Nota Crédito. Por defecto es false
      - `message` string: Mensaje (opcional) que será añadido al final de la plantilla del correo
    - `webhooks` object: Objeto que contiene la información de los webhooks configurados para la empresa
      - `general` object: Objeto con información de webhooks generales
        - `governmentStatusChanged` object, required: Objeto con la información para el webhook que se dispara cuando cambia el estado de la compañía ante la DIAN
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `payrolls` object: Objeto con información de webhooks para nóminas electrónicas
        - `emissionFinished` object, required: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de una nómina electrónica
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `invoices` object: Objeto con información de webhooks para facturas electrónicas
        - `emissionFinished` object, required: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de una factura electrónica
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `creditNotes` object: Objeto con información de webhooks para notas crédito electrónicas
        - `emissionFinished` object, required: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de una nota crédito electrónica
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `debitNotes` object: Objeto con información de webhooks para notas débito electrónicas
        - `emissionFinished` object, required: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de una nota débito electrónica
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `equivalentDocuments` object: Objeto con webhooks de documentos equivalentes electrónicos
        - `emissionFinished` object: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de un documento equivalente electrónico
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
      - `supportDocuments` object: Objeto con webhooks de documentos soporte electrónicos
        - `emissionFinished` object: Objeto con la información para el webhook que se dispara cuando finaliza el proceso de emisión de un documento soporte electrónico
          - `url` string, uri, required: Url a la cual notificará el webhook. Debe ser http o https y apuntar a un host público
          - `headers` object: Objeto con headers personalizados que serán enviados en el request al webhook configurado
          - `status` 'active' | 'inactive'
    - `organizationType` number: Identificador de tipo de organización jurídica de la persona o empresa. Se debe colocar el Código que corresponda de la tabla de tipos de organización jurídica de la DIAN. <br><i>Campo oficial DIAN &lt;AdditionalAccountID&gt;</i>
    - `identificationType` string: Tipo de documento de identificación de la empresa. Se debe colocar el Código que corresponda de la tabla de tipos de identificación de la DIAN
    - `regimeCode` string: Régimen al que pertenece la empresa. Se debe colocar el Código que corresponda de la tabla de tipos de régimen/responsabilidades fiscales de la DIAN. Para reportar varias obligaciones / responsabilidades, se deben reportar separando cada uno de los valores de la lista con ';'. Ejemplo O‐13;O‐15;
    - `taxCode` object: Objeto que contiene el grupo de detalles tributarios del Emisor
      - `id` string, required: Identificador del tributo.
      - `name` string: Nombre del tributo o nombre de la figura tributaria. Se debe enviar en caso de que el identificador del tributo sea 'ZZ'
    - `email` string: Correo electrónico de la empresa. Se debe colocar el correo de recepción para documentos e instrumentos electrónicos
    - `phone` string: Número de teléfono, celular u otro
    - `address` AddressDataFE: Objeto que contiene la información relacionada a la dirección. <br><i>Grupo de información oficial DIAN &lt;RegistrationAddress | PhysicalLocation&gt;</i>
      - `address` string: Dirección del lugar fisico. <br><i>Campo oficial DIAN &lt;Line&gt;</i>
      - `city` string: Código de la Ciudad. Se debe colocar el Código que corresponda de la tabla de municipios disponibles de la DIAN. Se debe informar cuando el código del País es 'CO'. <br><i>Campo oficial DIAN &lt;ID&gt;</i>
      - `department` string: Código del Departamento. Se debe colocar el Código que corresponda de la tabla de departamentos disponibles de la DIAN. Se debe informar cuando el código del País es 'CO'. <br><i>Campo oficial DIAN &lt;CountrySubentityCode&gt;</i>
      - `country` string: Código identificador del País. Se debe colocar el código que corresponda de la tabla de países disponibles de la DIAN. Por defecto 'CO'. <br><i>Campo oficial DIAN &lt;IdentificationCode&gt;</i>

## Other responses

- `400`: Objeto que representa una respuesta de error por validaciones
- `404`: Objeto que representa una respuesta de error por qué no se ha encontrado el recurso al que se intenta acceder
- `500`: Objeto que representa una respuesta de error por qué ha ocurrido un error interno en el sistema

---

[API](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) - [All operations](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/api-alegra-proveedor-electr-nico-colombia/revisions/2bc52ab55c2b?raw)