---
title: "OECE Process by OCID"
method: POST
path: "/pe/oece/process/v1"
tags: ["Peru", "OECE Contrataciones Abiertas"]
---

# OECE Process by OCID

`POST /pe/oece/process/v1`

## Request

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

Resolve one Peruvian public-procurement procedure (SEACE, published by OECE) by its OCDS id and return the full record: buyer, estimated value, items with their stage, bidding documents, awards with suppliers, and contracts. `found: false` when there is no procedure with that id. 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
  - `ocid` string, required: OCDS process id, e.g. `ocds-dgv273-seacev3-873200`.

## Response `200`

Successful response

- OeceProcessResponse
  - `data` OeceProcessData, required
    - `found` boolean, required
    - `ocid` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `process` object, nullable, required
      - `ocid` string, required: OCDS process id, the stable key.
      - `source` string, nullable, required: Which SEACE generation published it (`seace_v2`, `seace_v3`).
      - `tender_id` string, nullable, required
      - `title` string, nullable, required: The procedure's nomenclature, e.g. `AS-SM-18-2022-EGESUR-2`.
      - `description` string, nullable, required: The object of the procurement.
      - `buyer` object, required
        - `id` string, nullable, required: The source's entity id (`PE-CONSUCODE-<code>`).
        - `name` string, nullable, required
        - `ruc` string, nullable, required: The entity's 11-digit RUC.
      - `department` string, nullable, required: The buyer's department (región), e.g. `LIMA`.
      - `procurement_method` string, nullable, required: OCDS method (`open`, `direct`, `selective`).
      - `procurement_method_details` string, nullable, required: The procedure type as the source names it (`Licitación Pública`, `Adjudicación Simplificada`, ...).
      - `category` string, nullable, required: `goods`, `services` or `works`.
      - `additional_categories` string[], required
      - `value` object, required
        - `amount` number, nullable, required
        - `currency` string, nullable, required: ISO 4217, usually `PEN`.
        - `amount_pen` number, nullable, required: The estimated value in soles, as the source converts it.
      - `published_date` string, nullable, required: `yyyy-mm-dd` the procedure was published (convocatoria).
      - `tender_start_date` string, nullable, required
      - `tender_end_date` string, nullable, required
      - `number_of_tenderers` number, nullable, required
      - `status_details` string[], required: Distinct stages across the items, as the source names them.
      - `items` object[], required
        - `id` string, nullable, required
        - `description` string, nullable, required
        - `quantity` number, nullable, required
        - `unit` string, nullable, required
        - `classification_scheme` string, nullable, required: `CUBSO` (Peru's catalogue) or `UNSPSC`.
        - `classification_id` string, nullable, required
        - `classification` string, nullable, required
        - `status` string, nullable, required: OCDS item status (`active`, `complete`, `unsuccessful`, `cancelled`).
        - `status_details` string, nullable, required: The source's own stage for the item (`CONVOCADO`, `ADJUDICADO`, `CONTRATADO`, `DESIERTO`, `NULO`, ...).
      - `items_capped` boolean, required
      - `documents` object[], required
        - `id` string, nullable, required
        - `title` string, nullable, required
        - `type` string, nullable, required: OCDS document type (`biddingDocuments`, `awardNotice`, `clarifications`, `evaluationReports`).
        - `format` string, nullable, required
        - `url` string, nullable, required
        - `published_date` string, nullable, required
        - `modified_date` string, nullable, required
      - `documents_capped` boolean, required
      - `awards` object[], required
        - `id` string, nullable, required
        - `date` 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.
        - `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.
        - `item_count` number, required
      - `contracts` object[], required
        - `id` string, nullable, required
        - `award_id` string, nullable, required
        - `title` string, nullable, required
        - `description` string, nullable, required
        - `date_signed` string, nullable, required
        - `start_date` string, nullable, required
        - `end_date` string, nullable, required
        - `status` string, nullable, required
        - `status_details` 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.
      - `award_count` number, required
      - `contract_count` number, required
      - `awarded_amount_pen` number, nullable, required: Sum of the awards in soles; null when nothing was awarded.
      - `suppliers` object[], required: Distinct awarded suppliers.
        - `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.
      - `supplier_rucs` string[], required: RUCs of the awarded suppliers.
      - `segment` string, nullable, required: The source's publication month (`yyyy-mm`).
      - `updated_at` string, nullable, required: When the source last modified the record (ISO timestamp).

## 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)