> ## 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. # Colombia Laws Search > Search Colombian legislation as structured data, sourced from Legalize. Filter by free text, law type, publication year, status, and jurisdiction. Returns paginated law summaries; use `per_page` and `page` to page. Drill into one with Colombia Law Detail. ## OpenAPI ````yaml /api-reference/openapi.json post /co/legalize/laws/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, 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/legalize/laws/v1: post: tags: - Colombia - Legalize summary: Colombia Laws Search description: >- Search Colombian legislation as structured data, sourced from Legalize. Filter by free text, law type, publication year, status, and jurisdiction. Returns paginated law summaries; use `per_page` and `page` to page. Drill into one with Colombia Law Detail. operationId: legalize_laws_search requestBody: required: true content: application/json: schema: type: object required: [] properties: query: type: string maxLength: 200 default: '' description: >- Free-text search over law titles and content. Omit to list all. law_type: type: string maxLength: 60 default: '' description: >- Filter by law type (e.g. `ley`, `decreto`). Omit for all types. year: type: string default: '' description: Filter by publication year (yyyy). Omit for all years. status: type: string maxLength: 40 default: '' description: Filter by law status (e.g. `in_force`). Omit for any status. jurisdiction: type: string maxLength: 60 default: '' description: Filter by jurisdiction. Omit for all jurisdictions. page: type: integer minimum: 1 maximum: 1000 default: 1 description: 1-based page number for paginated results. per_page: type: integer minimum: 1 maximum: 100 default: 50 description: Results per page (1-100). additionalProperties: false example: query: habeas data per_page: 20 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/LegalizeLawsSearchResponse' '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://usecroma.com/colombia/legalize components: schemas: LegalizeLawsSearchResponse: type: object required: - data properties: data: type: object required: - query - total - page - per_page - count - results properties: query: type: - string - 'null' total: type: integer description: Total laws matching the filters. page: type: integer per_page: type: integer count: type: integer description: Number of results on this page. results: type: array items: $ref: '#/components/schemas/LegalizeLawSummary' 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. LegalizeLawSummary: type: object required: - id - title - short_title - law_type - publication_date - status - jurisdiction - article_count - title_snippet description: A law summary row from the legislation search. properties: id: type: string description: Law identifier; pass to Law Detail. title: type: string short_title: type: - string - 'null' law_type: type: - string - 'null' publication_date: type: - string - 'null' format: date status: type: - string - 'null' jurisdiction: type: - string - 'null' article_count: type: - integer - 'null' title_snippet: type: - string - 'null' description: Matched-title excerpt when the query hit the title. securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ````