> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # CNDJ Rulings Search > Search disciplinary rulings against judges and lawyers from the Relatoría de la CNDJ. Query by free text or by advanced filters (magistrado ponente, tema, disciplinado, asunto, restrictor, año de radicación). Each result carries the numero unico and numero ficha (the record key), magistrado ponente, the subject of the filing, the decision, and the date. Drill into one with `cndj-ruling`. ## OpenAPI ````yaml /api-reference/openapi.json post /co/cndj/rulings-search/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, Mexico, and global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. servers: - url: https://api.croma.run security: [] paths: /co/cndj/rulings-search/v1: post: tags: - Colombia - Relatoría de la CNDJ summary: CNDJ Rulings Search description: >- Search disciplinary rulings against judges and lawyers from the Relatoría de la CNDJ. Query by free text or by advanced filters (magistrado ponente, tema, disciplinado, asunto, restrictor, año de radicación). Each result carries the numero unico and numero ficha (the record key), magistrado ponente, the subject of the filing, the decision, and the date. Drill into one with `cndj-ruling`. operationId: cndj_rulings_search requestBody: required: true content: application/json: schema: type: object required: [] properties: query: type: string maxLength: 300 default: '' description: Texto de búsqueda general (providencias disciplinarias). reporting_judge: type: string maxLength: 120 default: '' description: Filtro por magistrado ponente. subject: type: string maxLength: 120 default: '' description: Filtro por tema. respondent: type: string maxLength: 120 default: '' description: Filtro por nombre del disciplinado. matter: type: string maxLength: 120 default: '' description: Filtro por asunto. subtopic: type: string maxLength: 120 default: '' description: Filtro por restrictor. year: type: string default: '' description: Filtro opcional por año de radicación (4 dígitos). limit: type: integer minimum: 1 maximum: 100 default: 25 description: Número máximo de resultados a devolver. additionalProperties: false example: query: prescripción responses: '200': description: Successful response headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left before you are throttled. schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when the window resets. schema: type: string format: date-time X-Cache: description: HIT or MISS. Cached hits still count against your quota. schema: type: string enum: - HIT - MISS content: application/json: schema: $ref: '#/components/schemas/CndjRulingsSearchResponse' '400': description: Invalid request body headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left before you are throttled. schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when the window resets. schema: type: string format: date-time Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' '502': description: Upstream source returned an error headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://docs.usecroma.com/guides/colombia/cndj components: schemas: CndjRulingsSearchResponse: type: object required: - data properties: data: type: object required: - query - total - count - limit - results properties: query: type: string total: type: integer description: Total de coincidencias reportadas. count: type: integer description: Resúmenes en esta respuesta. limit: type: integer results: type: array items: $ref: '#/components/schemas/CndjRulingSummary' ApiError: type: object required: - error properties: error: type: object required: - type - code - message properties: type: type: string description: >- Broad category: invalid_request_error, authentication_error, not_found_error, rate_limit_error, upstream_error, api_error. code: type: string description: Machine-readable specific code. message: type: string description: Human-readable explanation, safe to surface in UI. param: type: string description: Field that triggered the error. Present on validation errors. details: type: object description: Free-form structured detail. CndjRulingSummary: type: object required: - numero_unico - numero_ficha - magistrado_ponente - contenido_radicacion - decision - fecha properties: numero_unico: type: string description: >- Numero unico de la radicación (23 dígitos). Parte de la llave del registro. numero_ficha: type: integer description: >- Número de ficha dentro de la radicación. Parte de la llave del registro. magistrado_ponente: type: - string - 'null' contenido_radicacion: type: - string - 'null' description: Asunto de la radicación. decision: type: - string - 'null' description: Texto de la decisión. fecha: type: - string - 'null' format: date description: Fecha de la providencia (`YYYY-MM-DD`). securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ````