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

# El Salvador COMPRASAL Tenders for a Supplier

> The open COMPRASAL processes a supplier could bid on, by its `id` from the suppliers search: open tenders whose offers are still due, ranked by how much they share with what the supplier has been awarded before (rare words count more than common ones), each with its `score`, the `matched_terms` and the past awards that read most like it. Served by Croma from its copy of the open tenders and the supplier's awards (`as_of`).

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



## OpenAPI

````yaml /api-reference/openapi.json post /sv/comprasal-sv/tenders-for-supplier/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, and Japan, 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:
  /sv/comprasal-sv/tenders-for-supplier/v1:
    post:
      tags:
        - El Salvador
        - COMPRASAL (DINAC)
      summary: El Salvador COMPRASAL Tenders for a Supplier
      description: >-
        The open COMPRASAL processes a supplier could bid on, by its `id` from
        the suppliers search: open tenders whose offers are still due, ranked by
        how much they share with what the supplier has been awarded before (rare
        words count more than common ones), each with its `score`, the
        `matched_terms` and the past awards that read most like it. Served by
        Croma from its copy of the open tenders and the supplier's awards
        (`as_of`).


        **Dataset endpoint**: answers from the whole source in milliseconds and
        carries `as_of`.
      operationId: comprasal_sv_tenders_for_supplier
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - supplier_id
              properties:
                supplier_id:
                  type: integer
                  minimum: 1
                  maximum: 100000000
                  description: The supplier's `id` from the suppliers search, e.g. `392`.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 10
                  description: How many matched tenders to return (1-50).
              additionalProperties: false
            example:
              supplier_id: 392
      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/ComprasalSvTendersForSupplierResponse'
        '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/el-salvador/compras-publicas
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:
    ComprasalSvTendersForSupplierResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/ComprasalSvTendersForSupplierData'
    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.
    ComprasalSvTendersForSupplierData:
      type: object
      properties:
        as_of:
          anyOf:
            - type: string
            - type: 'null'
          description: How current the open tenders are.
        found:
          type: boolean
          description: False when the supplier id is not in the register.
        supplier_id:
          type: number
        supplier_name:
          anyOf:
            - type: string
            - type: 'null'
        awards_considered:
          type: number
          description: Past awards of the supplier the match is built from.
        count:
          type: number
        results:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                description: The process's permanent id in COMPRASAL, e.g. `141137`.
              code:
                anyOf:
                  - type: string
                  - type: 'null'
                description: The process code, e.g. "8651-2026-P0075".
              name:
                type: string
                description: What the entity is buying.
              entity_name:
                anyOf:
                  - type: string
                  - type: 'null'
                description: The contracting entity.
              contracting_method:
                anyOf:
                  - type: string
                  - type: 'null'
                description: How it will be contracted, e.g. "Subasta Inversa".
              contracting_method_code:
                anyOf:
                  - type: string
                  - type: 'null'
                description: The contracting method's code, e.g. "SI".
              status:
                anyOf:
                  - type: string
                  - type: 'null'
                description: The process's status, e.g. "Activo".
              stage:
                anyOf:
                  - type: string
                  - type: 'null'
                description: Where the process is, e.g. "En ejecución".
              current_stages:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    starts_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: ISO timestamp.
                    ends_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: ISO timestamp.
                  required:
                    - name
                    - starts_at
                    - ends_at
                description: The stages under way now.
              stages:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    starts_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: ISO timestamp.
                    ends_at:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: ISO timestamp.
                  required:
                    - name
                    - starts_at
                    - ends_at
                description: Every stage of the process's calendar, in order.
              offers_due_at:
                anyOf:
                  - type: string
                  - type: 'null'
                description: >-
                  When offers close: the end of the offer reception stage, ISO
                  timestamp. Null when the calendar has none.
              activities:
                type: array
                items:
                  type: object
                  properties:
                    code:
                      type: string
                      description: The economic activity code, e.g. "46592".
                    name:
                      type: string
                  required:
                    - code
                    - name
                description: The economic activities the process is open to.
              activity_codes:
                type: array
                items:
                  type: string
                description: >-
                  The codes of `activities`, which is what the `activity_code`
                  filter matches.
              score:
                type: number
                description: >-
                  How strongly the tender matches what the supplier has sold
                  before, higher is closer.
              matched_terms:
                type: array
                items:
                  type: string
                description: >-
                  The words the tender shares with the supplier's past awards,
                  strongest first.
              similar_award_ids:
                type: array
                items:
                  type: string
                description: Past awards of the supplier that read most like the tender.
            required:
              - id
              - code
              - name
              - entity_name
              - contracting_method
              - contracting_method_code
              - status
              - stage
              - current_stages
              - stages
              - offers_due_at
              - activities
              - activity_codes
              - score
              - matched_terms
              - similar_award_ids
          description: Open tenders whose offers are still due, best match first.
      required:
        - as_of
        - found
        - supplier_id
        - supplier_name
        - awards_considered
        - 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.