openapi: 3.1.0
info:
  title: Adjust API
  version: '2026-10-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-13: 8 operation(s) read from 6 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Adjust has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 7
    documentation: 1
    pages-with-code: 6
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://dev.adjust.com/en/api/device-api
  - https://dev.adjust.com/en/api/rs-api/csv
  - https://dev.adjust.com/en/api/ad-spend-api
  - https://dev.adjust.com/en/api/campaign-api
  - https://dev.adjust.com/en/api/rs-api/pivot
  - https://dev.adjust.com/en/api/blocklist-api
servers:
- url: https://api.adjust.com
paths:
  /cost:
    post:
      operationId: post_cost
      tags:
      - Cost
      summary: POST /cost
      x-source: https://dev.adjust.com/en/api/ad-spend-api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl $ curl -X POST https://app.adjust.com/cost \\ -d \" cost_type =cpi& cost_currency =usd& cost_amount =2& cost_id =abc123_company_name_test_1&\
          \ tag =company_name_test\" \n Responses \n 200 Success \n Ad spend information was submitted to Adjust. \n 400 Bad request \n Your request\
          \ isn’t properly formatted. Make sure to include all required parameters . \n 401 Unauthorized \n Your request couldn’t be proces"
  /dashboard/api/trackers:
    post:
      operationId: post_dashboard_api_trackers
      tags:
      - Dashboard
      summary: POST /dashboard/api/trackers
      x-source: https://dev.adjust.com/en/api/blocklist-api
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDashboardApiTrackersResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl $ curl \\ --header \"Authorization: Token token={api_token}\" \\ -L -X POST \"https://api.adjust.com/dashboard/api/trackers/\
          \ abc123 /blacklist\" \n Success response { \"label\" : \"Twitter installs\" , \"token\" : \"abc123\" , \"name\" : \"Twitter installs\"\
          \ , \"url\" : \"https://app.adjust.com/abc123\" , \"path\" : \"\" , \"has_subtrackers\" : true , \"archived\" : false , \"visible\"\
          \ : true , \"attribution_partner\" : false "
  /dashboard/api/trackers/{linkToken}/blacklist:
    post:
      operationId: post_dashboard_api_trackers_linkToken_blacklist
      tags:
      - Dashboard
      summary: Blocklist API
      description: Blocklist a link to stop recording engagements and callbacks to it.
      x-source: https://dev.adjust.com/en/api/blocklist-api
      parameters:
      - name: linkToken
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostDashboardApiTrackersLinktokenBlacklistResponse'
      x-evidence:
        kind: documentation
  /device_service/api/v1/forget_device:
    post:
      operationId: post_device_service_api_v1_forget_device
      tags:
      - Device Service
      summary: POST /device_service/api/v1/forget_device
      x-source: https://dev.adjust.com/en/api/device-api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl $ curl \\ --header \"Authorization: Token token=ask43jskdp2tg2hg87\" \\ --location --request POST \"https://api.adjust.com/device_service/api/v1/forget_device\"\
          \ \\ --data \"adid= acf8534f2f052395e617a38730682ccc &app_token= gwzpeepw8uf8 \" \n Success response 200 : Forgot device Have a question?\
          \ Get in touch Contact Us About Us Security Privacy Policy Terms & Conditions CCPA & GDPR Legal Notice \n© 2026"
  /device_service/api/v1/inspect_device:
    get:
      operationId: get_device_service_api_v1_inspect_device
      tags:
      - Device Service
      summary: Use the Inspect device endpoint to fetch device and link information relating to an app.
      x-source: https://dev.adjust.com/en/api/device-api
      parameters:
      - name: app_token
        in: query
        required: true
        schema:
          type: string
        description: The alphanumeric token that identifies your app. This MUST be 12 characters long.
      - name: advertising_id
        in: query
        required: true
        schema:
          type: string
        description: The unique advertising ID associated with your device.
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDeviceServiceApiV1InspectDeviceResponse'
      x-evidence:
        kind: documentation
  /device_service/api/v2/inspect_device:
    get:
      operationId: get_device_service_api_v2_inspect_device
      tags:
      - Device Service
      summary: GET /device_service/api/v2/inspect_device
      x-source: https://dev.adjust.com/en/api/device-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetDeviceServiceApiV2InspectDeviceResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl $ curl \ --header "Authorization: Bearer ask43jskdp2tg2hg87" \ -L -X GET "https://api.adjust.com/device_service/api/v2/inspect_device?
          advertising_id=1234-5678-9012-3456 & app_token=gwzpeepw8uf8 " Success response { "Adid" : "acf8534f2f052395e617a38730682ccc" , "AdvertisingId"
          : "1234-5678-9012-3456" , "Tracker" : "abc123" , "TrackerName" : "Organic" , "FirstTracker" : "zr5vueb" , "FirstTrack'
  /public/v2/partners:
    get:
      operationId: get_public_v2_partners
      tags:
      - Public
      summary: GET /public/v2/partners
      x-source: https://dev.adjust.com/en/api/campaign-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPublicV2PartnersResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl $ curl \"https://api.adjust.com/public/v2/partners? cursor=g2wAAAACYhW1_gxkAANuaWxq &limit=50\" To return to a specific\
          \ location in the results, pass a cursor value in your requests query params . \n Response format \n 1 { 2 \"data\" : { 3 \"api_version\"\
          \ : \"string\" , 4 \"request_id\" : \"string\" , 5 \"timestamp\" : \"datetime\" , 6 \"paging\" : { 7 \"next\" : \"string\" , 8 \"cursor\"\
          \ : \"string\" 9 }, 10 \"items\" : "
  /reports-service/{reportsserviceid}:
    get:
      operationId: get_reports_service_reportsserviceid
      tags:
      - Reports Service
      summary: GET /reports-service/csv_report
      x-source: https://dev.adjust.com/en/api/rs-api/csv
      parameters:
      - name: reportsserviceid
        in: path
        required: true
        schema:
          type: string
      - name: ad_spend_mode
        in: query
        required: false
        schema:
          type: string
      - name: app_token__in
        in: query
        required: false
        schema:
          type: string
      - name: date_period
        in: query
        required: false
        schema:
          type: string
      - name: dimensions
        in: query
        required: false
        schema:
          type: string
      - name: metrics
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetReportsServiceReportsserviceidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl $ curl \\ --header 'Authorization: Bearer <adjust_api_token>' \\ --location --request GET 'https://automate.adjust.com/reports-service/csv_report?ad_spend_mode=network&app_token__in={app_token1},{app_token2}&date_period=2021-05-01:2021-05-02&dimensions=app,partner_name,campaign,campaign_id_network,campaign_network&metrics=installs,network_cost'\
          \ ' \\\x7F--location --request GET 'https://automate.adj"
        collapsed_from: 2 example path(s) differing only at reportsserviceId
components:
  schemas:
    PostDashboardApiTrackersResponse:
      type: object
      properties:
        label:
          type: string
        token:
          type: string
        name:
          type: string
        url:
          type: string
        path:
          type: string
        has_subtrackers:
          type: boolean
        archived:
          type: boolean
        visible:
          type: boolean
        attribution_partner:
          type: boolean
        creative_token:
          type:
          - string
          - 'null'
        adgroup_token:
          type:
          - string
          - 'null'
        campaign_token:
          type:
          - string
          - 'null'
        network_token:
          type: string
        click_url:
          type: string
        impression_url:
          type: string
        allow_partner_linking:
          type: boolean
        settings:
          type: object
          properties:
            partner_id:
              type:
              - string
              - 'null'
            partner_display_name:
              type:
              - string
              - 'null'
            tracking_parameters:
              type:
              - string
              - 'null'
            cost_data_parameters:
              type:
              - string
              - 'null'
            cost_data:
              type: boolean
            partner_cost_data_parameters:
              type:
              - string
              - 'null'
            campaign_structure:
              type:
              - string
              - 'null'
            additional_parameters:
              type:
              - string
              - 'null'
            attribution_settings:
              type:
              - string
              - 'null'
            blacklisted:
              type: boolean
        urls:
          type: object
          properties:
            descendants:
              type: string
            ancestors:
              type: string
            update:
              type: string
            show:
              type: string
            archive:
              type: string
            unarchive:
              type: string
    PostDashboardApiTrackersLinktokenBlacklistResponse:
      type: object
      properties:
        label:
          type: string
        token:
          type: string
        name:
          type: string
        url:
          type: string
        path:
          type: string
        has_subtrackers:
          type: boolean
        archived:
          type: boolean
        visible:
          type: boolean
        attribution_partner:
          type: boolean
        creative_token:
          type: string
        adgroup_token:
          type: string
        campaign_token:
          type: string
        network_token:
          type: string
        click_url:
          type: string
        impression_url:
          type: string
        allow_partner_linking:
          type: boolean
        settings:
          type: object
          description: Link settings object.
        urls:
          type: object
          description: Related URLs object.
    GetDeviceServiceApiV1InspectDeviceResponse:
      type: object
      properties:
        Adid:
          type: string
        AdvertisingId:
          type: string
        Tracker:
          type: string
        TrackerName:
          type: string
        ClickTime:
          type: string
        InstallTime:
          type: string
        LastSessionTime:
          type: string
        LastEventTimes:
          type: object
        State:
          type: string
    GetDeviceServiceApiV2InspectDeviceResponse:
      type: object
      properties:
        Adid:
          type: string
        AdvertisingId:
          type: string
        Tracker:
          type: string
        TrackerName:
          type: string
        FirstTracker:
          type: string
        FirstTrackerName:
          type: string
        Environment:
          type: string
        ClickTime:
          type: string
          format: date-time
        InstallTime:
          type: string
          format: date-time
        LastSessionTime:
          type: string
          format: date-time
        LastEventsInfo:
          type: object
          properties:
            kgfcul:
              type: object
              properties:
                name:
                  type: string
                time:
                  type: string
                  format: date-time
            wz9qqz:
              type: object
              properties:
                name:
                  type: string
                time:
                  type: string
                  format: date-time
            z3f773:
              type: object
              properties:
                name:
                  type: string
                time:
                  type: string
                  format: date-time
        LastSdkVersion:
          type: string
        State:
          type: string
    GetPublicV2PartnersResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            api_version:
              type: string
            request_id:
              type: string
            timestamp:
              type: string
              format: date-time
            paging:
              type: object
              properties:
                cursor:
                  type: string
                next:
                  type: string
            items:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: integer
                  display_name:
                    type: string
                  supports_cost_data:
                    type: boolean
    GetReportsServiceReportsserviceidResponse:
      type: object
      properties:
        rows:
          type: array
          items:
            type: object
            properties:
              attr_dependency:
                type: object
                properties:
                  app_network:
                    type: array
                    items:
                      type: string
              campaign_id_network:
                type: string
              campaign_network:
                type: string
              campaign:
                type: string
              partner_name:
                type: string
              installs:
                type: integer
              network_installs:
                type: integer
              network_cost:
                type: integer
              network_ecpi:
                type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Cost
- name: Dashboard
- name: Device Service
- name: Public
- name: Reports Service