--- title: "Endpoint para consultar el listado de empresas" method: GET path: "/companies" tags: ["Empresas"] --- # Endpoint para consultar el listado de empresas `GET /companies` 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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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, required — Url a la cual notificará el webhook - `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.
Campo oficial DIAN <AdditionalAccountID> - `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.
Grupo de información oficial DIAN <RegistrationAddress | PhysicalLocation> - `address` string — Dirección del lugar fisico.
Campo oficial DIAN <Line> - `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'.
Campo oficial DIAN <ID> - `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'.
Campo oficial DIAN <CountrySubentityCode> - `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'.
Campo oficial DIAN <IdentificationCode> ## 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.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia.md) · [All operations](https://skmtc.net/alegra/apis/api-alegra-proveedor-electr-nico-colombia/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/api-alegra-proveedor-electr-nico-colombia/revisions/5fcb0d90e251/schema)