Scout RFP Bids API

openapi: 3.0.3
info:
  title: Workday Strategic Sourcing Events Bids API
  description: The Events API (formerly Scout RFP Events API) enables management of sourcing events including RFPs, RFIs, and reverse auctions within the Workday Strategic Sourcing platform. Supports creating events from templates, managing suppliers, worksheets, line items, and collecting bids.
  version: '1.3'
  contact:
    url: https://apidocs.workdayspend.com/
servers:
- url: https://api.us.workdayspend.com/services/events/v1
  description: US Production
- url: https://api.sandbox.us.workdayspend.com/services/events/v1
  description: US Sandbox
- url: https://api.eu.workdayspend.com/services/events/v1
  description: EU Production
- url: https://api.ca.workdayspend.com/services/events/v1
  description: CA Production
security:
- ApiKeyAuth: []
  UserTokenAuth: []
  UserEmailAuth: []
tags:
- name: Bids
paths:
  /events/{event_id}/bids:
    get:
      operationId: listBids
      summary: List Bids
      description: List all bids submitted for an RFP event.
      tags:
      - Bids
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of bids
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BidsListResponse'
  /events/{event_id}/bids/{id}:
    get:
      operationId: getBid
      summary: Get Bid
      description: Retrieve a specific bid for an event.
      tags:
      - Bids
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Bid details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BidResponse'
  /events/{event_id}/bids/describe:
    get:
      operationId: describeBid
      summary: Describe Bid Fields
      description: Get field definitions for bid objects.
      tags:
      - Bids
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Bid field definitions
  /events/{event_id}/bids/line_items:
    get:
      operationId: listBidLineItems
      summary: List Bid Line Items
      description: List all bid line items for an event.
      tags:
      - Bids
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of bid line items
  /events/{event_id}/bids/{bid_id}/line_items/{id}:
    get:
      operationId: getBidLineItem
      summary: Get Bid Line Item
      description: Retrieve a specific bid line item.
      tags:
      - Bids
      parameters:
      - name: event_id
        in: path
        required: true
        schema:
          type: string
      - name: bid_id
        in: path
        required: true
        schema:
          type: string
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Bid line item details
components:
  schemas:
    BidResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
            type:
              type: string
            attributes:
              type: object
              properties:
                total_cost:
                  type: number
                submitted_at:
                  type: string
                  format: date-time
    BidsListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/BidResponse/properties/data'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Company-wide API key
    UserTokenAuth:
      type: apiKey
      in: header
      name: X-User-Token
      description: User-specific API token
    UserEmailAuth:
      type: apiKey
      in: header
      name: X-User-Email
      description: User email address