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

# Duplicate subscriptions

> Premium only. Returns groups of non-cancelled subscriptions that share a normalized name, indicating likely duplicate tracking or double billing. Free accounts should use `/api/v1/analytics/summary` for basic spend totals.



## OpenAPI

````yaml /api/openapi.yaml get /api/v1/analytics/duplicates
openapi: 3.1.0
info:
  title: SteadyRenew Public API
  version: 1.0.0
  description: >-
    Public API for cloud subscription CRUD automation through API keys created
    in Settings → API & MCP. Use Copy to Agent in the app for guided setup, or
    read /agent/setup.md on your application origin. A standalone local stdio
    MCP package is available at /downloads/subscription-manager-mcp.tgz on that
    same origin. The operation descriptions include AI-oriented task semantics,
    risk levels, and confirmation guidance for agent integrations.
servers:
  - url: https://your-site.example
    description: Replace with your deployed SteadyRenew site URL.
security:
  - bearerApiKey: []
tags:
  - name: Subscriptions
    description: Create, read, update, and delete subscriptions for the API key owner.
    x-ai:
      domain: subscription_management
      ownerScope: authenticated_api_key_owner
      writeSafety: >-
        Confirm create, update, and delete operations with the user before
        calling them from an AI agent. Write operations require an API key with
        the write scope. Soft cancel/pause/resume via status is not supported.
  - name: Analytics
    description: >-
      Computed spend summaries, duplicate detection, and optimization
      candidates. Read-only; money is reported per currency and never converted.
  - name: Audit
    description: Read-only audit trail of write operations performed through the API.
  - name: Notification settings
    description: >-
      Global reminder settings. Writable fields are limited to enabled and
      daysBefore. Bark URL, test push, timeZone, and locale are web-managed.
paths:
  /api/v1/analytics/duplicates:
    get:
      tags:
        - Analytics
      summary: Duplicate subscriptions
      description: >-
        Premium only. Returns groups of non-cancelled subscriptions that share a
        normalized name, indicating likely duplicate tracking or double billing.
        Free accounts should use `/api/v1/analytics/summary` for basic spend
        totals.
      operationId: findDuplicateSubscriptions
      responses:
        '200':
          description: Duplicate groups returned.
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/XRateLimitLimit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/XRateLimitRemaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/XRateLimitReset'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DuplicatesResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  headers:
    XRateLimitLimit:
      description: Total allowed requests in the current fixed window.
      schema:
        type: integer
        example: 60
    XRateLimitRemaining:
      description: Requests remaining in the current fixed window.
      schema:
        type: integer
        example: 59
    XRateLimitReset:
      description: Unix timestamp in seconds when the fixed window resets.
      schema:
        type: integer
        example: 1781690400
    RetryAfter:
      description: >-
        Seconds to wait before retrying. Sent with 429 responses, including when
        too many invalid API key attempts are throttled.
      schema:
        type: integer
        example: 2700
  schemas:
    DuplicatesResponse:
      type: object
      required:
        - duplicates
        - requestId
      properties:
        duplicates:
          type: array
          items:
            type: object
            properties:
              normalizedName:
                type: string
              subscriptions:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    name:
                      type: string
                    category:
                      type: string
                    amount:
                      type: number
                    currency:
                      type: string
                    period:
                      $ref: '#/components/schemas/SubscriptionPeriod'
                    status:
                      $ref: '#/components/schemas/SubscriptionStatus'
        requestId:
          type: string
      additionalProperties: false
    SubscriptionPeriod:
      type: string
      description: >-
        Billing cadence. Monthly means the same calendar day each month;
        fixed-day intervals use custom.
      enum:
        - monthly
        - yearly
        - custom
    SubscriptionStatus:
      type: string
      description: >-
        Read-only lifecycle state returned on subscription records and accepted
        as a list filter. The public API does not write status.
      enum:
        - active
        - paused
        - cancelled
    ErrorResponse:
      type: object
      required:
        - error
        - requestId
      properties:
        error:
          $ref: '#/components/schemas/Error'
        requestId:
          type: string
      additionalProperties: false
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
        field:
          type: string
          description: Field that caused the error when the server can identify one.
        suggestedFix:
          type: string
          description: Human- and AI-readable correction hint.
        allowedValues:
          type: array
          items:
            type: string
          description: Allowed enum values when the error is caused by an unsupported enum.
        writableFields:
          type: array
          items:
            type: string
          description: >-
            Writable subscription fields when the error is caused by a
            non-writable field.
      additionalProperties: false
  responses:
    Unauthorized:
      description: The API key is missing, invalid, or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalidApiKey:
              value:
                error:
                  code: invalid_api_key
                  message: Invalid API key
                requestId: request-1
    Forbidden:
      description: The API key lacks the scope required for this operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            insufficientScope:
              value:
                error:
                  code: insufficient_scope
                  message: This API key does not have the required 'write' scope
                  suggestedFix: >-
                    Use an API key created with the write scope. Read-only keys
                    can only list and read subscriptions.
                requestId: request-1
    RateLimited:
      description: The user request limit or invalid-auth attempt limit was exceeded.
      headers:
        X-RateLimit-Limit:
          $ref: '#/components/headers/XRateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/XRateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/XRateLimitReset'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            rateLimited:
              value:
                error:
                  code: rate_limit_exceeded
                  message: Rate limit exceeded
                requestId: request-1
            tooManyInvalidKeys:
              value:
                error:
                  code: rate_limit_exceeded
                  message: Too many invalid API key attempts
                requestId: request-1
    InternalError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            internal:
              value:
                error:
                  code: internal_error
                  message: Internal server error
                requestId: request-1
  securitySchemes:
    bearerApiKey:
      type: http
      scheme: bearer
      description: >-
        Developer API key generated in the app. Keys carry scopes; a read key
        can call list, get, notification settings, analytics, and audit
        endpoints, while a write key additionally allows create, update, delete,
        and notification settings updates.
      x-default: subm_your_key_here

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.