openapi: 3.2.0
info:
  title: Impact Radius Action Inquiries API
  version: '1.0'
  description: 'Operations tagged Action Inquiries across 2 of this provider''s published API definitions: impact-radius-brand-actioninquiries-v14.yml, impact-radius-partner-actioninquiries-v15.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.impact.com
tags:
- name: Action Inquiries
paths:
  /Advertisers/{AccountSID}/ActionInquiries:
    get:
      summary: List All Action Inquiries
      description: Returns a list of the action inquiries made for your campaign, filtered by the provided parameters. The inquiries are returned by creation date, with the most recent appearing first.
      operationId: listActionInquiries
      tags:
      - Action Inquiries
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: CampaignId
        in: query
        required: true
        description: The ID of the campaign (program) to view action inquiries for.
        schema:
          type: integer
      - name: StartDate
        in: query
        description: Filters for inquiries created on or after this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: EndDate
        in: query
        description: Filters for inquiries created on or before this date (ISO 8601).
        schema:
          type: string
          format: date-time
      - name: TransactionDateStart
        in: query
        description: Filters for inquiries with a transaction date on or after this value.
        schema:
          type: string
          format: date-time
      - name: TransactionDateEnd
        in: query
        description: Filters for inquiries with a transaction date on or before this value.
        schema:
          type: string
          format: date-time
      - name: MediaPartnerId
        in: query
        description: Filters inquiries to a specific partner by their ID.
        schema:
          type: integer
      - name: OrderId
        in: query
        description: Filters for inquiries associated with a specific order ID.
        schema:
          type: string
      - name: ResolutionStatus
        in: query
        description: Filters inquiries by their resolution status.
        schema:
          type: string
          enum:
          - UNRESOLVED
          - VALID
          - DECLINED
          - INCOMPLETE
      responses:
        '200':
          description: A paginated list of action inquiry objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  '@page':
                    type: string
                  ActionInquiries:
                    type: array
                    items:
                      $ref: '#/components/schemas/ActionInquiry'
    put:
      summary: Update an Action Inquiry
      description: Updates an action inquiry by setting its resolution status and other related parameters.
      operationId: updateActionInquiry
      tags:
      - Action Inquiries
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      requestBody:
        description: The details for resolving the action inquiry.
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/ActionInquiryUpdateRequest'
      responses:
        '200':
          description: The request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: OK
                  Uri:
                    type: string
                    format: uri-reference
                    example: /Advertisers/<AccountSid>/ActionInquiries/782287
    servers:
    - url: https://api.impact.com
  /Advertisers/{AccountSID}/ActionInquiries/{InquiryId}:
    get:
      summary: Get Action Inquiry Details
      description: Retrieves the details of an existing action inquiry by its unique ID.
      operationId: getActionInquiryById
      tags:
      - Action Inquiries
      parameters:
      - name: AccountSID
        in: path
        required: true
        schema:
          type: string
      - name: InquiryId
        in: path
        required: true
        description: The unique identifier for the action inquiry.
        schema:
          type: integer
      responses:
        '200':
          description: An action inquiry object.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionInquiry'
    servers:
    - url: https://api.impact.com
  /Mediapartners/{AccountSID}/ActionInquiries:
    get:
      operationId: listActionInquiries
      tags:
      - Action Inquiries
      summary: List Action Inquiries
      description: Returns a list of the action inquiries made for your campaign, ordered by creation date (newest first).
      parameters:
      - $ref: '#/components/parameters/AccountSID'
      - name: CampaignId
        in: query
        required: false
        schema:
          type: integer
        description: View action inquiries for a specified campaign.
      - name: MediaPartnerInquiryId
        in: query
        required: false
        schema:
          type: string
        description: Filter by your own internal reference ID for the inquiry.
      - name: CustomerId
        in: query
        required: false
        schema:
          type: string
        description: Filter by the customer identifier associated with the transaction.
      - name: ResolutionStatus
        in: query
        required: false
        schema:
          $ref: '#/components/schemas/ResolutionStatus'
        description: Filter by the current resolution status of the inquiry.
      - name: StartDate
        in: query
        required: false
        schema:
          type: string
          format: date-time
        description: Filters inquiries with a CreationDate on or after this value.
      - name: EndDate
        in: query
        required: false
        schema:
          type: string
          format: date-time
        description: Filters inquiries with a CreationDate on or before this value.
      - name: TransactionDateStart
        in: query
        required: false
        schema:
          type: string
          format: date-time
        description: Filters inquiries with a TransactionDate on or after this value.
      - name: TransactionDateEnd
        in: query
        required: false
        schema:
          type: string
          format: date-time
        description: Filters inquiries with a TransactionDate on or before this value.
      responses:
        '200':
          description: An array of action inquiry objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ActionInquiries:
                    type: array
                    items:
                      $ref: '#/components/schemas/ActionInquiry_2'
    post:
      operationId: createActionInquiry
      tags:
      - Action Inquiries
      summary: Create Action Inquiry
      description: Creates an action inquiry by setting the values of the required parameters.
      parameters:
      - $ref: '#/components/parameters/AccountSID'
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              required:
              - CampaignId
              - OrderId
              - TransactionDate
              - TransactionAmount
              - InquiryType
              properties:
                CampaignId:
                  type: integer
                  description: The unique identifier for the campaign associated with the inquiry.
                OrderId:
                  type: string
                  description: The order identifier for the transaction being disputed.
                TransactionDate:
                  type: string
                  format: date-time
                  description: The date and time of the transaction being disputed.
                TransactionAmount:
                  type: number
                  format: decimal
                  description: The value of the transaction being disputed.
                InquiryType:
                  $ref: '#/components/schemas/InquiryType'
                MediaPartnerInquiryId:
                  type: string
                  description: Your own internal reference ID for the inquiry.
                ResolutionDeadlineDate:
                  type: string
                  format: date-time
                  description: The deadline by which the inquiry must be resolved.
                ExpectedPayout:
                  type: number
                  format: decimal
                  description: The commission amount you expect to receive if the inquiry is approved.
                TrackingLink:
                  type: string
                  description: The tracking link associated with the transaction, if applicable.
                CustomerId:
                  type: string
                  description: A unique identifier for the customer associated with the transaction.
                InquiryDate:
                  type: string
                  format: date-time
                  description: The date and time the transaction was originally submitted.
                InquiryNotes:
                  type: string
                  description: Additional notes or context to support the inquiry.
      responses:
        '200':
          description: Action inquiry created successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  Status:
                    type: string
                    example: OK
                  Uri:
                    type: string
                    example: /Mediapartners/<AccountSID>/ActionInquiries/15652378
    servers:
    - url: https://api.impact.com
  /Mediapartners/{AccountSID}/ActionInquiries/{InquiryId}:
    get:
      operationId: retrieveActionInquiry
      tags:
      - Action Inquiries
      summary: Retrieve an Action Inquiry
      description: Retrieves the details of an existing action inquiry using its unique InquiryId.
      parameters:
      - $ref: '#/components/parameters/AccountSID'
      - name: InquiryId
        in: path
        required: true
        schema:
          type: string
        description: The unique identifier for the action inquiry.
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionInquiry_2'
    servers:
    - url: https://api.impact.com
