API de Casos

Inicio / Apis Judiciales / API de Casos

API de Casos

Inicio / Apis Judiciales / API de Casos

Descripcion

API que permite gestionar los envíos de documentos entre la Suprema Corte de Justicia y Tribunal Constitucional.

Principales funcionalidades:

  • Autenticación mediante JWT.
  • Consulta paginada de datos enviados.
  • Actualización del estado de envíos.
Autenticación / EndPoint

POST /api/Auth

Descripción: Autentica un usuario y devuelve un token JWT.

Request Body:

				
					{
 "userName ": " username",
 "clave": "*****"
}

				
			

Responses:

200 OK

				
					{
 "message": "No autorizado"
}
				
			

401 Unauthorized

				
					{
 "token": "eyJhbGciOiJIUzI1..."
}
				
			

500 Internal Server Error

				
					{
 "message": "Error interno",
 "innerException": "Detalles del error interno"
}
				
			

POST /api/EnviosDeSupremaCorte

Requiere Token JWT en el header:

Authorization: Bearer {token}

Descripción: Consultar los casos enviados desde la SCJ, con filtros opcionales por fechas, documento de identidad, número único de caso, y paginación

Request Body:

				
					{
    "documentoIdentidad": "123456789",
    "idTipoDocumentoIdentidad": 1,
    "idEstatus": 117,
    "numeroUnicoCaso": "2023-0001",
    "fechaDesde": "2023-01-01",
    "fechaHasta": "2023-12-31",
    "paginaActual": 1,
    "registrosPorPagina": 10
}
				
			

Descripción de las propiedades

DocumentoIdentidad: Número de cédula de una de las partes involucradas en el caso, número de pasaporte, RNC de empresas y matrícula de abogados, si estan disponbles.

idTipoDocumentoIdentidad: Tipo de identificación para filtros especificos, los valores permitidos son los siguientes:

  1. Consultar por número de documento de indentidad de una de las partes.
  2. Consultar por número de documento de indentidad de un representante.
  3. Consultar por el número de RNC de una empresa.


idEstatus:
Para consultar estados específicos de los envios. Los valores permitidos son:

  • 117 : Pendiente Recibir
  • 118 : Recibido
  • 119 : Devuelto
  • 120 : Reenviado


numeroUnicoCaso:
Número único del expediente en la SCJ.

fechaDesde: Consultar un rango de fecha de envío del expediente al tribunal Constitucional.

fechaHasta: Completar el rango de fecha. pág. 3

paginaActual: Página a mostrar desde los datos paginados.

registrosPorPagina: Total de registros a mostrar en una página.

Validaciones:

  • idEstatus: Los valores permitidos son 117, 118, 119, 120.
  • documentoIdentidad: Si se envía, entonces idTipoDocumentoIdentidad es requerido (y viceversa), no incluir guiones(-) o (/).
  • IdTipoDocumentoIdentidad: Los valores permitidos son 1,2,3.
  • FechaDesde: Si es enviada, entonces FechaHasta también es obligatoria (y viceversa).
  • Formato de fecha: yyyy-MM-dd.

  • paginaActual: Si no se envía el valor por defecto será 1.

  • registrosPorPagina: si no se envía el valor por defecto será 10.

  • Si no se envía ningún parametro, la consuta arrojará los registros de mes actual, un total de 100.

  • registrosPorPagina máximo: 60.

Responses:

200 OK (cuando hay datos)

Retorna una lista(json) de casos los siguientes datos:

  • Datos de paginación.
  • Cantidad de registros po estatus.
  • Lista de casos con sus datos generales, con un listado de partes involucradas y documentos vinculados.
				
					{
    paginaActual": 1,
    "totalPaginas": 1,
    "registrosPorPagina": 10,
    "totalRegistros": 1,
    "pendientes": 0,
    "recibidos": 0,
    "devueltos": 0,
    "reenviados": 1,
    pág. 4
    "datos": [
        {
            "idEnvio": 1,
            "idTramite": 1111,
            "idEstatus": 117,
            "numeroUnicoCaso": "2025-01374",
            "fechaEnvio": "2025-07-18",
            "fechaActualizado": "2025-07-18",
            "asunto": "RECURSO DE REVISIÓN CONSTITUCIONAL DE DECISIONES JURISDICCIONALES",
            "tribunal": "SUPREMA CORTE DE JUSTICIA",
            "sala": "PRIMERA SALA DE LA SUPREMA CORTE DE JUSTICIA",
            "numeroDecisionRecurrida": "00001-1025",
            "fechaDecisionRecurrida": "2025-07-18",
            "estatus": "Pendiente de Recibir",
            "fechaDovolucion": "",
            "motivoDevolucion": "",
            "usuarioDevolucion": "",
            "partesVinculadas": [
                {
                    "idTramite": 1186590,
                    "calidad": "Recurrente",
                    "nombres": "JOSE",
                    "apellidos": "PEREZ",
                    "numeroDocumento": "11111111111",
                    "tipoDocumento": "Cédula",
                    "tipoEntidad": "Persona"
                },
                {
                    "idTramite": 1186590,
                    "calidad": "Recurrido",
                    "nombres": "Pedro",
                    "apellidos": "Taveras",
                    "numeroDocumento": "22222222222",
                    "tipoDocumento": "Cédula",
                    "tipoEntidad": "Persona"
                }
            ],
            "documentosRelacionados": [
            {
                "idTramite": 1186590,
                "categoria": "Documento Depositado",
                "fechaDocumento": "01/08/2024",
                "tipoDocumento": "SENTENCIA",
                "numeroDocumento": "",
                "urlDocumento": "https://... "
            },
        ]
        pág. 5
        }
    ]
}
				
			

401 Unauthorized

				
					{
 "token": "eyJhbGciOiJIUzI1..."
}
				
			

500 Internal Server Error

				
					{
 "message": "Error interno",
 "innerException": "Detalles del error interno"
}
				
			

Preguntas Frecuentes

Una API (Interfaz de Programación de Aplicaciones) es un puente de comunicación que permite que tu aplicación solicite y reciba datos específicos de nuestros sistemas de justicia de forma segura y estandarizada.

Puedes encontrar la documentación completa en la página de cada una de las APIs listadas en la sección de APIs Judiciales. Incluye ejemplos de código y guías detalladas para ayudarte a integrarlas de forma rápida, ya que nuestras APIs son gratuitas y abiertas.

Como nuestras APIs son abiertas, puedes empezar a usarlas de inmediato. Solo tienes que ir a la sección de APIs Judiciales, seleccionar la que necesites y seguir la documentación para empezar a hacer tus primeras consultas. No necesitas registrarte ni obtener una clave API.

Empowering you not to hesitate to consult about taxes with us.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.