API Rol Nacional

Introducción

La API Pública de Rol Nacional de Audiencias es un servicio web que permite consultar información sobre audiencias judiciales programadas en todo el territorio nacional de manera programática. Esta API proporciona acceso a datos de audiencias, calendarios, tribunales, salas y otros recursos relacionados con el sistema judicial.

Información General

Requisitos Previos

Para utilizar esta API, necesitará:

• Conexión a Internet: Acceso estable a la red
• Cliente HTTP: Cualquier herramienta capaz de realizar peticiones HTTP (curl, Postman, navegador web, etc.)
• Conocimientos básicos de:
  • Peticiones HTTP (GET y POST)
  • Formato JSON
  • Manejo de respuestas paginadas

Endpoints Disponibles

{
  "paginaActual": 1,
  "totalPaginas": 5,
  "registrosPorPagina": 20,
  "totalRegistros": 100,
  "pendientes": 25,
  "enCurso": 15,
  "recesadas": 10,
  "conocidas": 50,
  "datos": [
    {
      "idAudiencia": 12345,
      "idModalidad": 1,
      "idEstadoRolAudiencia": 2,
      "rolNumero": 1,
      "fechaAudiencia": "10/11/2025",
      "fechaDate": "2025-11-10T00:00:00",
      "horaAudiencia": "09:00 AM",
      "nuc": "2024-0001234-CIVIL",
      "distritoJudicial": "Distrito Nacional",
      "categoriaTribunal": "Primera Instancia",
      "tribunal": "Juzgado de Primera Instancia Civil",
      "sala": "Sala 1",
      "modalidad": "Presencial",
      "urlAudiencia": null,
      "direccionSala": "Calle Principal #123",
      "estadoRolAudiencia": "Pendiente",
      "partes": "Juan Perez vs Maria Gomez",
      "tipoResultado": "Audiencia Preliminar",
      "materia": "Civil"
    }
  ]
}

Ejemplos de Uso

Ejemplo 1: Consulta de Rol de Audiencias con curl

curl -X POST "https://api.poderjudicial.gob.do/RolAudiencias/api/Audiencias/RolAudiencias" \
  -H "Content-Type: application/json" \
  -d '{
    "IdDistritoJudicial": 1,
    "IdMateria": 2,
    "FechaDesde": "2025-11-01",
    "FechaHasta": "2025-11-30",
    "PaginaActual": 1,
    "RegistrosPorPagina": 20
  }'

Ejemplo 2: Consulta con JavaScript (Fetch API)

const obtenerRolAudiencias = async (filtros) => {
  const url = 'https://api.poderjudicial.gob.do/RolAudiencias/api/Audiencias/RolAudiencias';

  try {
    const response = await fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify(filtros)
    });

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

    const data = await response.json();
    console.log('Audiencias:', data);
    return data;

  } catch (error) {
    console.error('Error al consultar audiencias:', error);
  }
};

// Uso
const filtros = {
  IdDistritoJudicial: 1,
  IdMateria: 2,
  FechaDesde: '2025-11-01',
  FechaHasta: '2025-11-30',
  PaginaActual: 1,
  RegistrosPorPagina: 20
};

obtenerRolAudiencias(filtros);

Ejemplo 3: Consulta con Python (requests)

import requests
from datetime import datetime

def obtener_rol_audiencias(filtros):
    url = "https://api.poderjudicial.gob.do/RolAudiencias/api/Audiencias/RolAudiencias"

    try:
        response = requests.post(url, json=filtros)
        response.raise_for_status()

        data = response.json()
        print(f"Total de registros: {data['totalRegistros']}")
        print(f"Total de paginas: {data['totalPaginas']}")
        print(f"Pendientes: {data['pendientes']}")
        print(f"En Curso: {data['enCurso']}")

        return data

    except requests.exceptions.RequestException as e:
        print(f"Error al consultar la API: {e}")
        return None

# Uso
filtros = {
    'IdDistritoJudicial': 1,
    'IdMateria': 2,
    'FechaDesde': '2025-11-01',
    'FechaHasta': '2025-11-30',
    'PaginaActual': 1,
    'RegistrosPorPagina': 20
}

audiencias = obtener_rol_audiencias(filtros)

Ejemplo 4: Consulta con C# (.NET)

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

public class RolAudienciasClient
{
    private readonly HttpClient _httpClient;

    public RolAudienciasClient()
    {
        _httpClient = new HttpClient();
    }

    public async Task<PaginacionResponse<RolAudienciaResponse>> ObtenerRolAudiencias(
        RolAudienciaRequest request)
    {
        var url = "https://api.poderjudicial.gob.do/RolAudiencias/api/Audiencias/RolAudiencias";

        try
        {
            var jsonContent = JsonSerializer.Serialize(request);
            var content = new StringContent(jsonContent, Encoding.UTF8, "application/json");

            var response = await _httpClient.PostAsync(url, content);
            response.EnsureSuccessStatusCode();

            var responseContent = await response.Content.ReadAsStringAsync();
            var resultado = JsonSerializer.Deserialize<PaginacionResponse<RolAudienciaResponse>>(
                responseContent);

            Console.WriteLine($"Total de registros: {resultado.TotalRegistros}");
            Console.WriteLine($"Pendientes: {resultado.Pendientes}");
            Console.WriteLine($"En Curso: {resultado.EnCurso}");

            return resultado;
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
            return null;
        }
    }
}

// Uso
var client = new RolAudienciasClient();
var request = new RolAudienciaRequest
{
    IdDistritoJudicial = 1,
    IdMateria = 2,
    FechaDesde = new DateTime(2025, 11, 1),
    FechaHasta = new DateTime(2025, 11, 30),
    PaginaActual = 1,
    RegistrosPorPagina = 20
};

var resultado = await client.ObtenerRolAudiencias(request);

Ejemplo 5: Obtener Distritos y Materias (GET)

// JavaScript - Obtener distritos
const obtenerDistritos = async () => {
  const response = await fetch('https://api.poderjudicial.gob.do/RolAudiencias/api/Distritos');
  const distritos = await response.json();
  console.log('Distritos:', distritos);
};

// JavaScript - Obtener materias
const obtenerMaterias = async () => {
  const response = await fetch('https://api.poderjudicial.gob.do/RolAudiencias/api/Materias');
  const materias = await response.json();
  console.log('Materias:', materias);
};

obtenerDistritos();
obtenerMaterias();

Códigos de Estado HTTP

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

Limitación de Peticiones

La API implementa un sistema de limitación de peticiones (Rate Limiting) para garantizar un uso equitativo del servicio.

Comportamiento al Exceder el Límite

Cuando se excede el límite de peticiones:

1. Código de respuesta: 429 Too Many Requests
2. Mensaje de error:

{
  "error": "Ha superado el límite de peticiones permitidas."
}

Manejo de Errores

Error 400 - Parámetros Inválidos

{
  "message": "Se debe enviar una sala",
  "codigoError": 400
}

Error 404 - Sin Resultados

{
  "data": [],
  "mensaje": "No se encontraron datos."
}

Error 500 - Error del Servidor

{
  "message": "Descripción del error interno"
}

Estructura de Paginación

La API utiliza un sistema de paginación que incluye información adicional sobre los estados de las audiencias:

Glosario