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

# Report Partner Execution

> Best-effort telemetry only. AKKA does not trust this report as proof of on-chain state.

Report the lifecycle of a transaction built from a partner quote. Submit `SUBMITTED` when it is broadcast, then `CONFIRMED` or `REVERTED` when its final outcome is known.

This endpoint is best-effort telemetry. A `202` response only confirms receipt; AKKA independently treats the chain as the source of truth. Do not include calldata, signatures, API keys, or private user data in `reason`.

Use the `quoteId` returned by the quote endpoint and the transaction hash produced by the wallet or executor. Reports improve per-partner execution monitoring and help identify unhealthy routes or sources.


## OpenAPI

````yaml POST /partner/v1/executions
openapi: 3.0.0
info:
  title: AKKA Finance Backend API
  description: >-
    Use the Partners endpoints for new integrations. Swap endpoints are
    maintained for the AKKA UI and internal compatibility.
  version: 1.0.0
  contact:
    name: AKKA Finance
    url: https://akka.finance
    email: support@akka.finance
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://api.akka.finance
    description: Production
security:
  - api-key: []
tags:
  - name: Partners
    description: >-
      Recommended external integration contract for discovery, executable
      quotes, and outcome reporting.
  - name: Tokens
    description: Token metadata used by partner integrations.
  - name: Health
    description: Service health and readiness.
externalDocs:
  description: AKKA API Documentation
  url: https://docs.akka.finance/
paths:
  /partner/v1/executions:
    post:
      tags:
        - Partners
      summary: Report a partner quote transaction outcome
      description: >-
        Best-effort telemetry only. AKKA does not trust this report as proof of
        on-chain state.
      operationId: PartnerController_reportExecution
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerExecutionReportDto'
      responses:
        '202':
          description: ''
          content:
            application/json:
              schema:
                type: object
                required:
                  - accepted
                properties:
                  accepted:
                    type: boolean
                    example: true
components:
  schemas:
    PartnerExecutionReportDto:
      type: object
      properties:
        quoteId:
          type: string
        chainId:
          type: number
        transactionHash:
          type: string
        status:
          type: string
          enum:
            - SUBMITTED
            - CONFIRMED
            - REVERTED
        reason:
          type: string
      required:
        - quoteId
        - chainId
        - transactionHash
        - status
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: apikey
      description: >-
        API key. basic-test-key is a shared, rate-limited evaluation credential;
        use a dedicated key in production.
      x-default: basic-test-key

````