GET/catalogos/descartados/:tkDescartado
Permite obtener el detalle de una razón, que describe en qué situaciones podría ocurrir una descartación.
Parámetros
| Nombre | Tipo | Validación | Descripción |
|---|
tkDescartado | varchar | | El código token que corresponde a una posible causa de descartación. |
tipo | int | | Dato utilizado por la operación del endpoint. |
pagina | int | | Número de página que se consulta. |
cantidadRegistros | int | | Cantidad máxima de registros que se devuelve por página. |
Respuesta
| Nombre | Tipo | Descripción |
|---|
indice | Integer | Define la posición de un registro, con respecto a los demás registros. |
razonPerdida | String | Almacena un comentario que indica la razón de la pérdida de la oportunidad. |
tipo | String | Contiene el tipo de cliente al que puede asociarse la razón de la pérdida. |
ultimaModificacion | Date | Almacena un formato compuesto de fecha y hora que indica la fecha que se realizó el descarte. |
tkDescartado | UUID | Código token que corresponde a una razón de posible causa de descartación. |
Solicitud
curl --request GET \
--url 'https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50' \
--header 'token: 00000000-0000-4000-8000-000000000001'const response = await fetch("https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50", {
method: "GET",
headers: { token: "00000000-0000-4000-8000-000000000001" }
});
const resultado = await response.json();
console.log(resultado);const response = await fetch("https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50", { method: "GET", headers: { token: "00000000-0000-4000-8000-000000000001" } });
console.log(await response.json());import requests
response = requests.request("GET", "https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50", headers={"token": "00000000-0000-4000-8000-000000000001"})
response.raise_for_status()
print(response.json())package main
import (
"net/http"
)
func main() {
request, _ := http.NewRequest(http.MethodGet, "https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50", nil)
request.Header.Set("token", "00000000-0000-4000-8000-000000000001")
response, _ := http.DefaultClient.Do(request)
defer response.Body.Close()
}using System.Net.Http;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.upnify.com/v4/catalogos/descartados/00000000-0000-4000-8000-000000000010?tipo=-1&pagina=1&cantidadRegistros=50");
request.Headers.Add("token", "00000000-0000-4000-8000-000000000001");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Respuesta
[
{
"indice": 0,
"razonPerdida": "valor-razonPerdida",
"tipo": "valor-tipo",
"ultimaModificacion": "2026-01-01T00:00:00.000Z",
"tkDescartado": "00000000-0000-4000-8000-000000000010"
}
]