{
  "openapi": "3.0.1",
  "info": {
    "title": "Colombia Case Law: Constitutional Court & Council of State",
    "description": "Search Colombian high-court case law: Constitutional Court rulings and orders (Relatoría) and Council of State rulings (SAMAI), by text, ruling number, topic, section, rapporteur and dates.",
    "version": "0.1",
    "x-build-id": "kFX231MifsRdgmkxd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/legaltech~altas-cortes-co/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-legaltech-altas-cortes-co",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/legaltech~altas-cortes-co/runs": {
      "post": {
        "operationId": "runs-sync-legaltech-altas-cortes-co",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/legaltech~altas-cortes-co/run-sync": {
      "post": {
        "operationId": "run-sync-legaltech-altas-cortes-co",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "One search per item, in Spanish. Constitutional Court: words or \"exact phrase\" over the full text (or over the field chosen in `searchIn`). Council of State: full-text search of the titled rulings.",
            "items": {
              "type": "string"
            }
          },
          "rulingNumbers": {
            "title": "Ruling or case numbers",
            "type": "array",
            "description": "Constitutional Court ruling numbers such as \"T-760/08\", \"SU-214/16\", \"C-355/06\" or \"A. 185A/16\"; Council of State case numbers (radicado, 23 digits) or internal numbers (número interno).",
            "items": {
              "type": "string"
            }
          },
          "sources": {
            "title": "Courts",
            "type": "array",
            "description": "Which courts to search. Codes are opaque: do NOT guess them; choose by reading the title (enumTitle) of each option.",
            "items": {
              "type": "string",
              "enum": [
                "corte-constitucional",
                "consejo-estado"
              ],
              "enumTitles": [
                "Corte Constitucional (Relatoría)",
                "Consejo de Estado (SAMAI, providencias tituladas)"
              ]
            },
            "default": [
              "corte-constitucional",
              "consejo-estado"
            ]
          },
          "searchIn": {
            "title": "Search in (Constitutional Court)",
            "enum": [
              "text",
              "topics",
              "operativePart",
              "statutes"
            ],
            "type": "string",
            "description": "\"topics\" returns each ruling with the topic and subtopic under which the Relatoría classified it.",
            "default": "text"
          },
          "ccRulingTypes": {
            "title": "Ruling types (Constitutional Court)",
            "type": "array",
            "description": "Constitutional Court ruling types (T, C, SU, A). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Tutela",
                "Constitucionalidad",
                "Sentencia de unificación",
                "Auto"
              ],
              "enumTitles": [
                "Tutela (T)",
                "Constitucionalidad (C)",
                "Sentencia de unificación (SU)",
                "Auto (A)"
              ]
            },
            "default": []
          },
          "ccProcessTypes": {
            "title": "Process types (Constitutional Court)",
            "type": "array",
            "description": "Constitutional Court process types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Acciones de Tutela",
                "Demandas Ordinarias",
                "Conflictos entre Jurisdicciones",
                "Conflictos de Competencia",
                "Decretos Legislativos",
                "Leyes Aprobatorias de Tratados",
                "Constitucionalidad",
                "Objeciones de Inconstitucionalidad",
                "Objeciones Gubernamentales",
                "Proyecto Ley Estatutaria",
                "Decretos Leyes para la paz",
                "Leyes y Actos Legislativos para la Paz",
                "Excusas",
                "Convocatoria a Referendo",
                "Tratados Internacionales"
              ]
            },
            "default": []
          },
          "ceSections": {
            "title": "Sections (Council of State)",
            "type": "array",
            "description": "Sección Primera: nullity and general administrative matters; Segunda: labour/public employment; Tercera: contracts and state liability (reparación directa); Cuarta: taxes; Quinta: elections and tutela.",
            "items": {
              "type": "string",
              "enum": [
                "Sala Plena",
                "Sala plena contenciosa",
                "Sala Consulta y Servicio Civil",
                "Sala especial de decisión",
                "Sección Primera",
                "Sala Plena Sección Segunda",
                "Sección Segunda (Subsección A)",
                "Sección Segunda (Subsección B)",
                "Sala Plena Sección Tercera",
                "Sección Tercera (Subsección A)",
                "Sección Tercera (Subsección B)",
                "Sección Tercera (Subsección C)",
                "Sección Cuarta",
                "Sección Quinta"
              ]
            },
            "default": []
          },
          "ceRulingTypes": {
            "title": "Ruling types (Council of State)",
            "type": "array",
            "description": "Council of State ruling types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Sentencia",
                "Auto interlocutorio",
                "Auto de sustanciación",
                "Concepto sin reserva",
                "Salvamento voto",
                "Aclaración voto",
                "Acta de conciliación",
                "Audiencia",
                "Conflicto",
                "Otras providencias"
              ]
            },
            "default": []
          },
          "rapporteur": {
            "title": "Rapporteur judge (magistrado ponente)",
            "type": "string",
            "description": "Name or surname, e.g. \"Sáchica\" or \"Reyes Cuartas\". Council of State: applied by the source; Constitutional Court: applied to the results."
          },
          "ceTopic": {
            "title": "Topic / descriptor (Council of State)",
            "type": "string",
            "description": "Only rulings titled with a descriptor containing this text, e.g. \"caducidad\" or \"falla del servicio\"."
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Decision date, start of range (YYYY-MM-DD). The Council of State date filter starts on 2021-12-01."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Decision date, end of range (YYYY-MM-DD)."
          },
          "sortOrder": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "oldest"
            ],
            "type": "string",
            "description": "Sort criterion.",
            "default": "relevance"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum per search term and court. The Council of State returns 10 results per page.",
            "default": 20
          },
          "passages": {
            "title": "Relevant passages",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Paragraphs containing the search terms, returned in `passages` (0 = none). Constitutional Court: from the full text (each ruling is opened); Council of State: from the titling (legal issue, answer, extract).",
            "default": 3
          },
          "includeFullText": {
            "title": "Include full text (Constitutional Court)",
            "type": "boolean",
            "description": "Adds the `text` field with the full Constitutional Court ruling. Greatly increases output size.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The sources usually work without a proxy. If they block, use Apify RESIDENTIAL (CO) or your own proxyUrls; requests then use sticky sessions, IP rotation and a Chrome TLS fingerprint.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}