components:
  schemas:
    ActionInquiryUpdateRequest:
      type: object
      required:
      - Id
      - ResolutionStatus
      properties:
        Id:
          type: integer
          description: Unique identifier for the action inquiry to update.
          example: 778987
        ResolutionStatus:
          type: string
          description: The new resolution status for the inquiry.
          enum:
          - VALID
          - DECLINED
          - INCOMPLETE
          example: VALID
        RejectReason:
          type: string
          description: Required if ResolutionStatus is 'DECLINED'.
          enum:
          - This transaction has been tracked successfully
          - Another marketing channel was credited with the sale
          - Another marketing channel was credited with the sale, due to a voucher/discount code used
          - Did not meet terms and conditions set by merchant
          - Transaction not completed - Order cancelled, changed, or returned
          - Transaction cannot be traced
          - Transaction not fully completed online
          - Enquiry does not provide complete information required for evaluation
          - Other
          example: Enquiry does not provide complete information required for evaluation
        ActionTrackerId:
          type: integer
          description: Required if ResolutionStatus is 'VALID'. Unique ID for the event type.
          example: 4000
        ResolutionNotes:
          type: string
          description: Optional notes about the resolution for the partner to see.
          example: Customer confirmed delivery; approved.
        TransactionAmount:
          type: number
          format: decimal
          description: Overrides the transaction amount provided by the partner.
          example: 14.0
        FinalPayout:
          type: number
          format: decimal
          description: Manually sets the final payout, overriding system calculations.
          example: 0.28
        TransactionDate:
          type: string
          format: date-time
          description: Specifies a new transaction date.
          example: '2026-09-10T00:00:00-07:00'
        ItemSku[i]:
          type: string
          description: Indexed parameter for item SKU (e.g., ItemSku1, ItemSku2).
        ItemCategory[i]:
          type: string
          description: Indexed parameter for item category.
        ItemName[i]:
          type: string
          description: For a VALID action inquiry, specifies the name of the item. This information can also be automatically appended through uploading a product catalog. impact.com highly recommends submitting this parameter when approving action inquiries to maintain accurate records & reporting.
          example: Acme Tennis Balls (One Dozen)
        ItemSubCategory[i]:
          type: string
          description: The sub-category for the item.
          example: Tennis
        ItemMPN[i]:
          type: string
          description: Manufacturer Part Number for the item; primarily used for retail sales.
          example: ACME-MPN-101
        ItemTotalRebate[i]:
          type: number
          format: decimal
          description: Discount applied to this line item (not just for each product of this type).
          example: 5.0
        ItemQty[i]:
          type: integer
          description: Indexed parameter for item quantity.
        ItemSubtotal[i]:
          type: number
          format: decimal
          description: Indexed parameter for item subtotal.
        PromoCode:
          type: string
          description: Specifies the promo code used.
          example: 10OFF-FORGE
        CustomerId:
          type: string
          description: Your unique, non-PII customer identifier.
          example: BCZ2WVSH674563PDPYOTM3AXDQ
    ActionInquiry:
      type: object
      properties:
        Id:
          type: integer
          description: Unique identifier for the action inquiry.
          example: '778987'
        CampaignId:
          type: integer
          description: Unique identifier for the associated campaign.
          example: '1000'
        CampaignName:
          type: string
          example: Acme Campaign
        MediaPartnerId:
          type: integer
          description: Unique identifier for the partner who created the inquiry.
          example: '10000'
        MediaPartnerName:
          type: string
          example: Acme Partner
        OrderId:
          type: string
          description: Your unique identifier for the consumer order.
          example: '9234918172372'
        TransactionDate:
          type: string
          format: date-time
          example: '2020-09-10T00:00:00-07:00'
        TransactionAmount:
          type: number
          format: decimal
          example: '14.00'
        InquiryType:
          type: string
          enum:
          - UNTRACKED
          - INCORRECT
          - DECLINED
          example: UNTRACKED
        ExpectedPayout:
          type: number
          format: decimal
          example: '3.00'
        ResolutionDeadlineDate:
          type: string
          format: date-time
          example: '2020-09-18T00:00:00-07:00'
        Comments:
          type: array
          items:
            type: object
            properties:
              User:
                type: string
              Comment:
                type: string
              Date:
                type: string
                format: date-time
        TrackingLink:
          type: string
          format: uri
          example: ''
        ActionId:
          type: string
          example: 1017.4635.1023507
        ActionUri:
          type: string
          format: uri-reference
          example: /Advertisers/<AccountSid>/Actions/1000.4635.1023507
        AutoApprovalDate:
          type: string
          format: date-time
          example: '2020-09-11T13:41:52-07:00'
        ResolutionStatus:
          type: string
          enum:
          - UNRESOLVED
          - VALID
          - DECLINED
          - INCOMPLETE
          example: VALID
          description: Only returns action inquiries that match the specified resolution status.
        RejectReason:
          type: string
          nullable: true
          enum:
          - This transaction has been tracked successfully
          - Another marketing channel was credited with the sale
          - Another marketing channel was credited with the sale, due to a voucher/discount code used
          - Did not meet terms and conditions set by merchant
          - Transaction not completed - Order cancelled, changed, or returned
          - Transaction cannot be traced
          - Transaction not fully completed online
          - Enquiry does not provide complete information required for evaluation
          - Other
          example: ''
        FinalPayout:
          type: number
          format: decimal
          nullable: true
          example: '0.28'
        ResolutionDate:
          type: string
          format: date-time
          nullable: true
          example: '2020-09-11T13:41:57-07:00'
        CreationDate:
          type: string
          format: date-time
          example: '2020-09-11T13:41:52-07:00'
        Uri:
          type: string
          format: uri-reference
          example: /Advertisers/<AccountSid>/ActionInquiries/778987
    RejectReason:
      type: string
      description: The reason provided by the brand for declining the inquiry.
      enum:
      - This transaction has been tracked successfully
      - Another marketing channel was credited with the sale
      - Another marketing channel was credited with the sale, due to a voucher/discount code used
      - Did not meet terms and conditions set by merchant
      - Transaction not completed - Order cancelled, changed, or returned
      - Transaction cannot be traced
      - Transaction not fully completed online
      - Enquiry does not provide complete information required for evaluation
      - Other
    InquiryType:
      type: string
      description: The type of inquiry being raised.
      enum:
      - UNTRACKED
      - INCORRECT
      - DECLINED
    ActionInquiry_2:
      type: object
      properties:
        Id:
          type: integer
          description: Unique identifier for the action inquiry.
          example: '15652378'
        MediaPartnerInquiryId:
          type: string
          description: Your own internal reference ID for the inquiry, submitted at creation.
          example: ''
        CampaignId:
          type: integer
          description: Unique identifier for the campaign associated with the inquiry.
          example: '10306'
        CampaignName:
          type: string
          description: Display name of the campaign associated with the inquiry.
          example: Wayne Enterprises
        OrderId:
          type: string
          description: The order identifier for the transaction being disputed.
          example: TEST-ORDER-001
        TransactionDate:
          type: string
          format: date-time
          description: The date and time of the transaction being disputed.
          example: '2025-05-01T10:00:00-07:00'
        TransactionAmount:
          type: number
          format: decimal
          description: The value of the transaction being disputed.
          example: '49.99'
        CustomerId:
          type: string
          description: A unique identifier for the customer associated with the transaction.
          example: ''
        InquiryDate:
          type: string
          format: date-time
          description: The date and time the transaction was originally submitted.
          example: ''
        InquiryType:
          $ref: '#/components/schemas/InquiryType'
          description: The type of inquiry being raised.
        ExpectedPayout:
          type: number
          format: decimal
          description: The commission amount you expect to receive if the inquiry is approved.
          example: ''
        ResolutionDeadlineDate:
          type: string
          format: date-time
          description: The deadline by which the inquiry must be resolved.
          example: ''
        Comments:
          type: array
          description: A list of comments associated with the inquiry, including any InquiryNotes submitted at creation.
          items:
            $ref: '#/components/schemas/Comment'
        InquiryNotes:
          type: string
          description: Additional notes or context submitted with the inquiry.
          example: ''
        TrackingLink:
          type: string
          description: The tracking link associated with the transaction, if applicable.
          example: ''
        ActionId:
          type: string
          description: The unique identifier of the action associated with the inquiry, if one was found.
          example: '8882.4335'
        ActionUri:
          type: string
          description: The API resource path for the associated action.
          example: /Mediapartners/<AccountSID>/Actions/8882.4335
        AutoApprovalDate:
          type: string
          format: date-time
          description: The date and time the inquiry will be automatically approved if not manually reviewed.
          example: ''
        ResolutionStatus:
          $ref: '#/components/schemas/ResolutionStatus'
          description: The current resolution status of the inquiry.
        RejectReason:
          $ref: '#/components/schemas/RejectReason'
          description: The reason the inquiry was declined. Only populated when ResolutionStatus is DECLINED.
        FinalPayout:
          type: number
          format: decimal
          description: The final commission amount paid out following resolution of the inquiry.
          example: ''
        ResolutionDate:
          type: string
          format: date-time
          description: The date and time the inquiry was resolved.
          example: ''
        CreationDate:
          type: string
          format: date-time
          description: The date and time the inquiry was created.
          example: '2026-05-25T11:35:38-07:00'
        Uri:
          type: string
          description: Unique reference to the action inquiry object in the impact.com API.
          example: /Mediapartners/<AccountSID>/ActionInquiries/15652378
    ResolutionStatus:
      type: string
      description: The current resolution status of the inquiry.
      enum:
      - UNRESOLVED
      - VALID
      - DECLINED
      - INCOMPLETE
    Comment:
      type: object
      properties:
        User:
          type: string
          description: The name or identifier of the user who posted the comment.
          example: Carrie Oakey
        Comment:
          type: string
          description: The content of the comment.
          example: Please approve!
        Date:
          type: string
          format: date-time
          description: The date and time the comment was posted.
          example: '2026-05-25T11:35:38-07:00'
  parameters:
    AccountSID:
      name: AccountSID
      in: path
      required: true
      schema:
        type: string
      description: Unique identifier for the account.
x-refined-from:
- impact-radius-brand-actioninquiries-v14.yml
- impact-radius-partner-actioninquiries-v15.yml