> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rampartcorporation.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Opportunities

> Retrieve a list of all savings opportunities for the authenticated client.



## OpenAPI

````yaml GET /v2/opportunity
openapi: 3.0.0
info:
  title: Rampart API
  description: Rampart API Documentation
  version: v2
  contact: {}
servers:
  - url: https://api.rampartcorporation.com
security:
  - bearerAuth: []
tags: []
paths:
  /v2/opportunity:
    get:
      tags:
        - Opportunity
      summary: List all opportunities for a client
      description: >-
        Retrieve a list of all savings opportunities for the authenticated
        client.
      operationId: OpportunityController_listOpportunities
      parameters:
        - name: x-client-id
          in: header
          description: Client ID for authentication
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved opportunities summary with aggregated data
          content:
            application/json:
              schema:
                type: object
                properties:
                  spendAnalyzed:
                    type: number
                    description: Total amount of spend analyzed
                    example: 500000
                  savingsFound:
                    type: number
                    description: Total potential savings found
                    example: 75000
                  savingsPercentage:
                    type: number
                    description: Overall savings percentage
                    example: 15
                  opportunities:
                    type: array
                    description: List of individual opportunities
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the opportunity
                          example: 123-456-789
                        category:
                          type: string
                          description: >-
                            Category of the opportunity (e.g., MRO, Office
                            Supplies)
                          example: MRO
                        sourceVendor:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Name of the current vendor
                              example: Fastenal
                            domain:
                              type: string
                              description: Domain of the current vendor
                              example: fastenal.com
                        annualSpend:
                          type: number
                          description: Annual spend amount with the current vendor
                          example: 132196
                        targetVendor:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Name of the recommended vendor
                              example: Grainger
                            domain:
                              type: string
                              description: Domain of the recommended vendor
                              example: grainger.com
                        annualSavings:
                          type: object
                          properties:
                            amount:
                              type: number
                              description: Annual savings amount in dollars
                              example: 19168
                            percentage:
                              type: number
                              description: Percentage of savings
                              example: 14.5
                        createdAt:
                          type: string
                          format: date-time
                          description: When the opportunity was created
                          example: '2024-01-15T10:30:00Z'
                        updatedAt:
                          type: string
                          format: date-time
                          description: When the opportunity was last updated
                          example: '2024-01-15T10:30:00Z'
components:
  securitySchemes:
    bearerAuth:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Bearer authentication header of the form `Bearer <API_KEY>`.

````