Adobe Analytics Server Call Estimate API

openapi: 3.2.0
info:
  title: Adobe Analytics Data Repair Server Call Estimate API
  description: 'The Data Repair API allows you to permanently delete or transform data that has already been ingested in Adobe Analytics. Use cases include deleting personally identifiable information (PII) to comply with privacy regulations and removing corrupted or erroneous data. The API requires a two-step workflow: first estimate the scope and cost using the server call estimate endpoint, then submit a repair job. This is a paid feature.'
  version: '1.0'
  contact:
    name: Adobe Analytics Support
    url: https://developer.adobe.com/analytics-apis/docs/2.0/support/
  termsOfService: https://www.adobe.com/legal/terms.html
  x-last-validated: '2026-04-18'
servers:
- url: https://analytics.adobe.io/api/{globalCompanyId}/datarepair/v1
  description: Adobe Analytics Data Repair API
  variables:
    globalCompanyId:
      description: The global company ID for your Analytics organization
      default: YOUR_GLOBAL_COMPANY_ID
security:
- bearerAuth: []
  apiKey: []
tags:
- name: Server Call Estimate
  description: Estimate the scope and cost of a repair job
paths:
  /{rsid}/serverCallEstimate:
    get:
      operationId: getServerCallEstimate
      summary: Adobe Analytics Get Server Call Estimate
      description: Calculates the number of data rows that would be scanned for a repair job given the specified report suite and date range. This estimate is required before creating a repair job and returns a validationToken that must be passed to the job creation endpoint. The count determines the cost of the repair.
      tags:
      - Server Call Estimate
      parameters:
      - $ref: '#/components/parameters/rsidPath'
      - name: dateRangeStart
        in: query
        required: true
        description: Start of the date range for the repair in ISO 8601 format (YYYY-MM-DD)
        schema:
          type: string
          format: date
        example: '2026-01-15'
      - name: dateRangeEnd
        in: query
        required: true
        description: End of the date range for the repair (inclusive) in ISO 8601 format (YYYY-MM-DD)
        schema:
          type: string
          format: date
        example: '2026-01-15'
      responses:
        '200':
          description: Server call estimate
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServerCallEstimate'
              examples:
                Getservercallestimate200Example:
                  summary: Default getServerCallEstimate 200 response
                  x-microcks-default: true
                  value:
                    reportSuiteId: '500123'
                    dateRangeStart: '2026-01-15'
                    dateRangeEnd: '2026-01-15'
                    serverCallEstimate: 10
                    validationToken: CAUQAA
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getservercallestimate400Example:
                  summary: Default getServerCallEstimate 400 response
                  x-microcks-default: true
                  value:
                    errorCode: example_value
                    errorDescription: example_value
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Getservercallestimate401Example:
                  summary: Default getServerCallEstimate 401 response
                  x-microcks-default: true
                  value:
                    errorCode: example_value
                    errorDescription: example_value
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    rsidPath:
      name: rsid
      in: path
      required: true
      description: The report suite ID
      schema:
        type: string
  schemas:
    ErrorResponse:
      type: object
      description: Error response from the API
      properties:
        errorCode:
          type: string
          description: Machine-readable error code
          example: example_value
        errorDescription:
          type: string
          description: Human-readable error message
          example: example_value
    ServerCallEstimate:
      type: object
      description: Estimate of server calls for a proposed data repair job
      properties:
        reportSuiteId:
          type: string
          description: The report suite ID for the estimate
          example: '500123'
        dateRangeStart:
          type: string
          format: date
          description: Start date of the repair range
          example: '2026-01-15'
        dateRangeEnd:
          type: string
          format: date
          description: End date of the repair range
          example: '2026-01-15'
        serverCallEstimate:
          type: integer
          description: Estimated number of server calls (rows) that will be scanned
          example: 10
        validationToken:
          type: string
          description: Token required when creating the repair job
          example: CAUQAA
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 access token from Adobe IMS
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Adobe Developer Console API key
externalDocs:
  description: Adobe Analytics Data Repair API Documentation
  url: https://developer.adobe.com/analytics-apis/docs/2.0/guides/endpoints/data-repair/