> ## 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.

# Find Connections (Advanced)

Retrieve all marketplace connections between a partner and advertisers. Filter by connection status (active, pending, or deleted). Each connection includes details about the network, demand partner, and payment methods.

Supports pagination via `page` and `page_size` query parameters.


## OpenAPI

````yaml openapi/marketplace-connections.yaml post /partners/connections/table
openapi: 3.0.3
info:
  title: Everflow Marketplace API - Connections
  description: >
    Marketplace connection endpoints for the Everflow partner marketing
    platform. Retrieve and manage connections between marketplace partners and
    advertisers. For more detail, see [Managing Marketplace Publisher
    Connections](https://helpdesk.everflow.io/collaborator/managing-marketplace-publisher-connections)
    in the Help Center.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Marketplace Connections
    description: Endpoints for managing marketplace partner connections.
paths:
  /partners/connections/table:
    post:
      tags:
        - Marketplace Connections
      summary: Find Connections (Advanced)
      parameters:
        - in: query
          name: page
          schema:
            type: integer
            default: 1
          description: Page number (1-based).
        - in: query
          name: page_size
          schema:
            type: integer
            default: 50
          description: Number of results per page.
      requestBody:
        required: true
        content:
          application/json:
            example:
              filters:
                status: active
            schema:
              type: object
              properties:
                filters:
                  type: object
                  description: Filters to narrow the connection results.
                  properties:
                    status:
                      type: string
                      enum:
                        - active
                        - pending
                        - deleted
                      description: Filter connections by status.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  connections:
                    type: array
                    description: Array of marketplace connection objects.
                    items:
                      type: object
                      properties:
                        partner_id:
                          type: integer
                          description: Unique partner ID.
                        network_id:
                          type: integer
                          description: Network ID of the connected advertiser.
                        network_affiliate_id:
                          type: integer
                          description: >-
                            Affiliate ID assigned to this partner within the
                            network.
                        network_affiliate_user_id:
                          type: integer
                          description: >-
                            Affiliate user ID assigned to this partner within
                            the network.
                        status:
                          type: string
                          enum:
                            - active
                            - pending
                            - deleted
                          description: Current status of the connection.
                        time_created:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of when the connection was created.
                        relationship:
                          type: object
                          description: Related data for this connection.
                          properties:
                            network:
                              type: object
                              description: Network/brand details.
                              properties:
                                network_id:
                                  type: integer
                                  description: Network ID.
                                name:
                                  type: string
                                  description: Network name.
                                logo_image_url:
                                  type: string
                                  description: Network logo image URL.
                                signup_url:
                                  type: string
                                  description: Network signup URL.
                                login_url:
                                  type: string
                                  description: Network login URL.
                                timezone_id:
                                  type: integer
                                  description: Network timezone ID.
                            demand_partner:
                              type: object
                              description: Demand partner information.
                              properties:
                                everxchange_demand_partner_id:
                                  type: integer
                                  description: Demand partner ID.
                                company_name:
                                  type: string
                                  description: Demand partner company name.
                                network_id:
                                  type: integer
                                  description: Network ID.
                                status:
                                  type: string
                                  description: Demand partner status.
                                website_url:
                                  type: string
                                  description: Demand partner website URL.
                                public_description:
                                  type: string
                                  description: Public description of the demand partner.
                                is_internal:
                                  type: boolean
                                  description: Whether the demand partner is internal.
                                is_contact_info_public:
                                  type: boolean
                                  description: >-
                                    Whether contact information is publicly
                                    visible.
                                logo_url:
                                  type: string
                                  description: Demand partner logo URL.
                                logo_asset_id:
                                  type: integer
                                  description: Logo asset ID.
                                link:
                                  type: string
                                  description: Demand partner link.
                                custom_link_label:
                                  type: string
                                  description: Custom label for the link.
                                default_network_offer_id:
                                  type: integer
                                  description: Default network 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 when the demand partner
                                    was last saved.
                                relationship:
                                  type: object
                                  description: Demand partner relationship data.
                                  properties:
                                    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.
                                    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
                                    partner_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.
                                    partner_country_ids:
                                      type: array
                                      description: Country IDs the partner targets.
                                      items:
                                        type: integer
                            everflow_pay:
                              type: object
                              description: Everflow Pay configuration.
                              properties:
                                is_everflow_pay_enabled:
                                  type: boolean
                                  description: Whether Everflow Pay is enabled.
                            payments:
                              type: object
                              description: >-
                                Payment provider availability keyed by provider
                                name. Each provider has an `enabled` boolean.
                              properties:
                                everflow_pay:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                tipalti:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                trusted_payouts:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                managed_payments:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                veem:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                paypal:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                                masspay:
                                  type: object
                                  properties:
                                    enabled:
                                      type: boolean
                            api_key:
                              type: string
                              description: >
                                The affiliate API key for this connection. Only
                                present on active connections.
                  paging:
                    type: object
                    properties:
                      page:
                        type: integer
                        description: Current page number.
                      page_size:
                        type: integer
                        description: Number of results per page.
                      total_count:
                        type: integer
                        description: Total number of matching connections.
      security:
        - API Key: []
components:
  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

````