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

# List organization advertisers

> Return one bounded advertiser roster across Buyer Accounts authorized for the organization context.



## OpenAPI

````yaml /v2/storefront-api-v2.yaml get /organization/advertisers
openapi: 3.0.0
info:
  title: Scope3 Storefront API
  version: 2.0.0
  description: >-
    REST API for partners to manage Seller Accounts, inventory sources, and
    billing.


    ## Authentication


    All endpoints require a Bearer token in the Authorization header:

    ```

    Authorization: Bearer your-api-key

    ```


    ## Base URL


    `https://api.interchange.io/api/v2/storefront`


    ## For AI Agents


    AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools:

    - `initialize`: Start an MCP session

    - `api_call`: Make REST API calls

    - `ask_about_capability`: Learn about API features
servers:
  - url: https://api.interchange.io/api/v2/storefront
    description: Production server
security: []
tags:
  - name: Account
    description: Account management, service tokens, and preferences
  - name: Asks
    description: >-
      What you are waiting on Scope3 for — support, product, and supply asks in
      one list
  - name: Storefront
    description: Manage storefront and inventory sources
  - name: Storefront Agents
    description: List and manage registered sales, signals, and outcomes agents
  - name: Storefront Activity
    description: Audit log of configuration and inventory changes on the storefront
  - name: Storefront Billing
    description: Payout bank details and billing configuration for Seller Accounts
  - name: AI Usage
    description: Seller Account AI token usage visibility by model
  - name: MCP
    description: Model Context Protocol endpoints
