{"openapi":"3.1.0","info":{"title":"SIAJ Consultas API","version":"1.1.0","description":"API paga para buscar jurisprudencia PBA con texto completo del fallo (hasta 15 por búsqueda, include_text=true por defecto), importar a Mis causas, sincronizar actuaciones/escritos MEV (async) y leerlos. Flujo típico: POST /v1/search → citar hits[].texto → POST /v1/causas (nro_expediente+organismo o document_id) → POST /v1/causas/{id}/sync → poll GET /v1/jobs/{job_id} → GET /v1/causas/{id}/actuaciones[/search]. Auth: Bearer sk_live_… (Configuración tras abonar)."},"servers":[{"url":"https://consultas.siaj.ar"}],"paths":{"/v1/me":{"get":{"operationId":"whoami","summary":"Plan y cupo","responses":{"200":{"description":"ok"}}}},"/v1/filters":{"get":{"operationId":"list_filters","summary":"Listar organismos exactos para filtrar","responses":{"200":{"description":"ok"}}}},"/v1/search":{"post":{"operationId":"search_jurisprudencia","summary":"Buscar fallos con texto completo (1 consulta del cupo)","description":"Devuelve hits[] con id, caratula, organismo, fecha, nro_expediente, snippet y texto completo del fallo (include_text=true). Por defecto top_k=15.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["texto"],"properties":{"texto":{"type":"string"},"organismos":{"type":"array","items":{"type":"string"},"description":"Nombre exacto del organismo (usar list_filters)"},"instancias":{"type":"array","items":{"type":"string"},"description":"camara|corte|juzgado"},"top_k":{"type":"integer","default":15,"minimum":1,"maximum":25},"include_text":{"type":"boolean","default":true,"description":"Incluir texto entero del fallo en cada hit"},"max_chars":{"type":"integer","default":120000,"description":"Tope de caracteres por fallo"}}}}}},"responses":{"200":{"description":"hits con texto"}}}},"/v1/documents/{document_id}":{"get":{"operationId":"get_document","summary":"Texto completo de un fallo por id","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","schema":{"type":"string"}},{"name":"max_chars","in":"query","schema":{"type":"integer","default":120000}}],"responses":{"200":{"description":"ok"}}}},"/v1/causas":{"get":{"operationId":"list_causas","summary":"Listar Mis causas","responses":{"200":{"description":"ok"}}},"post":{"operationId":"import_causa","summary":"Agregar fallo/causa a Mis causas","description":"Importá una causa para luego sincronizar MEV. Pasá nro_expediente + organismo del hit, o document_id (+ path) para completar metadatos desde el fallo.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"nro_expediente":{"type":"string"},"organismo":{"type":"string"},"departamento":{"type":"string"},"caratula":{"type":"string"},"document_id":{"type":"string","description":"id del hit de search"},"path":{"type":"string"},"m1_link":{"type":"string"}}}}}},"responses":{"201":{"description":"created"}}}},"/v1/causas/{causa_id}/sync":{"post":{"operationId":"sync_causa","summary":"Sincronizar MEV (escritos/actuaciones) — 202 + job_id","description":"Lanza sync async con las credenciales MEV del dueño de la API key. Abre la causa en el organismo indicado y además lee «Ver Tramitación en Otros Organismos» (1ª instancia / otros tribunales). No hace falta reimportar en el juzgado. Poll GET /v1/jobs/{job_id} hasta state=ok; luego leé actuaciones.","parameters":[{"name":"causa_id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"202":{"description":"accepted"}}}},"/v1/jobs/{job_id}":{"get":{"operationId":"get_job","summary":"Poll sync job","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}},"/v1/causas/{causa_id}/actuaciones":{"get":{"operationId":"list_actuaciones","summary":"Listar actuaciones/escritos sincronizados desde MEV","parameters":[{"name":"causa_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"max_chars","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"ok"}}}},"/v1/causas/{causa_id}/actuaciones/search":{"get":{"operationId":"search_actuaciones","summary":"Buscar palabras en escritos/actuaciones del expediente","parameters":[{"name":"causa_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"q","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"ok"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key"}}},"security":[{"bearerAuth":[]}]}