> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta general

El servicio permite a los usuarios consultar el listado de solicitudes de PQR (peticiones, quejas, reclamos y sugerencias) radicadas por el cliente, en línea en formato JSON.

El método de solicitud es POST y se requiere un encabezado "Authorization" para la autenticación, que debe contener el **AccessToken** (JWT) obtenido previamente del servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

Antes de realizar la consulta de solicitudes, se debe contar con los siguientes datos:

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)
* Identificador único del cliente (`UniqueID`) obtenido del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)

## Consultar solicitudes

**Request URL:** [https://portal.sedierp.com/API/api/SolicitudesPQRs/SolicitudesConsultar](https://portal.sedierp.com/API/api/SolicitudesPQRs/SolicitudesConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**UniqueID** `GUID` *required*

Identificador único del cliente que radicó las solicitudes (`UniqueID` del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)). Si no se envía, la consulta no retorna registros.

**Page** `int`

Página de consulta, por defecto (1).

**Rows** `int`

Cantidad de registros por página de consulta, por defecto (10). Si se envía 0, se retornan todos los registros.

**SolicitudID** `int`

Filtro de búsqueda por código único de la solicitud (ID).

**Consecutivo** `int`

Filtro de búsqueda por consecutivo de la solicitud.

**CodigoUnico** `GUID`

Filtro de búsqueda por código único de radicación de la solicitud.

**EstadoSolicitudID** `int`

Filtro de búsqueda por código del estado de la solicitud (ID).

**ResponsableUsuarioID** `int`

Filtro de búsqueda por código del usuario responsable de la solicitud (ID).

**RadicadorUsuarioID** `int`

Filtro de búsqueda por código del usuario que radicó la solicitud (ID).

**FechaInicial** `date`

Filtro de búsqueda por fecha de creación de la solicitud, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

**FechaFinal** `date`

Filtro de búsqueda por fecha de creación de la solicitud, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora.

**NombreCompleto** `string`

Filtro de búsqueda por cualquier parte del nombre de la persona que radicó la solicitud.

**NumeroDocumento** `string`

Filtro de búsqueda por cualquier parte del número de documento de la persona que radicó la solicitud.

**TelefonoMovil** `string`

Filtro de búsqueda por cualquier parte del teléfono móvil de la persona que radicó la solicitud.

**SortColumn** `string`

Columna por la cual se ordenan los registros, con el prefijo `S.` (ej. `S.Consecutivo`, `S.FechaCreacion`). Por defecto se ordena por fecha de creación de forma descendente.

**SortDirection** `string`

Dirección del ordenamiento: `ASC` o `DESC`, por defecto `ASC`. Solo aplica cuando se envía `SortColumn`.

**FullSearch** `string`

Campo de consulta múltiple. El criterio de búsqueda depende del valor enviado:

