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

# List deals

> Returns a paginated list of deals/opportunities for the authenticated organization.

> **Note:** The `amount` field is stored in cents with no decimals. The response includes an `amount_display` object for convenience:
>
> ```json
> "amount": "5522699",
> "amount_display": {
>   "formatted": "$55.23K",   // Human-readable string
>   "value": 55226.99,        // Numeric value in dollars with cents as decimal
>   "currency": "USD",
>   "unit": "cents"           // Unit of the raw amount field
> }
> ```




## OpenAPI

````yaml openapi.json get /v/alpha/deals/list
openapi: 3.1.0
info:
  title: Operate API Documentation
  description: 'API for Operate: A CRM designed for sales, built for founders'
  version: Alpha
servers:
  - url: https://api.operate.so
security:
  - apiKey: []
tags:
  - name: Companies
    description: Manage companies and their associated data
  - name: People
    description: Manage people/contacts and their associated data
  - name: Deals
    description: Manage deals and opportunities
  - name: Feedback
    description: Manage customer feedback and feature requests
  - name: Next Steps
    description: Manage action items and next steps
  - name: Profiles
    description: Manage organization profiles (team members)
paths:
  /v/alpha/deals/list:
    get:
      tags:
        - Deals
      summary: List deals
      description: >
        Returns a paginated list of deals/opportunities for the authenticated
        organization.


        > **Note:** The `amount` field is stored in cents with no decimals. The
        response includes an `amount_display` object for convenience:

        >

        > ```json

        > "amount": "5522699",

        > "amount_display": {

        >   "formatted": "$55.23K",   // Human-readable string

        >   "value": 55226.99,        // Numeric value in dollars with cents as
        decimal

        >   "currency": "USD",

        >   "unit": "cents"           // Unit of the raw amount field

        > }

        > ```
      operationId: getVAlphaDealsList
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            minimum: 1
            maximum: 100
            default: 50
            description: Maximum number of deals to return per page (1-100)
            examples:
              - 10
              - 25
              - 50
            type: number
        - name: offset
          in: query
          required: false
          schema:
            minimum: 0
            default: 0
            description: >-
              Number of deals to skip for pagination. Use with limit to paginate
              through results.
            examples:
              - 0
              - 50
              - 100
            type: number
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain from your Operate dashboard.

````