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

> List all credentials the buyer has registered, scoped to the storefront sources each credential gives access to.



## OpenAPI

````yaml /v2/buyer-api-v2.yaml get /storefronts/credentials
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:
  /storefronts/credentials:
    get:
      tags:
        - Storefronts
      summary: List credentials
      description: >-
        List all credentials the buyer has registered, scoped to the storefront
        sources each credential gives access to.
      operationId: listStorefrontCredentials
      responses:
        '200':
          description: List credentials
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/BuyerCredential'
        '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:
    BuyerCredential:
      description: >-
        A buyer's registered credential, scoped to the storefront sources it
        gives access to
      type: object
      properties:
        id:
          description: Credential record ID
          type: string
        accountIdentifier:
          description: The buyer's account identifier at the source
          type: string
        accountType:
          description: Account type (e.g. CLIENT, MARKETPLACE)
          type: string
        status:
          description: Credential status
          type: string
        registeredBy:
          description: >-
            Who registered this credential. Null on legacy rows that predate
            registration tracking.
          nullable: true
          type: string
        createdAt:
          description: When the credential was created (ISO 8601)
          type: string
        updatedAt:
          description: When the credential was last updated (ISO 8601)
          type: string
        sources:
          description: >-
            Storefront sources this credential gives the buyer access to. A
            single credential may cover multiple sources when the same agent
            backs the same source across storefronts. Can be empty when the
            credential's underlying agent is no longer linked to any active
            storefront source — the credential row is preserved so buyers can
            see (and clean up) orphaned registrations.
          type: array
          items:
            $ref: '#/components/schemas/BuyerCredentialSourceRef'
      required:
        - id
        - accountIdentifier
        - accountType
        - status
        - registeredBy
        - createdAt
        - updatedAt
        - sources
      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
    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
    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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or access token

````