paths:
  /organization/advertisers:
    servers:
      - url: https://api.interchange.io/api/v2
        description: Production server
    get:
      tags:
        - Advertisers
      summary: List organization advertisers
      description: >-
        Return one bounded advertiser roster across Buyer Accounts authorized
        for the organization context.
      operationId: listOrganizationAdvertisers
      responses:
        '200':
          description: List organization advertisers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationAdvertiserRosterApiResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            The credential is advertiser-scoped or the organization account
            cannot be authorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    OrganizationAdvertiserRosterApiResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/OrganizationAdvertiserRosterResponse'
        error:
          type: string
          nullable: true
          enum:
            - null
      required:
        - data
        - error
      additionalProperties: false
      description: >-
        Standard successful API envelope containing the organization advertiser
        roster.
    ErrorResponse:
      type: object
      properties:
        data:
          type: string
          nullable: true
          enum:
            - null
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - data
        - error
      additionalProperties: false
      description: Standard error response
    OrganizationAdvertiserRosterResponse:
      type: object
      properties:
        entries:
          maxItems: 500
          type: array
          items:
            $ref: '#/components/schemas/AdvertiserRosterEntry'
        unresolvedCounterpartyRelationships:
          maxItems: 500
          type: array
          items:
            $ref: >-
              #/components/schemas/AdvertiserRosterUnresolvedCounterpartyRelationship
        lifecycles:
          maxItems: 500
          type: array
          items:
            type: object
            properties:
              lifecycleId:
                type: string
                pattern: ^\d+$
              displayName:
                type: string
                minLength: 1
              provisioningMode:
                type: string
                enum:
                  - managed
                  - self_serve
              state:
                type: string
                enum:
                  - invited
                  - provisioning
                  - ready
                  - failed
                  - revoked
              advertiserId:
                nullable: true
                type: string
                pattern: ^\d+$
              targetAccountId:
                nullable: true
                type: integer
                minimum: 0
                exclusiveMinimum: true
                maximum: 9007199254740991
              managementCapability:
                type: string
                enum:
                  - available
                  - account_switch_required
                  - unavailable
              joinLink:
                type: string
                nullable: true
                enum:
                  - null
              failure:
                nullable: true
                type: object
                properties:
                  code:
                    type: string
                    minLength: 1
                  recoverable:
                    type: boolean
                    enum:
                      - true
                required:
                  - code
                  - recoverable
                additionalProperties: false
              createdAt:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
              updatedAt:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            required:
              - lifecycleId
              - displayName
              - provisioningMode
              - state
              - advertiserId
              - targetAccountId
              - managementCapability
              - joinLink
              - failure
              - createdAt
              - updatedAt
            additionalProperties: false
        page:
          type: object
          properties:
            limit:
              type: integer
              minimum: 0
              exclusiveMinimum: true
              maximum: 500
            truncated:
              type: boolean
          required:
            - limit
            - truncated
          additionalProperties: false
        deliveredRelationshipClasses:
          type: array
          items:
            type: string
            enum:
              - owned
              - delegated
              - counterparty
      required:
        - entries
        - unresolvedCounterpartyRelationships
        - lifecycles
        - page
        - deliveredRelationshipClasses
      additionalProperties: false
      description: >-
        Bounded organization-level advertiser roster across authorized Buyer
        Accounts.
    ApiError:
      type: object
      properties:
        code:
          type: string
          description: Machine-readable error code
        message:
          type: string
          description: Human-readable error message
        field:
          description: Field path associated with the error
          type: string
        details:
          description: Additional error context
          type: object
          additionalProperties: {}
      required:
        - code
        - message
      additionalProperties: false
      description: Structured error object
    AdvertiserRosterEntry:
      type: object
      properties:
        rosterEntryId:
          type: string
          minLength: 1
        advertiserId:
          type: string
          minLength: 1
        displayName:
          type: string
          minLength: 1
        relationshipClass:
          type: string
          enum:
            - owned
            - delegated
            - counterparty
        operatorRelationship:
          type: string
          enum:
            - organization
            - client
            - external
        operatingMode:
          type: string
          enum:
            - managed
            - self_serve
        sandbox:
          type: boolean
        system:
          type: boolean
        binding:
          type: object
          properties:
            provenance:
              type: string
              enum:
                - compatibility_account
                - seller_buyer_sponsorship
                - advertiser_grant
                - adcp_account
            state:
              type: string
              enum:
                - resolved
                - partial
                - conflict
            reason:
              nullable: true
              type: string
              enum:
                - backing_account_missing
                - backing_account_is_container
                - display_name_missing
                - self_serve_sponsorship_missing
                - sponsorship_parent_mismatch
                - sponsorship_storefront_missing
                - duplicate_backing_records
          required:
            - provenance
            - state
            - reason
          additionalProperties: false
        backing:
          $ref: '#/components/schemas/AdvertiserRosterBacking'
        delegation:
          nullable: true
          type: object
          properties:
            grantRef:
              type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            owner:
              type: object
              properties:
                organizationRef:
                  type: string
                  format: uuid
                  pattern: >-
                    ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
                displayName:
                  type: string
                  minLength: 1
                  maxLength: 200
              required:
                - organizationRef
                - displayName
              additionalProperties: false
            capabilities:
              minItems: 1
              type: array
              items:
                type: string
                enum:
                  - advertiser.read
                  - campaign.read
                  - campaign.manage
            status:
              type: string
              enum:
                - active
            expiresAt:
              type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
          required:
            - grantRef
            - owner
            - capabilities
            - status
            - expiresAt
          additionalProperties: false
        capabilities:
          type: object
          properties:
            read:
              type: boolean
              enum:
                - true
            advertiserManagement:
              type: string
              enum:
                - available
                - account_switch_required
                - unavailable
            campaignManagement:
              type: string
              enum:
                - available
                - account_switch_required
                - unavailable
            relationshipManagement:
              type: string
              enum:
                - available
                - account_switch_required
                - unavailable
          required:
            - read
            - advertiserManagement
            - campaignManagement
            - relationshipManagement
          additionalProperties: false
        readiness:
          type: object
          properties:
            state:
              type: string
              enum:
                - ready
                - pending
                - suspended
                - revoked
                - disabled
                - incomplete
          required:
            - state
          additionalProperties: false
        operatorDomain:
          type: string
          maxLength: 253
          pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$
        operatorDisplayName:
          nullable: true
          type: string
          minLength: 1
        brandDomain:
          type: string
          maxLength: 253
          pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$
      required:
        - rosterEntryId
        - advertiserId
        - displayName
        - relationshipClass
        - operatorRelationship
        - operatingMode
        - sandbox
        - system
        - binding
        - backing
        - delegation
        - capabilities
        - readiness
      additionalProperties: false
      description: >-
        One canonical advertiser relationship visible to the organization
        caller.
    AdvertiserRosterUnresolvedCounterpartyRelationship:
      type: object
      properties:
        rosterEntryId:
          type: string
          minLength: 1
        displayName:
          type: string
          minLength: 1
        relationshipClass:
          type: string
          enum:
            - counterparty
        operatorRelationship:
          type: string
          enum:
            - unresolved
        operatingMode:
          type: string
          enum:
            - unresolved
        sandbox:
          type: boolean
        binding:
          type: object
          properties:
            provenance:
              type: string
              enum:
                - adcp_account
            state:
              type: string
              enum:
                - partial
                - conflict
            reason:
              type: string
              enum:
                - backing_account_ineligible
                - identity_evidence_missing
                - identity_tuple_incomplete
                - identity_tuple_mismatch
                - identity_evidence_stale
                - identity_evidence_revoked
                - multiple_active_grants
                - operator_identity_unverified
          required:
            - provenance
            - state
            - reason
          additionalProperties: false
        backing:
          type: object
          properties:
            kind:
              type: string
              enum:
                - authorized_relationship
            relationshipRef:
              type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          required:
            - kind
            - relationshipRef
          additionalProperties: false
        capabilities:
          type: object
          properties:
            read:
              type: boolean
              enum:
                - true
            advertiserManagement:
              type: string
              enum:
                - unavailable
            campaignManagement:
              type: string
              enum:
                - unavailable
            relationshipManagement:
              type: string
              enum:
                - available
                - account_switch_required
                - unavailable
          required:
            - read
            - advertiserManagement
            - campaignManagement
            - relationshipManagement
          additionalProperties: false
        readiness:
          type: object
          properties:
            state:
              type: string
              enum:
                - incomplete
          required:
            - state
          additionalProperties: false
      required:
        - rosterEntryId
        - displayName
        - relationshipClass
        - operatorRelationship
        - operatingMode
        - sandbox
        - binding
        - backing
        - capabilities
        - readiness
      additionalProperties: false
      description: >-
        Additive unresolved AdCP counterparty relationship awaiting explicit
        direct-human Seller-admin repair.
    AdvertiserRosterBacking:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - compatibility_account
            accountId:
              type: integer
              minimum: 0
              exclusiveMinimum: true
              maximum: 9007199254740991
            advertiserId:
              type: string
              minLength: 1
          required:
            - kind
            - accountId
            - advertiserId
          additionalProperties: false
        - type: object
          properties:
            kind:
              type: string
              enum:
                - authorized_relationship
            relationshipRef:
              type: string
              format: uuid
              pattern: >-
                ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            advertiserId:
              type: string
              minLength: 1
          required:
            - kind
            - relationshipRef
            - advertiserId
          additionalProperties: false
      description: >-
        Authorized backing boundary. Foreign tenant identifiers are never
        exposed.
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or access token

````