> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/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:
      type: object
      properties:
        id:
          type: string
          description: Credential record ID
        accountIdentifier:
          type: string
          description: The buyer's account identifier at the source
        accountType:
          type: string
          description: Account type (e.g. CLIENT, MARKETPLACE)
        status:
          type: string
          description: Credential status
        registeredBy:
          nullable: true
          description: >-
            Who registered this credential. Null on legacy rows that predate
            registration tracking.
          type: string
        createdAt:
          type: string
          description: When the credential was created (ISO 8601)
        updatedAt:
          type: string
          description: When the credential was last updated (ISO 8601)
        sources:
          type: array
          items:
            $ref: '#/components/schemas/BuyerCredentialSourceRef'
          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.
      required:
        - id
        - accountIdentifier
        - accountType
        - status
        - registeredBy
        - createdAt
        - updatedAt
        - sources
      additionalProperties: false
      description: >-
        A buyer's registered credential, scoped to the storefront sources it
        gives access to
    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
    BuyerCredentialSourceRef:
      type: object
      properties:
        storefrontId:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
          description: Storefront ID this credential covers
        storefrontName:
          type: string
          description: Storefront display name
        sourceId:
          type: string
          description: Inventory source ID within the storefront
        sourceName:
          type: string
          description: Inventory source display name
      required:
        - storefrontId
        - storefrontName
        - sourceId
        - sourceName
      additionalProperties: false
      description: >-
        A storefront/source pair that a single credential row gives the buyer
        access to
    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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or access token

````