> ## 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. # SUSESO Dictámenes Search > Search the dictámenes of Chile's Superintendencia de Seguridad Social (SUSESO): about 16,100 social security rulings since 1971 on medical leave, work accidents (Ley 16.744), family allowance, compensation funds and welfare services. Free text matches the number, recipient, summary, topics, descriptors, legal sources and full text. Filter by `number`, `year`, the issue date (`from_date`/`to_date`), `topic` and `related_to` (the dictámenes SUSESO relates to a given one). Each result carries its topics, related dictámenes and circulars, attached files and links to its page at SUSESO and Croma's copy of it. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## OpenAPI ````yaml /api-reference/openapi.json post /cl/suseso/dictamenes-search/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, Mexico, United States, Brazil, El Salvador, Bolivia, Japan, and Chile, plus global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. Every operation is a POST with a JSON body and an organization API key as a bearer token; every operation is an idempotent lookup and accepts an optional `Idempotency-Key` header. Paths carry their major version (`/v1`); the versioning and deprecation policy, including the `Deprecation` and `Sunset` headers a retiring endpoint sends, is at https://docs.usecroma.com/versioning. Rate limits are per organization and reported on every response (`RateLimit-Policy`, `X-RateLimit-*`): https://docs.usecroma.com/rate-limits. termsOfService: https://usecroma.com/en/terms contact: name: Croma support url: https://usecroma.com/en/support email: support@usecroma.com servers: - url: https://api.croma.run security: [] paths: /cl/suseso/dictamenes-search/v1: post: tags: - Chile - Superintendencia de Seguridad Social (Chile) summary: SUSESO Dictámenes Search description: >- Search the dictámenes of Chile's Superintendencia de Seguridad Social (SUSESO): about 16,100 social security rulings since 1971 on medical leave, work accidents (Ley 16.744), family allowance, compensation funds and welfare services. Free text matches the number, recipient, summary, topics, descriptors, legal sources and full text. Filter by `number`, `year`, the issue date (`from_date`/`to_date`), `topic` and `related_to` (the dictámenes SUSESO relates to a given one). Each result carries its topics, related dictámenes and circulars, attached files and links to its page at SUSESO and Croma's copy of it. Served by Croma (`as_of` says how current the data is). **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. operationId: suseso_dictamenes_search parameters: - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: type: object required: [] properties: query: type: string maxLength: 300 default: '' description: >- Optional words matched against the dictamen's number, recipient, summary, topics, descriptors, legal sources and full text, e.g. `licencia médica rechazo` or `crédito social`. Every word must appear; plural and singular match each other. number: type: string maxLength: 40 default: '' description: >- Optional dictamen number as SUSESO publishes it, with its year, e.g. `150250-2026` or `O-01-S-04558-2026`. Case and spaces are ignored. year: type: integer minimum: 0 maximum: 2100 default: 0 description: Optional year of the dictamen. 0 searches every year. from_date: type: string format: date default: '' description: Optional date filter in yyyy-mm-dd format. to_date: type: string format: date default: '' description: Optional date filter in yyyy-mm-dd format. topic: type: string maxLength: 200 default: '' description: >- Optional topic, exactly as it appears in a result's `topics`, e.g. `Licencias médicas`, `Seguro laboral (Ley 16.744)`, `Asignación familiar`, `Créditos sociales`. related_to: type: string maxLength: 20 default: '' description: >- Optional dictamen `id`, e.g. `758965`: only the dictámenes SUSESO lists as related to it. page: type: integer minimum: 1 maximum: 1000 default: 1 description: 1-based page number for paginated results. per_page: type: integer minimum: 1 maximum: 50 default: 20 description: Results per page (1-50). additionalProperties: false example: query: licencia médica topic: Licencias médicas responses: '200': description: Successful response headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Cache: $ref: '#/components/headers/X-Cache' content: application/json: schema: $ref: '#/components/schemas/SusesoDictamenesSearchResponse' '400': description: Invalid request body headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '502': description: Upstream source returned an error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://docs.usecroma.com/guides/chile/suseso components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the `Idempotency-Key` response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit. schema: type: string maxLength: 255 example: 0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b headers: X-Request-Id: description: Unique id for the request (req_…). Include it in support reports. schema: type: string RateLimit-Policy: description: >- Quota policy for this endpoint as an IETF RateLimit-Policy structured field, e.g. `"default";q=100;w=86400` (100 requests per 86400-second window per organization). Endpoints with an extra hourly ceiling list both policies, e.g. `"webSearch";q=100;w=3600, "default";q=100;w=86400`. Present on every response, including 401 and 429. schema: type: string example: '"default";q=100;w=86400' Idempotency-Key: description: >- The `Idempotency-Key` the request carried, echoed back unchanged. Absent when the request sent none. schema: type: string Deprecation: description: >- Present only on an endpoint version scheduled for removal: the date the deprecation took effect (RFC 9745). A `Sunset` header and a `Link` with `rel="successor-version"` accompany it. Policy: https://docs.usecroma.com/versioning schema: type: string example: '@1767225600' Sunset: description: >- Present only on an endpoint version scheduled for removal: the date after which it answers 410 (RFC 8594). Announced in the changelog at least 90 days ahead. schema: type: string format: date-time example: Wed, 01 Apr 2026 00:00:00 GMT 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 spend no credits, but still count toward an hourly ceiling. schema: type: string enum: - HIT - MISS Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: SusesoDictamenesSearchResponse: type: object required: - data properties: data: $ref: '#/components/schemas/SusesoDictamenesSearchData' 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. SusesoDictamenesSearchData: type: object properties: as_of: anyOf: - type: string - type: 'null' description: How current the data in this response is. query: type: string number: anyOf: - type: string - type: 'null' year: anyOf: - type: number - type: 'null' from_date: anyOf: - type: string - type: 'null' to_date: anyOf: - type: string - type: 'null' topic: anyOf: - type: string - type: 'null' related_to: anyOf: - type: string - type: 'null' total: type: number description: Matches, counted up to 1000. total_is_exact: type: boolean description: >- False when more than 1000 match: `total` is then 1000, and the pages go on. page: type: number per_page: type: number total_pages: type: number description: Pages over `total`; there are more when `total_is_exact` is false. count: type: number results: type: array items: type: object properties: id: type: string description: >- The dictamen's permanent id at SUSESO, e.g. "758965". Pass it to the dictamen endpoint. number: type: string description: >- The dictamen's number as SUSESO publishes it, with its year, e.g. "150250-2026", "O-01-S-04558-2026", "4268-1988". SUSESO has used several numbering schemes over the years. title: type: string description: >- The dictamen's title at SUSESO, e.g. "Dictamen O-01-S-04558-2026". year: anyOf: - type: number - type: 'null' description: >- The year of the dictamen: of its date, or of its number when SUSESO gives no date. issued_date: anyOf: - type: string - type: 'null' description: >- `yyyy-mm-dd` the dictamen was issued. Null for the few SUSESO publishes without a date. recipient: anyOf: - type: string - type: 'null' description: >- Who the dictamen is addressed to (destinatario), e.g. "CAJA DE COMPENSACIÓN DE ASIGNACIÓN FAMILIAR", "COMPIN", "MUTUAL DE SEGURIDAD". summary: anyOf: - type: string - type: 'null' description: >- SUSESO's summary of what the dictamen decides (observación). Most dictámenes before 2019 have none. topics: type: array items: type: string description: >- The topics SUSESO files the dictamen under, e.g. ["Licencias médicas", "Subsidio Incapacidad Laboral (SIL)"]. Older dictámenes carry the topic of their era too, e.g. "LICENCIAS MÉDICAS" or "Ley N° 16.744". descriptors: type: array items: type: string description: >- SUSESO's descriptors for the dictamen, e.g. ["CCAF", "Crédito Social"]. legal_sources: anyOf: - type: string - type: 'null' description: >- The provisions the dictamen rests on (fuentes), as listed, e.g. "Ley 16.395, artículo 23; Ley 18.833, artículo 21". departments: type: array items: type: string description: >- The SUSESO units that issued it, e.g. ["INTENDENCIA DE BENEFICIOS SOCIALES - NORMATIVO"]. action: anyOf: - type: string - type: 'null' description: What the dictamen does (acción), when stated, e.g. "Instruye". criterion: anyOf: - type: string - type: 'null' description: Its criterion (criterio), when stated, e.g. "Antiguo". validity: anyOf: - type: string - type: 'null' description: >- Whether it still stands (vigencia), when stated, e.g. "No Alterado". related_circulars_text: anyOf: - type: string - type: 'null' description: >- The circulars SUSESO states the dictamen agrees with (concordancia con circulares), as written. related_oficios_text: anyOf: - type: string - type: 'null' description: >- The oficios SUSESO states the dictamen agrees with (concordancia con oficios), as written. other_fields: type: array items: type: object properties: label: type: string description: The label as SUSESO prints it. value: type: string description: Its value, as one line of text. required: - label - value description: Any other labelled field SUSESO prints for the dictamen. related_dictamenes: type: array items: type: object properties: id: type: string description: >- The related item's `id` at SUSESO. For a dictamen, pass it to the dictamen endpoint. title: type: string description: >- Its title as SUSESO lists it, e.g. "Dictamen O-01-S-00541-2025" or "Circular 3906". issued_date: anyOf: - type: string - type: 'null' description: '`yyyy-mm-dd` it was issued, when SUSESO lists it.' required: - id - title - issued_date description: The dictámenes SUSESO lists as related to this one. related_circulars: type: array items: type: object properties: id: type: string description: >- The related item's `id` at SUSESO. For a dictamen, pass it to the dictamen endpoint. title: type: string description: >- Its title as SUSESO lists it, e.g. "Dictamen O-01-S-00541-2025" or "Circular 3906". issued_date: anyOf: - type: string - type: 'null' description: '`yyyy-mm-dd` it was issued, when SUSESO lists it.' required: - id - title - issued_date description: The circulars SUSESO lists as related to this one. related_legislation: type: array items: type: string description: >- The provisions SUSESO links the dictamen to, e.g. ["Ley 16.395, artículo 23"]. attachments: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' description: What SUSESO calls the file, e.g. "Ejemplo numérico". name: type: string description: The file's name as SUSESO publishes it. content_type: anyOf: - type: string - type: 'null' description: >- The file's type, read from its bytes (e.g. `application/pdf`, `image/png`). bytes: anyOf: - type: number - type: 'null' description: The file's size in bytes. document_url: anyOf: - type: string - type: 'null' description: >- Croma's byte-for-byte copy of the file. Null while the copy is pending. source_document_url: type: string description: The file at SUSESO. required: - title - name - content_type - bytes - document_url - source_document_url description: >- Files SUSESO publishes with the dictamen (an annex, a table, a worked example). Most have none. official_url: type: string description: The dictamen's page at SUSESO. document_url: anyOf: - type: string - type: 'null' description: >- Croma's byte-for-byte copy of the dictamen's page at SUSESO, which holds its text: the latest version kept. source_document_url: type: string description: The dictamen's page at SUSESO, the document Croma keeps. document_versions: type: array items: type: object properties: document_url: type: string description: Croma's copy of this version of the dictamen's page. modified_at: anyOf: - type: string - type: 'null' description: >- When SUSESO last updated the page, as it reported it when Croma kept this copy (ISO timestamp). required: - document_url - modified_at description: >- Every version of the page Croma has kept, newest first. A new one is kept only when the dictamen itself changes, not when SUSESO adds to its related lists. required: - id - number - title - year - issued_date - recipient - summary - topics - descriptors - legal_sources - departments - action - criterion - validity - related_circulars_text - related_oficios_text - other_fields - related_dictamenes - related_circulars - related_legislation - attachments - official_url - document_url - source_document_url - document_versions required: - as_of - query - number - year - from_date - to_date - topic - related_to - total - total_is_exact - page - per_page - total_pages - count - results securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.