# Share Bid

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v0/finance/req-share-bid:
    post:
      summary: Share Bid
      deprecated: false
      description: >-

        :::highlight purple 📌

        Use this API to submit a bid on the Bharat Connect platform through your
        EnKash account.

        This allows you to participate in financing opportunities by offering
        terms on available invoices or purchase orders, enabling you to compete
        for funding deals and expand your portfolio.

        :::
      tags:
        - Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Financing
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShareBidRequest'
            examples: {}
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  payload:
                    type: string
                  response_code:
                    type: integer
                  response_message:
                    type: string
                required:
                  - payload
                  - response_code
                  - response_message
                x-apidog-orders:
                  - payload
                  - response_code
                  - response_message
                x-apidog-ignore-properties: []
              example:
                payload: SUCCESS
                response_code: 0
                response_message: SUCCESS
          headers: {}
          x-apidog-name: Success
      security: []
      x-apidog-folder: Bharat Connect (BBPS)/APIs - BBPS/Vendor Payment/Financing
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/616243/apis/api-10664770-run
components:
  schemas:
    ShareBidRequest:
      required:
        - bid
      type: object
      properties:
        device:
          $ref: '#/components/schemas/Device'
        bid:
          $ref: '#/components/schemas/Bid'
      x-apidog-orders:
        - device
        - bid
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Bid:
      type: object
      properties:
        faId:
          type: string
        financingRequestId:
          type: string
        financingRequestAmount:
          type: number
        bidDetails:
          type: array
          items:
            $ref: '#/components/schemas/BidDetail'
      x-apidog-orders:
        - faId
        - financingRequestId
        - financingRequestAmount
        - bidDetails
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    BidDetail:
      type: object
      properties:
        bidId:
          type: string
        financierId:
          type: string
        approvedAmount:
          type: number
        bidValue:
          type: number
        invoiceFinDetails:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceFinDetail'
        financeTermDoc:
          type: string
      x-apidog-orders:
        - bidId
        - financierId
        - approvedAmount
        - bidValue
        - invoiceFinDetails
        - financeTermDoc
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    InvoiceFinDetail:
      type: object
      properties:
        objectId:
          type: string
        approvedAmount:
          type: number
        financingRequestAmount:
          type: number
      x-apidog-orders:
        - objectId
        - approvedAmount
        - financingRequestAmount
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Device:
      type: object
      properties:
        tag:
          $ref: '#/components/schemas/Tag'
      x-apidog-orders:
        - tag
      required:
        - tag
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
    Tag:
      type: object
      properties:
        name:
          type: string
          enum:
            - GEOCODE
            - IP
            - AGENTID
        value:
          type: string
          pattern: ^([^\\\"]){1,100}$
      x-apidog-orders:
        - name
        - value
      required:
        - name
        - value
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://ekpayout-uat.enkash.in
    description: Testing Env
security: []

```