Monetate
Monetate Metadata API

Read-only API returning metadata about a Monetate account so that experience, page-event and custom-target identifiers seen in engine responses and analytics exports can be resolved to human-interpretable names. Covers accounts, experiences (variants), experience summaries, page events and custom targets.
Documentation GitHub OpenAPI
OpenAPI Specification

openapi: 3.0.1
info:
  title: Monetate Metadata API
  description: The Monetate Metadata API allows you fetch metadata about your Monetate
    account.
  version: v1
servers:
- url: https://api.monetate.net/api/metadata/v1/{retailerShortname}/production
security:
- TokenAuthentication: []
tags:
- name: Metadata
  description: Metadata related endpoints.
paths:
  /metadata/customtarget:
    get:
      tags:
      - Metadata
      summary: List Custom Targets
      description: Return a list of custom targets.
      parameters:
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A list of CustomTarget definitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomTargetListResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/customtarget/{customtarget-id}:
    get:
      tags:
      - Metadata
      summary: Get Custom Target Details
      description: Returns detailed information about a single custom target.
      parameters:
      - name: customtarget-id
        in: path
        description: The identifier of a custom target.
        required: true
        schema:
          type: integer
      responses:
        "200":
          description: A single CustomTarget definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomTargetResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/pageevent:
    get:
      tags:
      - Metadata
      summary: List Page Events
      description: Return a list of page events.
      parameters:
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A list of PageEvent definitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageEventListResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/pageevent/{pageevent-id}:
    get:
      tags:
      - Metadata
      summary: Get Page Event Details
      description: Returns detailed information about a single page event.
      parameters:
      - name: pageevent-id
        in: path
        description: The identifier of a page event.
        required: true
        schema:
          type: integer
      responses:
        "200":
          description: A single PageEvent definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageEventResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/variant:
    get:
      tags:
      - Metadata
      summary: List Experience Details
      description: Return a list of experience details.
      parameters:
      - name: name
        in: query
        description: "Case-insensitive query for the experience name. If the experience\
          \ name contains the query value, it will be returned."
        schema:
          type: string
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A list of Experience definitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VariantListResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/variant/{variant-id}:
    get:
      tags:
      - Metadata
      summary: Get Experience Details
      description: Returns detailed information about a single experience.
      parameters:
      - name: variant-id
        in: path
        description: The identifier of a variant.
        required: true
        schema:
          type: integer
      - name: name
        in: query
        description: "Case-insensitive query for the experience name. If the experience\
          \ name contains the query value, it will be returned."
        schema:
          type: string
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A single Experience definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VariantResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/experience-summary:
    get:
      tags:
      - Metadata
      summary: List Experience Summaries
      description: Returns a list of Experience summaries.
      parameters:
      - name: name
        in: query
        description: "Case-insensitive query for the experience name. If the experience\
          \ name contains the query value, it will be returned."
        schema:
          type: string
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A list of Experience summaries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Experience-SummaryListResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/experience-summary/{experience-summary-id}:
    get:
      tags:
      - Metadata
      summary: Get Experience Summary Details
      description: Returns detailed summary information about a single experience.
      parameters:
      - name: experience-summary-id
        in: path
        description: The identifier of a experience.
        required: true
        schema:
          type: integer
      - name: name
        in: query
        description: "Case-insensitive query for the experience name. If the experience\
          \ name contains the query value, it will be returned."
        schema:
          type: string
      - name: page_size
        in: query
        description: "The number of items per response page. The default is 10, and\
          \ the maximum is 1000; higher values will be clamped to the maximum."
        schema:
          type: integer
      responses:
        "200":
          description: A single Experience summary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Experience-SummaryResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/account:
    get:
      tags:
      - Metadata
      summary: List Accounts
      description: Return a list of accounts.
      responses:
        "200":
          description: A list of account definitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountListResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
  /metadata/account/{account-id}:
    get:
      tags:
      - Metadata
      summary: Get Account
      description: Returns information about a single account.
      parameters:
      - name: account-id
        in: path
        description: The identifier of a account.
        required: true
        schema:
          type: integer
      responses:
        "200":
          description: A single account definition.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountResponse'
        "401":
          description: "Unauthorized. \n\nThe request did not include a token, or\
            \ the token provided was invalid. Please ensure that your token is correct\
            \ and that the Authorization header is properly formatted."
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "403":
          description: |-
            Forbidden.

            The request included a token that has been revoked. Please contact your account administrator to generate a new token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "404":
          description: |-
            Not found.

            The resource you are trying to fetch does not exist, or has been deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
        "500":
          description: |-
            Unknown error.

            Please try again or contact your account manager for more information.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
