---
title: "OECE Processes Search"
method: POST
path: "/pe/oece/processes-search/v1"
tags: ["Peru", "OECE Contrataciones Abiertas"]
---

# OECE Processes Search

`POST /pe/oece/processes-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/pe/oece/processes-search/v1`
- Auth: HTTP bearer

Search Peru's public-procurement procedures (SEACE, published by OECE) by free text over title and description, buyer RUC, awarded supplier RUC, department, category (goods/services/works), procedure type, publication-date window and last-modified date. Newest first, pages of up to 50. Served by Croma (`as_of` says how current the data is), covering procedures published from 2020.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en el título y la descripción del proceso (opcional).
  - `buyer_ruc` string: RUC de 11 dígitos (opcional).
  - `supplier_ruc` string: RUC de 11 dígitos (opcional).
  - `department` string: Departamento de la entidad compradora, p. ej. `LIMA` (opcional).
  - `category` '' | 'goods' | 'services' | 'works': Categoría principal: `goods`, `services` o `works` (opcional).
  - `method` string: Tipo de procedimiento tal como lo nombra la fuente, p. ej. `Licitación Pública` (opcional).
  - `from_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `to_date` string, date: Optional date filter in yyyy-mm-dd format.
  - `updated_after` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- OeceProcessesSearchResponse
  - `data` OeceProcessesSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `buyer_ruc` string, nullable, required
    - `supplier_ruc` string, nullable, required
    - `department` string, nullable, required
    - `category` string, nullable, required
    - `method` string, nullable, required
    - `from_date` string, nullable, required
    - `to_date` string, nullable, required
    - `updated_after` string, nullable, required
    - `total` number, required: Processes matching the filters, across every page, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `processes` object[], required
      - `ocid` string, required
      - `source` string, nullable, required
      - `tender_id` string, nullable, required
      - `title` string, nullable, required
      - `description` string, nullable, required
      - `buyer` object, required
        - `id` string, nullable, required: The source's party id (`PE-CONSUCODE-<code>` for entities, `PE-RUC-<ruc>` for companies).
        - `name` string, nullable, required
        - `ruc` string, nullable, required: 11-digit RUC when the party carries one.
      - `department` string, nullable, required
      - `procurement_method_details` string, nullable, required
      - `category` string, nullable, required
      - `value` object, required
        - `amount` number, nullable, required
        - `currency` string, nullable, required: ISO 4217, usually `PEN`.
        - `amount_pen` number, nullable, required: The amount in soles, as the source converts it.
      - `published_date` string, nullable, required
      - `status_details` string[], required
      - `award_count` number, required
      - `contract_count` number, required
      - `awarded_amount_pen` number, nullable, required
      - `suppliers` object[], required
        - `id` string, nullable, required: The source's party id (`PE-CONSUCODE-<code>` for entities, `PE-RUC-<ruc>` for companies).
        - `name` string, nullable, required
        - `ruc` string, nullable, required: 11-digit RUC when the party carries one.
      - `updated_at` string, nullable, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)