> ## 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 available accounts > Discover accounts available to link to an advertiser from a specific sales agent. ## OpenAPI ````yaml /v2/buyer-api-v2.yaml get /advertisers/{advertiserId}/accounts/available openapi: 3.0.0 info: title: Scope3 Buyer API version: 2.0.0 description: |- REST API for advertisers to manage advertisers, campaigns, and reporting. ## Authentication All endpoints require a Bearer token in the Authorization header: ``` Authorization: Bearer your-api-key ``` ## Base URL `https://api.interchange.io/api/v2/buyer` ## For AI Agents AI agents can use the MCP endpoint at `/mcp/v2/buyer` 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/buyer description: Production server security: [] tags: - name: Signup description: Request reviewed access to Interchange - 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: Advertisers description: Manage advertisers - name: Product Discovery description: Discover and select products - name: Campaigns description: Manage advertising campaigns - name: Creatives description: Build, manage, and sync campaign creatives via AdCP Creative Protocol - name: Reporting description: Access performance metrics - name: Event Sources description: >- Manage event source configurations and log conversion/marketing events for attribution - name: Property Lists description: Validate property lists against AAO registry - name: Sales Agents description: View and connect sales agents - name: Measurement description: Measurement sources, records, context, and freshness - name: Syndication description: Syndicate resources to ADCP agents - name: Tasks description: Track async operation status - name: Buyer Billing description: >- Consolidated invoicing for buyers — invoices and pending invoice items issued by Scope3 across the buyer customer. - name: MCP description: Model Context Protocol endpoints for AI agents paths: /advertisers/{advertiserId}/accounts/available: get: tags: - Advertisers summary: List available accounts description: >- Discover accounts available to link to an advertiser from a specific sales agent. operationId: listAvailableAccounts parameters: - in: query name: storefrontId schema: description: >- Storefront the source lives on. Pair with `sourceId` to identify the source whose accounts to list. example: 42 type: integer maximum: 9007199254740991 minimum: 1 required: true description: >- Storefront the source lives on. Pair with `sourceId` to identify the source whose accounts to list. - in: query name: sourceId schema: description: Inventory source within `storefrontId` whose accounts to list. example: src_main type: string minLength: 1 required: true description: Inventory source within `storefrontId` whose accounts to list. - in: query name: refresh schema: description: >- When true, re-fetches accounts from the source before returning results. Defaults to false (returns cached accounts). example: 'false' type: string enum: - 'true' - 'false' description: >- When true, re-fetches accounts from the source before returning results. Defaults to false (returns cached accounts). - in: query name: billingType schema: description: >- Billing arrangement type to filter accounts by (e.g. "advertiser", "operator", "agent"). Must be one of the values supported by this source. Defaults to the source's default billing type if omitted. example: advertiser type: string description: >- Billing arrangement type to filter accounts by (e.g. "advertiser", "operator", "agent"). Must be one of the values supported by this source. Defaults to the source's default billing type if omitted. - in: query name: credentialId schema: description: >- ID of a specific registered credential to use for account discovery. Required when the customer has multiple credentials registered for this source. Use GET /storefronts/credentials to list registered credentials and their IDs. example: '42' type: string description: >- ID of a specific registered credential to use for account discovery. Required when the customer has multiple credentials registered for this source. Use GET /storefronts/credentials to list registered credentials and their IDs. - in: query name: take schema: description: Number of results to return (max 250) example: 50 default: 50 type: integer maximum: 250 minimum: 1 description: Number of results to return (max 250) - in: query name: skip schema: description: Number of results to skip for pagination example: 0 default: 0 type: integer minimum: 0 maximum: 9007199254740991 description: Number of results to skip for pagination - in: path name: advertiserId schema: description: Unique identifier for the advertiser example: '12345' type: string minLength: 1 required: true description: Unique identifier for the advertiser responses: '200': description: List available accounts content: application/json: schema: $ref: '#/components/schemas/AvailableAccountListResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized 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: AvailableAccountListResponse: description: Response containing a list of available accounts from a partner type: object properties: accounts: description: List of available (discovered) accounts type: array items: $ref: '#/components/schemas/AvailableAccountOutput' total: description: Total count of available accounts example: 8 type: integer minimum: 0 maximum: 9007199254740991 synced: description: >- True when no accounts matched and a sync_accounts call was automatically triggered to provision this account at the partner. The list reflects the post-sync state. type: boolean billingOptions: description: >- Billing options supported by this partner agent, as reported in its ADCP capabilities. type: object properties: default: nullable: true type: string supported: type: array items: type: string required: - default - supported additionalProperties: false required: - accounts - total additionalProperties: false ErrorResponse: description: Standard error response type: object properties: data: type: string nullable: true enum: - null error: $ref: '#/components/schemas/ApiError' required: - data - error additionalProperties: false AvailableAccountOutput: description: Discovered account available to be linked to an advertiser type: object properties: accountId: description: Partner account identifier example: acc_acme_pinnacle type: string credentialId: description: >- Credential row that owns this discovered account. Include this value when linking the account so duplicate account IDs across mapped connections remain unambiguous. example: '42' nullable: true type: string name: description: Human-readable account name from the partner example: Acme c/o Pinnacle nullable: true type: string advertiser: description: Advertiser name as recorded by the partner platform example: Acme Corp nullable: true type: string billingProxy: description: Billing proxy entity (e.g. agency buying on behalf of advertiser) example: Pinnacle Media nullable: true type: string house: description: Domain or house identifier for the account example: acme-corp.com nullable: true type: string billing: description: Billing arrangement type example: advertiser nullable: true type: string sources: description: >- Storefront sources that surface this discovered account to the buyer. Same account may appear via multiple sources when the underlying agent is shared across storefronts. type: array items: $ref: '#/components/schemas/BuyerCredentialSourceRef' status: description: Current account status on the partner platform type: string enum: - active - pending_approval - payment_required - suspended - closed - unreachable required: - accountId - sources - status additionalProperties: false ApiError: description: Structured error object type: object properties: code: description: Machine-readable error code type: string message: description: Human-readable error message type: string field: description: Field path associated with the error type: string details: description: Additional error context type: object additionalProperties: {} required: - code - message additionalProperties: false BuyerCredentialSourceRef: description: >- A storefront/source pair that a single credential row gives the buyer access to type: object properties: storefrontId: description: Storefront ID this credential covers type: integer minimum: -9007199254740991 maximum: 9007199254740991 storefrontName: description: Storefront display name type: string sourceId: description: Inventory source ID within the storefront type: string sourceName: description: Inventory source display name type: string required: - storefrontId - storefrontName - sourceId - sourceName additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: API key or access token ````