# Get tender proposals.

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /tenders/{id}/proposals:
    get:
      summary: Get tender proposals.
      deprecated: false
      description: >-
        Retrieve proposals for a specific tender by tender ID. This endpoint
        consumes proposal credits (charged once per tender based on the actual
        number of proposals). If proposal credits are exhausted, returns 403
        error. If tender has no proposals, returns empty array without consuming
        credits.
      tags:
        - Proposals
        - Proposals
      parameters:
        - name: id
          in: path
          description: Tender ID
          required: true
          example: 318641
          schema:
            type: integer
        - name: Authorization
          in: header
          description: ''
          example: Bearer {{api-key}}
          schema:
            type: string
            default: Bearer {{api-key}}
      responses:
        '200':
          description: Successful response with proposal data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  tender_id:
                    type: integer
                    description: The ID of the tender.
                    examples:
                      - 318641
                  proposals:
                    type: array
                    description: List of all proposals for this tender.
                    items:
                      type: object
                      properties:
                        vendor_name:
                          type: string
                          description: Name of the vendor who submitted the proposal.
                          examples:
                            - شركة الأمين للتجهيزات الطبية
                        technical_match:
                          type: boolean
                          description: Whether the proposal meets technical requirements.
                          examples:
                            - true
                        price:
                          type: number
                          description: Proposal price.
                          examples:
                            - 80000
                        formatted_price:
                          type: string
                          description: Human-readable formatted price.
                          examples:
                            - 80 ألف
                        awarding_value:
                          type: number
                          description: Final awarding value.
                          examples:
                            - 80000
                        formatted_awarding_value:
                          type: string
                          description: Human-readable formatted awarding value.
                          examples:
                            - 80 ألف
                        status:
                          type: boolean
                          description: Whether this proposal was awarded.
                          examples:
                            - true
                      x-apidog-orders:
                        - vendor_name
                        - technical_match
                        - price
                        - formatted_price
                        - awarding_value
                        - formatted_awarding_value
                        - status
                  awarded_proposals:
                    type: array
                    description: List of awarded proposals only.
                    items:
                      type: object
                      properties:
                        vendor_name:
                          type: string
                        technical_match:
                          type: boolean
                        price:
                          type: number
                        formatted_price:
                          type: string
                        awarding_value:
                          type: number
                        formatted_awarding_value:
                          type: string
                        status:
                          type: boolean
                      x-apidog-orders:
                        - vendor_name
                        - technical_match
                        - price
                        - formatted_price
                        - awarding_value
                        - formatted_awarding_value
                        - status
                x-apidog-orders:
                  - tender_id
                  - proposals
                  - awarded_proposals
              example:
                tender_id: 318641
                proposals:
                  - vendor_name: شركة الأمين للتجهيزات الطبية
                    technical_match: true
                    price: 80000
                    formatted_price: 80 ألف
                    awarding_value: 80000
                    formatted_awarding_value: 80 ألف
                    status: true
                awarded_proposals:
                  - vendor_name: شركة الأمين للتجهيزات الطبية
                    technical_match: true
                    price: 80000
                    formatted_price: 80 ألف
                    awarding_value: 80000
                    formatted_awarding_value: 80 ألف
                    status: true
          headers: {}
          x-apidog-name: ''
        '401':
          description: Unauthorized. The API key is missing or invalid.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    examples:
                      - Unauthorized
                x-apidog-orders:
                  - error
          headers: {}
          x-apidog-name: ''
        '403':
          description: Proposal credits exhausted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - Proposal credits exhausted for this month
                x-apidog-orders:
                  - message
          headers: {}
          x-apidog-name: ''
        '404':
          description: Tender not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    examples:
                      - Tender not found
                x-apidog-orders:
                  - message
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: Proposals
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/772525/apis/api-31209532-run
components:
  schemas: {}
  securitySchemes:
    Tenders Alerts:
      type: bearer
      scheme: bearer
    hmacSignature:
      type: apikey
      in: header
      name: X-Webhook-Signature
      description: >-
        HMAC SHA256 signature of the request body using your webhook secret.
        Format: sha256=<hash>
servers:
  - url: https://api.tendersalerts.com/api/integration
    description: Prod Env
security: []

```