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

# Get Marketplace Advertiser

Retrieve a single marketplace advertiser (demand partner) by their ID. Returns the full partner profile including status, description, and available connection details.


## OpenAPI

````yaml openapi/marketplace-demand-partners.yaml get /partners/marketplace/demands/{demandId}
openapi: 3.0.3
info:
  title: Everflow Marketplace API - Marketplace Advertisers
  description: >
    Marketplace advertiser (demand partner) endpoints for the Everflow
    marketplace partner API. Retrieve information about marketplace advertisers
    available in the Everflow marketplace.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Marketplace Advertisers
    description: Endpoints for retrieving marketplace advertiser information.
paths:
  /partners/marketplace/demands/{demandId}:
    get:
      tags:
        - Marketplace Advertisers
      summary: Get Marketplace Advertiser
      parameters:
        - in: path
          name: demandId
          required: true
          schema:
            type: integer
          description: The unique demand partner ID.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DemandPartner'
        '404':
          description: Demand partner not found.
      security:
        - API Key: []
components:
  schemas:
    DemandPartner:
      type: object
      description: A marketplace demand partner profile.
      properties:
        everxchange_demand_partner_id:
          type: integer
          description: Unique demand partner ID.
        network_id:
          type: integer
          description: Network ID.
        company_name:
          type: string
          description: Demand partner name.
        status:
          type: string
          description: Current status of the demand partner (e.g. active, inactive).
        public_description:
          type: string
          description: Description of the demand partner and their offerings.
        logo_url:
          type: string
          description: URL to the demand partner's logo.
        logo_asset_id:
          type: integer
          description: Logo asset ID.
        website_url:
          type: string
          description: Demand partner's website URL.
        link:
          type: string
          description: Custom link URL.
        custom_link_label:
          type: string
          description: Custom link label.
        is_internal:
          type: boolean
          description: Whether this is an internal demand partner.
        has_migrated_categories:
          type: boolean
          description: >-
            Whether the demand partner has migrated to the new marketplace
            categories model.
        is_contact_info_public:
          type: boolean
          description: Whether contact info is public.
        default_network_offer_id:
          type: integer
          description: Default offer ID.
        facebook_contact_url:
          type: string
          description: Facebook contact URL.
        instagram_contact_url:
          type: string
          description: Instagram contact URL.
        linkedin_contact_url:
          type: string
          description: LinkedIn contact URL.
        twitter_contact_url:
          type: string
          description: Twitter contact URL.
        tiktok_contact_url:
          type: string
          description: TikTok contact URL.
        youtube_contact_url:
          type: string
          description: YouTube contact URL.
        time_created:
          type: integer
          example: 1734455015
          description: Unix timestamp of when the demand partner was created.
        time_saved:
          type: integer
          example: 1734455015
          description: Unix timestamp of last update.
        relationship:
          type: object
          description: Related objects for the demand partner.
          properties:
            connection:
              type: object
              description: >-
                Connection details between the partner and the demand partner.
                Only present when a connection exists.
            invitation:
              type: object
              description: Invitation details. Only present when an invitation exists.
            is_featured:
              type: boolean
              description: Whether this demand partner is featured.
            main_platform_id:
              type: integer
              description: Main platform ID for the demand partner.
            time_connected:
              type: integer
              example: 1734455015
              description: >-
                Unix timestamp of when the connection was established. 0 if not
                connected.
            contact:
              type: object
              description: Contact information.
              properties:
                first_name:
                  type: string
                  description: Contact first name.
                last_name:
                  type: string
                  description: Contact last name.
                phone_number:
                  type: string
                  description: Contact phone number.
                email:
                  type: string
                  description: Contact email address.
            resource_asset:
              type: object
              description: Resource asset information.
              properties:
                customer_asset_id:
                  type: integer
                  description: Customer asset ID.
                content_type:
                  type: string
                  description: Content type of the asset.
                filename:
                  type: string
                  description: Filename of the asset.
                url:
                  type: string
                  description: URL of the asset.
                file_size:
                  type: integer
                  description: File size in bytes.
                time_saved:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of last update.
            everflow_pay:
              type: object
              description: Everflow Pay status.
              properties:
                is_everflow_pay_enabled:
                  type: boolean
                  description: Whether Everflow Pay is enabled.
            performance:
              type: object
              description: Weekly and monthly performance metrics.
              properties:
                everxchange_demand_partner_id:
                  type: integer
                  description: The demand partner ID.
                clicks_weekly:
                  type: integer
                  description: Number of clicks in the past week.
                has_reached_weekly_threshold:
                  type: boolean
                  description: Whether the weekly click threshold has been reached.
                epc_weekly:
                  type: number
                  description: Earnings per click for the past week.
                cvr_weekly:
                  type: number
                  description: Conversion rate for the past week.
                clicks_monthly:
                  type: integer
                  description: Number of clicks in the past month.
                has_reached_monthly_threshold:
                  type: boolean
                  description: Whether the monthly click threshold has been reached.
                epc_monthly:
                  type: number
                  description: Earnings per click for the past month.
                cvr_monthly:
                  type: number
                  description: Conversion rate for the past month.
                time_created:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of when the performance record was created.
                time_saved:
                  type: integer
                  example: 1734455015
                  description: Unix timestamp of last update.
            programs:
              type: array
              description: Available programs with payout details.
              items:
                type: object
                properties:
                  everxchange_demand_partner_program_id:
                    type: integer
                    description: Unique program ID.
                  everxchange_demand_partner_id:
                    type: integer
                    description: The demand partner ID this program belongs to.
                  name:
                    type: string
                    description: Program name.
                  preview_url:
                    type: string
                    description: Preview URL for the program.
                  ordering_value:
                    type: integer
                    description: Display ordering value.
                  events:
                    type: array
                    description: Payout events within this program.
                    items:
                      type: object
                      properties:
                        everxchange_demand_partner_program_event_id:
                          type: integer
                          description: Unique event ID.
                        everxchange_demand_partner_program_id:
                          type: integer
                          description: The program ID this event belongs to.
                        everxchange_demand_partner_id:
                          type: integer
                          description: The demand partner ID.
                        name:
                          type: string
                          description: Event name.
                        is_default:
                          type: boolean
                          description: Whether this is the default event.
                        payout_type_id:
                          type: integer
                          description: Payout type ID.
                        payout_value_min:
                          type: number
                          description: Minimum payout value.
                        payout_value_max:
                          type: number
                          description: Maximum payout value.
                        time_created:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of when the event was created.
                        time_saved:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of last update.
                  time_created:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of when the program was created.
                  time_saved:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of last update.
            payments:
              type: object
              description: >-
                Payment provider availability. Each key is a provider name
                containing an object with an `enabled` boolean.
              properties:
                everflow_pay:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Everflow Pay is enabled.
                tipalti:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Tipalti is enabled.
                trusted_payouts:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Trusted Payouts is enabled.
                managed_payments:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Managed Payments is enabled.
                veem:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether Veem is enabled.
                paypal:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether PayPal is enabled.
                masspay:
                  type: object
                  properties:
                    enabled:
                      type: boolean
                      description: Whether MassPay is enabled.
            brands:
              type: array
              description: >-
                Brand entries associated with this demand partner. Only present
                for some partners.
              items:
                type: object
                properties:
                  everxchange_demand_partner_brand_id:
                    type: integer
                    description: Unique brand ID.
                  everxchange_demand_partner_id:
                    type: integer
                    description: The demand partner ID.
                  name:
                    type: string
                    description: Brand name.
                  logo_url:
                    type: string
                    description: URL to the brand logo.
                  logo_asset_id:
                    type: integer
                    description: Logo asset ID.
                  website_url:
                    type: string
                    description: Brand website URL.
                  ordering_value:
                    type: integer
                    description: Display ordering value.
                  relationship:
                    type: object
                    description: Related objects for the brand.
                    properties:
                      resource_asset:
                        type: object
                        description: Brand logo resource asset.
                        properties:
                          customer_asset_id:
                            type: integer
                            description: Customer asset ID.
                          content_type:
                            type: string
                            description: Content type of the asset.
                          filename:
                            type: string
                            description: Filename of the asset.
                          url:
                            type: string
                            description: URL of the asset.
                          file_size:
                            type: integer
                            description: File size in bytes.
                          time_saved:
                            type: integer
                            example: 1734455015
                            description: Unix timestamp of last update.
                  time_created:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of when the brand was created.
                  time_saved:
                    type: integer
                    example: 1734455015
                    description: Unix timestamp of last update.
            terms_and_conditions:
              type: string
              description: Terms and conditions text. Only present for some partners.
            vertical_ids:
              type: array
              description: Vertical category IDs.
              items:
                type: integer
            channel_ids:
              type: array
              description: Channel IDs.
              items:
                type: integer
            geo_vertical_ids:
              type: array
              description: Geographic vertical IDs.
              items:
                type: integer
            payout_type_ids:
              type: array
              description: Payout type IDs.
              items:
                type: integer
            platform_ids:
              type: array
              description: >-
                Platform identifiers (e.g. mobile, desktop) the partner operates
                on.
              items:
                type: integer
            categories:
              type: array
              description: Marketplace categories the partner operates in.
              items:
                type: object
                properties:
                  category_id:
                    type: integer
                    description: Category identifier.
                  type:
                    type: string
                    enum:
                      - parent
                      - children
                    description: Whether this is a parent category or a child category.
            country_ids:
              type: array
              description: Country IDs the partner targets.
              items:
                type: integer
            conversion_funnels:
              type: array
              description: Conversion funnel types this partner supports.
              items:
                type: string
                enum:
                  - ecomm
                  - lead_generation
            customer_short:
              type: string
              description: Short identifier for the partner's customer (read-only).
            network_currency_id:
              type: string
              description: Network currency identifier.
  securitySchemes:
    API Key:
      description: >
        The marketplace partner's API key. Uses the X-Eflow-Api-Key header. The
        key belongs to the marketplace partner user.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````