> ## Documentation Index > Fetch the complete documentation index at: https://docs.semicola.com/llms.txt > Use this file to discover all available pages before exploring further. # List organization advertisers (owned advertisers and relationships) ## OpenAPI ````yaml /openapi/buyer.yaml get /api/v2/organization/advertisers openapi: 3.1.0 info: title: Semicola Exchange buyer API version: 2.0.0 description: >- Buyer endpoints: advertisers, storefronts and connections, product discovery, campaigns, proposals, media buys, creatives and reporting. Every write accepts an Idempotency-Key header. servers: - url: https://api.semicola.com security: - bearerAuth: [] - sessionCookie: [] tags: - name: Advertisers - name: Storefronts - name: Product Discovery - name: Campaigns - name: Media Buys - name: Creatives - name: Catalogs - name: Reporting - name: Event Sources - name: Webhooks - name: Tasks - name: Audit Logs - name: Activity paths: /api/v2/organization/advertisers: get: tags: - Advertisers summary: List organization advertisers (owned advertisers and relationships) operationId: getOrganizationAdvertisers responses: '200': description: OK content: application/json: schema: type: object properties: data: anyOf: - type: object properties: entries: type: array items: type: object properties: rosterEntryId: type: string advertiserId: type: string displayName: type: string 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 - advertiser_admission - adcp_account state: type: string enum: - resolved - partial - conflict reason: anyOf: - 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 - type: 'null' required: - provenance - state - reason additionalProperties: false backing: oneOf: - type: object properties: kind: type: string const: compatibility_account accountId: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 advertiserId: type: string required: - kind - accountId - advertiserId additionalProperties: false - type: object properties: kind: type: string const: authorized_relationship relationshipRef: type: string advertiserId: type: string required: - kind - relationshipRef - advertiserId additionalProperties: false delegation: type: 'null' capabilities: type: object properties: read: type: boolean const: 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 accountSetupState: anyOf: - type: string enum: - needs_setup - waiting_on_buyer - awaiting_billing - type: 'null' accountSetupRelationshipId: type: string buysCount: type: integer minimum: 0 maximum: 9007199254740991 lastActivityAt: type: - string - 'null' brandDomain: type: string required: - rosterEntryId - advertiserId - displayName - relationshipClass - operatorRelationship - operatingMode - sandbox - system - binding - backing - delegation - capabilities - readiness additionalProperties: false unresolvedCounterpartyRelationships: type: array items: type: object properties: rosterEntryId: type: string displayName: type: string relationshipClass: type: string const: counterparty operatorRelationship: type: string const: unresolved operatingMode: type: string const: unresolved sandbox: type: boolean binding: type: object properties: provenance: type: string const: 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 const: authorized_relationship relationshipRef: type: string required: - kind - relationshipRef additionalProperties: false capabilities: type: object properties: read: type: boolean const: true advertiserManagement: type: string const: unavailable campaignManagement: type: string const: unavailable relationshipManagement: type: string enum: - available - account_switch_required - unavailable required: - read - advertiserManagement - campaignManagement - relationshipManagement additionalProperties: false readiness: type: object properties: state: type: string const: incomplete required: - state additionalProperties: false required: - rosterEntryId - displayName - relationshipClass - operatorRelationship - operatingMode - sandbox - binding - backing - capabilities - readiness additionalProperties: false lifecycles: type: array items: type: object properties: lifecycleId: type: string displayName: type: string provisioningMode: type: string enum: - managed - self_serve state: type: string enum: - invited - provisioning - ready - failed - revoked advertiserId: type: - string - 'null' targetAccountId: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' managementCapability: type: string enum: - available - account_switch_required - unavailable joinLink: type: 'null' failure: anyOf: - type: object properties: code: type: string recoverable: type: boolean const: true required: - code - recoverable additionalProperties: false - type: 'null' createdAt: type: string updatedAt: type: string required: - lifecycleId - displayName - provisioningMode - state - advertiserId - targetAccountId - managementCapability - joinLink - failure - createdAt - updatedAt additionalProperties: false page: type: object properties: limit: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 truncated: type: boolean required: - limit - truncated additionalProperties: false deliveredRelationshipClasses: type: array items: type: string enum: - owned - delegated - counterparty lenses: type: object properties: house: type: object properties: needsSetupCount: type: integer minimum: 0 maximum: 9007199254740991 required: - needsSetupCount additionalProperties: false partnerManaged: type: object properties: needsSetupCount: type: integer minimum: 0 maximum: 9007199254740991 required: - needsSetupCount additionalProperties: false selfServe: type: object properties: needsSetupCount: type: integer minimum: 0 maximum: 9007199254740991 required: - needsSetupCount additionalProperties: false system: type: object properties: needsSetupCount: type: integer minimum: 0 maximum: 9007199254740991 required: - needsSetupCount additionalProperties: false required: - house - partnerManaged - selfServe additionalProperties: false required: - entries - unresolvedCounterpartyRelationships - lifecycles - page - deliveredRelationshipClasses additionalProperties: false - type: 'null' error: anyOf: - type: object properties: code: type: string message: type: string field: type: string details: {} required: - code - message additionalProperties: false - type: 'null' required: - data - error additionalProperties: false default: description: >- Error envelope `{data: null, error: {code, message, field?, details?}}`. components: securitySchemes: bearerAuth: type: http scheme: bearer description: API key or OAuth access token. sessionCookie: type: apiKey in: cookie name: sc_session ````