components:
  schemas:
    ResponseMeta:
      required:
      - code
      type: object
      properties:
        code:
          type: integer
          description: The http response code for this response.
          example: 200
        warnings:
          type: array
          description: A list of warnings associated with this response.
          example: []
          items:
            type: object
            additionalProperties: true
        errors:
          type: array
          description: A list of errors associated with this response.
          example: []
          items:
            type: object
            additionalProperties: true
    ResponsePagination:
      type: object
      properties:
        count:
          type: integer
          description: The number of items returned in this response.
          example: 1
        next:
          type: string
          description: "A URL to the next group of items, if any."
        previous:
          type: string
          description: "A URL to the previous group of items, if any."
    ResponseMetaPagination:
      allOf:
      - $ref: '#/components/schemas/ResponseMeta'
      - $ref: '#/components/schemas/ResponsePagination'
    ResponseAnyData:
      type: object
      additionalProperties: true
    Response:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        data:
          $ref: '#/components/schemas/ResponseAnyData'
    CustomTarget:
      type: object
      properties:
        id:
          type: integer
          description: Monetate internal identifier for custom targets.
          readOnly: true
        title:
          type: string
          description: The title of the custom target.
          readOnly: true
        description:
          type: string
          description: The description of the custom target.
          readOnly: true
        is_identifier:
          type: boolean
          description: Whether the custom target collects an identifier.
          readOnly: true
        collects_person_id:
          type: boolean
          description: Whether the custom target collects your retailer person id.
          readOnly: true
      description: Representation of a Custom Target object.
      example:
        id: 132
        title: Example CustomTarget Title
        is_identifier: true
        collects_person_id: true
    CustomTargetListResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMetaPagination'
        data:
          type: array
          description: Data payload of this response.
          items:
            $ref: '#/components/schemas/CustomTarget'
    CustomTargetResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        data:
          $ref: '#/components/schemas/CustomTarget'
    PageEvent:
      type: object
      properties:
        id:
          type: integer
          description: Monetate internal identifier for page events.
          readOnly: true
        title:
          type: string
          description: The title of the page event.
          readOnly: true
      description: Representation of a Page Event object.
      example:
        id: 132
        title: Example PageEvent Title
    PageEventListResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMetaPagination'
        data:
          type: array
          description: Data payload of this response.
          items:
            $ref: '#/components/schemas/PageEvent'
    PageEventResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        data:
          $ref: '#/components/schemas/PageEvent'
    Variant:
      type: object
      properties:
        id:
          type: integer
          description: Monetate internal identifier for experiences.
          readOnly: true
        account_domain:
          type: string
          description: The account domain the experience is associated with.
          readOnly: true
        experience_id:
          type: integer
          description: The Monetate internal identifier for the experience.
          readOnly: true
        experience_name:
          type: string
          description: The name of the experience.
          readOnly: true
        experience_type:
          type: string
          description: The split name associated with the offer for this experience.
          readOnly: true
        split_name:
          type: string
          description: The split name associated with the offer for this experience.
          readOnly: true
        split_description:
          type: string
          description: The description or label for a specific split defined in this
            experience.
          readOnly: true
        preview_token:
          type: string
          description: The preview token associated with the split.
          readOnly: true
        integration_type:
          type: string
          description: "Experience type either client-side, email or engine-api."
          readOnly: true
          enum:
          - js-tag
          - engine-api
          - email
      description: Representation of an Experience object.
      example:
        id: 123456
        account_domain: website.com
        experience_id: 1234567
        experience_name: example experience name
        experience_type: experience
        split_name: A
        preview_token: 6.3.eJwdy1EKgCAQBNC7zPd-uGS5dJkIExFEQ7KC6O5pXzNvYB6s1uaajiVsmM1omGB976xYy6Abf7EoYUNw994kkxE9aBkJvvSBkFtgL-4M7gKh9FeqMb4fXNsb8g.oiGd_WLhGvI77LIltXYJlBnRJ7qGrmNWDz5Zx0wsPFM
        integration_type: js-tag
    VariantListResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMetaPagination'
        data:
          type: array
          description: Data payload of this response.
          items:
            $ref: '#/components/schemas/Variant'
    VariantResponse:
      required:
      - data
      - meta
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/ResponseMeta'
        data:
          $ref: '#/components/schemas/Variant'
    Experience-Summary:
      type: object
      properties:
        id:
          type: integer
          description: Monetate internal identifier for experiences.
          readOnly: true
        account_domain:
          type: string
          description: The account domain the experience is associated with.
          readOnly: true
        experience_name:
          type: string
          description: The name of the experience.
          readOnly: true
        experience_type:
          type: string
          description: The type of experience.
          readOnly: true
        archived:
          type: boolean
          description: A boolean value of whether the experience is archived or not.
          readOnly: true
        create_time:
          type: string
          description: The creation time of the experience.
          readOnly: true
        start_time:
          type: string
          description: The time what which the experience was activated or scheduled
            to be activated.
          readOnly: true
        end_time:
          type: string
          description: The time what which the experience ended or scheduled to end.
          readOnly: true
        status:
          type: string
          description: "The current status of the experience. Options include \"active\"\
            , \"draft\", \"paused\", \"scheduled\", \"ended\"."
          readOnly: true
        splits:
          type: array
          description: A list of split IDs which are part of the experience.
          readOnly: true
          items:
            type: integer
        tags:
          type: array
          description: A list of the tags that have been given to the experience.
          readOnly: true
          items:
            type: string
        goals:
          type: array
          description: A list of goals that have been given to the experience.
          readOnly: true
          items:
            required:
            - description
            - key
            - name
            type: object
            properties:
              key:
                type: string
                description: The unique key for the goal
                enum:
                - ag_customer_session_count_1d
                - ag_customer_session_count_30d
                - ag_customer_session_count_7d
                - ag_session_count_1d
                - ag_session_count_30d
                - ag_session_count_7d
                - ag_unique_customer_mids_1d
                - ag_unique_customer_mids_30d
                - ag_unique_customer_mids_7d
                - ag_unique_customers_1d
                - ag_unique_customers_30d
                - ag_unique_customers_7d
                - ag_unique_mids_1d
                - ag_unique_mids_30d
                - ag_unique_mids_7d
                - avg_page_views
                - avg_time_on_site
                - bounce_rate
                - buyers
                - buyfreq
                - cartabandon
                - control_group
                - control_totalsales
                - conversion
                - customer_conversion_30d
                - customer_conversion_7d
                - customer_revenue_30d
                - customer_revenue_7d
                - customer_session_count_30d
                - customer_session_count_7d
                - email_ctr
                - experiment_group
                - experiment_totalsales
                - newcustomer
                - order_contribution
                - ordervalue
                - realordervalue
                - session_contribution
                - session_count_30d
                - session_count_7d
                - session_value
                - total_visitors
                - totalsales
                - unique_conversion
                - unique_customer_count_daily
                - unique_customer_mids_30d
                - unique_customer_mids_7d
                - unique_customer_mids_daily
                - unique_customer_sessions_daily
                - unique_customers_30d
                - unique_customers_7d
                - unique_mids_30d
                - unique_mids_7d
                - units_per_transaction
                - url_event
                - visitfreq
                - ^page_event_\d+$
                - ^action_event_\d +$
              name:
                type: string
                description: The short description of the goal
              description:
                type: string
                description: The long description of the goal
            description: A list of goals that have been given to the experience.
        variant_splits:
          type: array
          description: Variant attributes and their percentage splits
          readOnly: true
          items:
            required:
            - id
            - split
            - variant
            type: object
            properties:
              id:
                type: integer
                description: Id of the variant. This matches one item in the splits
                  list
              variant:
                pattern: "^(?:[A-Z]+|Experiment|Control)$"
                type: string
                description: "Name of the variant. Conforms to ^(?:[A-Z]+|Experiment|Control)$\
                  \ where Experiment is used when there is only one variant running\
                  \ and Control is used for the control splits"
              split:
                type: number
                description: Ratio for the split. Sum of all ratios for variants and
                  the control = 1
              label:
                type: boolean
                description: Label given to the variant. Empty if not assigned
              is_control:
                type: string
                description: Indicates that this is the control group split
              allocations:
                type:

# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/monetate/refs/heads/main/openapi/monetate-metadata-api-openapi.yml
Monetate Metadata API

Documentation

Specifications

Other Resources

OpenAPI Specification