* **Numérico:** consulta por el consecutivo de la solicitud o por el número de documento exacto de quien la radicó.
* **Fecha:** consulta por la fecha de creación de la solicitud.
* **Otro texto:** consulta por cualquier parte del mensaje o de la respuesta de la solicitud.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/SolicitudesPQRs/SolicitudesConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"UniqueID": "c4d81e27-90ab-4f3e-b6a2-71d5e09f8c34",
	"Page": 1,
	"Rows": 10,
	"SolicitudID": null,
	"Consecutivo": null,
	"CodigoUnico": null,
	"EstadoSolicitudID": null,
	"ResponsableUsuarioID": null,
	"RadicadorUsuarioID": null,
	"FechaInicial": "2026-10-01",
	"FechaFinal": "2026-11-04",
	"NombreCompleto": null,
	"NumeroDocumento": null,
	"TelefonoMovil": null,
	"SortColumn": null,
	"SortDirection": null,
	"FullSearch": null
}'
```

### Respuesta

El servicio retorna el listado de solicitudes del cliente, por defecto ordenado por fecha de creación de forma descendente. Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 (`{"Code": 401, "Message": "El TokenAcceso no es valido"}`).

Cada registro de `rows` contiene los siguientes campos:

**SolicitudID** `int`

Código único de la solicitud (ID).

**Consecutivo** `int`

Consecutivo de radicación de la solicitud.

**ReplicaSolicitudID** `int`

Código de la solicitud anterior de la cual es réplica (ID), cuando aplica.

**Asunto** `string`

Asunto de la solicitud.

**TipoRequerimientoNombre** `string`

Nombre del tipo de requerimiento.

**TipificacionNombre** `string`

Nombre de la tipificación de la solicitud.

**NombreCompleto** `string`

Nombre completo de la persona que radicó la solicitud.

**EstadoSolicitudID** `int`

Código del estado de la solicitud (ID).

**EstadoSolicitudNombre** `string`

Nombre del estado de la solicitud.

**EstadoSolicitudCierre** `bool`

Indica si el estado de la solicitud es un estado de cierre.

**FechaCreacion** `datetime`

Fecha y hora de radicación de la solicitud.

**FechaAcuerdoServicio** `datetime`

Fecha y hora límite de respuesta según el acuerdo de servicio.

**FechaCierre** `datetime`

Fecha y hora de cierre de la solicitud, cuando está cerrada.

**ColorVencimiento** `string`

Semáforo de vencimiento según el tiempo transcurrido frente al acuerdo de servicio.

| Valor | Significado |
| - | - |
| green | Ha transcurrido menos del 80% del tiempo de respuesta |
| orange | Ha transcurrido entre el 81% y el 99% del tiempo de respuesta |
| red | Se cumplió o se superó el tiempo de respuesta |

**TotalRows** `int`

Cantidad total de registros que cumplen con los filtros de la consulta.

```json Request theme={null}
{
  "UniqueID": "c4d81e27-90ab-4f3e-b6a2-71d5e09f8c34",
  "Page": 1,
  "Rows": 10,
  "SolicitudID": null,
  "Consecutivo": null,
  "CodigoUnico": null,
  "EstadoSolicitudID": null,
  "ResponsableUsuarioID": null,
  "RadicadorUsuarioID": null,
  "FechaInicial": "2026-10-01",
  "FechaFinal": "2026-11-04",
  "NombreCompleto": null,
  "NumeroDocumento": null,
  "TelefonoMovil": null,
  "SortColumn": null,
  "SortDirection": null,
  "FullSearch": null
}
```

```json Exitosa theme={null}
{
    "total": 2,
    "rows": [
        {
            "SolicitudID": 1542,
            "Consecutivo": 126,
            "ReplicaSolicitudID": null,
            "Asunto": "Filtración en el baño principal",
            "TipoRequerimientoNombre": "Reclamo",
            "NombreCompleto": "LAURA MARTINEZ ROJAS",
            "EstadoSolicitudID": 1,
            "FechaCreacion": "2026-11-03T10:15:22",
            "FechaAcuerdoServicio": "2026-11-06T10:15:22",
            "FechaCierre": null,
            "EstadoSolicitudNombre": "Radicada",
            "TipificacionNombre": "Daños locativos",
            "ColorVencimiento": "green",
            "EstadoSolicitudCierre": false,
            "TotalRows": 2
        },
        {
            "SolicitudID": 1488,
            "Consecutivo": 109,
            "ReplicaSolicitudID": null,
            "Asunto": "Solicitud de paz y salvo",
            "TipoRequerimientoNombre": "Petición",
            "NombreCompleto": "LAURA MARTINEZ ROJAS",
            "EstadoSolicitudID": 4,
            "FechaCreacion": "2026-10-14T16:40:05",
            "FechaAcuerdoServicio": "2026-10-21T16:40:05",
            "FechaCierre": "2026-10-16T09:12:47",
            "EstadoSolicitudNombre": "Cerrada",
            "TipificacionNombre": "Certificados y paz y salvos",
            "ColorVencimiento": "green",
            "EstadoSolicitudCierre": true,
            "TotalRows": 2
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "Conversion failed when converting the varchar value 'PA123456' to data type int., "
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.