---
title: "Endpoint para consultar cancelaciones de nóminas electrónicas"
method: GET
path: "/payroll-cancellations"
tags: ["Nóminas electrónicas"]
---

# Endpoint para consultar cancelaciones de nóminas electrónicas

`GET /payroll-cancellations`

Este endpoint permite consultar todas las cancelaciones de nómina de una empresa

## Query parameters

- `limit` integer
- `from` string
- `idCompany` string
- `prefix` string
- `number` string
- `status` 'REGISTERED' | 'WAITING_RESPONSE' | 'FAILED' | 'SENT' | 'CANCELED' | 'REPLACED'
- `legalStatus` 'ACCEPTED' | 'ACCEPTED_WITH_OBSERVATIONS' | 'REJECTED'

## Response `200`

Objeto que representa la respuesta cuando se consultan las cancelaciones de nóminas electrónicas

- object
  - `metadata` Metadata
    - `from` string — Id del objeto a partir del cuál se inicia la consulta
    - `to` string — Id del último objeto consultado
    - `results_count` integer — Cantidad de resultados retornados en la respuesta
  - `payroll-cancellations` Emission[] — Array con cancelaciones de nómina — unresolved $ref

## 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)