API Casos

1. Introducción

La API Pública de Consulta de Casos Judiciales es un servicio web que permite a usuarios y aplicaciones consultar información sobre los trámites de los casos judiciales de la República Dominicana.

¿Qué información puedo consultar?

• Número Único de Caso (NUC): Identificador único del caso
• Número de trámite y solicitud: Referencias del proceso
• Asunto del caso: Descripción del tema judicial
• Materia legal: Tipo de materia (Civil, Penal, Laboral, etc.)
• Tribunal y sala asignados: Información de la jurisdicción
• Fecha del trámite: Registro temporal
• Estado actual: Situación del proceso
• Resultado de audiencias: Si aplica al caso

2. Requisitos Previos

Para utilizar esta API, necesitará:

Requisitos Técnicos

1. Conexión a Internet: Para realizar las peticiones HTTP
2. Cliente HTTP: Puede usar:
   • Navegador web (para pruebas simples)
   • Herramientas como Postman, Insomnia o cURL
   • Código en cualquier lenguaje de programación (JavaScript, Python, C#, etc.)
3. Datos de consulta: NUC o Número de Solicitud válido

3. URL Base de la API

Ejemplo de URL completa

https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorNuc?Nuc=123-2024-00456

4. Autenticación

5. Límites de Uso

Para garantizar la disponibilidad del servicio, se aplican las siguientes restricciones:

Límite de Peticiones (Rate Limiting)

¿Qué sucede si excedo el límite?

Si realiza más de 100 peticiones en un minuto, recibirá la siguiente respuesta:

{
  "error": "Peticiones excedidas",
  "message": "Ha excedido la cantidad de peticiones. Intente de nuevo en 1 minuto."
}

6. Endpoints Disponibles

6.1 Consulta por Número Único de Caso (NUC)

Este endpoint permite obtener todos los trámites asociados a un Número Único de Caso.

{
  "message": "Resultados para el caso: 123-2024-00456",
  "data": [
    {
      "nuc": "123-2024-00456",
      "numeroTramite": "TR-001",
      "numeroSolicitud": "SOL-2024-001",
      "asunto": "Demanda Civil",
      "materia": "Civil",
      "tribunal": "Tribunal Superior de Justicia",
      "sala": "Sala Civil 1",
      "fecha": "2024-01-15",
      "estado": "En proceso",
      "referencia": "REF-123",
      "resultadoAudiencia": null
    }
  ]
}

{
  "message": "No se encontraron resultados para el caso: 123-2024-00456",
  "data": []
}

{
  "message": "Debe verificar el 'Nuc' suministrado."
}

6.2 Consulta por Número de Solicitud

Este endpoint permite obtener un trámite específico mediante su número de solicitud.

{
  "message": "Resultados para la solicitud: SOL-2024-001",
  "data": {
    "nuc": "123-2024-00456",
    "numeroTramite": "TR-001",
    "numeroSolicitud": "SOL-2024-001",
    "asunto": "Demanda Civil",
    "materia": "Civil",
    "tribunal": "Tribunal Superior de Justicia",
    "sala": "Sala Civil 1",
    "fecha": "2024-01-15",
    "estado": "En proceso",
    "referencia": "REF-123",
    "resultadoAudiencia": null
  }
}

{
  "message": "No se encontraron resultados con el número suministrado: SOL-2024-001",
  "data": {}
}

{
  "message": "Debe verificar el Número de Solicitud suministrado."
}

7. Estructura de Respuestas

Estructura General

Todas las respuestas de la API siguen esta estructura:

{
  "message": "Descripción del resultado",
  "data": {objeto o array de datos}
}

Campos del Objeto de Trámite

8. Códigos de Estado HTTP

La API utiliza los siguientes códigos de estado HTTP estándar:

9. Ejemplos de Uso

Ejemplo 1: Consulta con cURL

Consulta por NUC

curl -X GET "https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorNuc?Nuc=2024-0087812"

Consulta por Número de Solicitud

curl -X GET "https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorSolicitud?NroSolicitud=2024-R0434917"

Ejemplo 2: Consulta con JavaScript (Fetch API)

// Consulta por NUC
async function consultarPorNuc(nuc) {
  try {
    const response = await fetch(
      `https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorNuc?Nuc=${nuc}`
    );

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log('Resultados:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

// Consulta por Número de Solicitud
async function consultarPorSolicitud(numeroSolicitud) {
  try {
    const response = await fetch(
      `https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorSolicitud?NroSolicitud=${numeroSolicitud}`
    );

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log('Resultados:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

// Uso
consultarPorNuc('123-2024-00456');
consultarPorSolicitud('SOL-2024-001');

Ejemplo 3: Consulta con Python (Requests)

import requests

def consultar_por_nuc(nuc):
    url = f"https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorNuc"
    params = {"Nuc": nuc}

    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        data = response.json()
        print("Resultados:", data)
        return data
    except requests.exceptions.RequestException as e:
        print(f"Error: {e}")
        return None

def consultar_por_solicitud(numero_solicitud):
    url = f"https://api.poderjudicial.gob.do/Casos/Tramite/ObtenerDatosPorSolicitud"
    params = {"NroSolicitud": numero_solicitud}

    try:
        response = requests.get(url, params=params)
        response.raise_for_status()
        data = response.json()
        print("Resultados:", data)
        return data
    except requests.exceptions.RequestException as e:
        print(f"Error: {e}")
        return None

# Uso
consultar_por_nuc("123-2024-00456")
consultar_por_solicitud("SOL-2024-001")

Ejemplo 4: Consulta con C# (.NET)

    using System;
    using System.Net.Http;
    using System.Threading.Tasks;
    using Newtonsoft.Json;

    public class ApiCliente
    {
    private static readonly HttpClient client = new HttpClient();
    private const string UrlBase = "https://api.poderjudicial.gob.do/Casos";

    public static async Task ConsultarPorNuc(string nuc)
    {
    try
    {
    string url = $"{UrlBase}/Tramite/ObtenerDatosPorNuc?Nuc={nuc}";
    HttpResponseMessage response = await client.GetAsync(url);
    response.EnsureSuccessStatusCode();

    string responseBody = await response.Content.ReadAsStringAsync();
    dynamic data = JsonConvert.DeserializeObject(responseBody);

    Console.WriteLine("Resultados:");
    Console.WriteLine(JsonConvert.SerializeObject(data, Formatting.Indented));
    }
    catch (HttpRequestException e)
    {
    Console.WriteLine($"Error: {e.Message}");
    }
    }

    public static async Task ConsultarPorSolicitud(string numeroSolicitud)
    {
    try
    {
    string url = $"{UrlBase}/Tramite/ObtenerDatosPorSolicitud?NroSolicitud={numeroSolicitud}";
    HttpResponseMessage response = await client.GetAsync(url);
    response.EnsureSuccessStatusCode();

    string responseBody = await response.Content.ReadAsStringAsync();
    dynamic data = JsonConvert.DeserializeObject(responseBody);

    Console.WriteLine("Resultados:");
    Console.WriteLine(JsonConvert.SerializeObject(data, Formatting.Indented));
    }
    catch (HttpRequestException e)
    {
    Console.WriteLine($"Error: {e.Message}");
    }
    }
    }

    // Uso
    await ApiCliente.ConsultarPorNuc("2024-0087812");
    await ApiCliente.ConsultarPorSolicitud("2024-R0434917");

10. Manejo de Errores

Error 400 - Bad Request

{
  "message": "Debe verificar el 'Nuc' suministrado."
}

Error 404 - Not Found

{
  "message": "No se encontraron resultados con el número suministrado: SOL-2024-001",
  "data": {}
}

Error 429 - Too Many Requests

{
  "error": "Peticiones excedidas",
  "message": "Ha excedido la cantidad de peticiones. Intente de nuevo en 1 minuto."
}

Error 500 - Internal Server Error