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

# Get an EmailOctopus list and its fields



## OpenAPI

````yaml https://api.aws53.cloud/openapi-intent.json get /v1/intent/integrations/emailoctopus/lists/{listId}
openapi: 3.1.0
info:
  title: Orbit API
  version: 1.0.0
  description: >-
    Orbit Audience Intent API: topic discovery, site analysis, curated ICP
    filters, saved audiences, materialization runs, stats, and CSV export.
    Discovery endpoints are public; audience management accepts either Bearer
    JWT or X-API-Key auth.
servers:
  - url: https://api.aws53.cloud
    description: Production
security: []
tags:
  - name: Topic Discovery
    description: Browse, search, and analyze available intent topics
  - name: Site Analysis
    description: Analyze a website URL to find matching intent topics
  - name: Site Topics
    description: Recent organization site-topic analyses
  - name: Audience Builder
    description: >-
      Curated filters, preview, saved audiences, runs, exports, webhooks, and
      managed destinations
paths:
  /v1/intent/integrations/emailoctopus/lists/{listId}:
    get:
      tags:
        - Audience Builder
      summary: Get an EmailOctopus list and its fields
      parameters:
        - schema:
            type: string
            minLength: 1
          required: true
          name: listId
          in: path
        - schema:
            type: string
            format: uuid
          required: true
          name: connectedAccountId
          in: query
      responses:
        '200':
          description: EmailOctopus list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      list:
                        $ref: '#/components/schemas/IntentAudienceEmailOctopusList'
                      sourceFields:
                        type: array
                        items:
                          type: string
                          enum:
                            - firstName
                            - lastName
                            - fullName
                            - jobTitle
                            - headline
                            - seniority
                            - department
                            - linkedinUrl
                            - company.name
                            - company.domain
                            - company.industry
                            - company.industryGroup
                            - company.revenueRange
                            - company.linkedinUrl
                            - geo.city
                            - geo.state
                            - geo.country
                            - intent.score
                            - intent.topicOverlap
                            - intent.matchedTopics
                    required:
                      - list
                      - sourceFields
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - data
                  - meta
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '403':
          description: Not allowed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '500':
          description: Provider or internal failure
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '503':
          description: Required integration configuration unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    IntentAudienceEmailOctopusList:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        doubleOptIn:
          type: boolean
        fields:
          type: array
          items:
            type: object
            properties:
              tag:
                type: string
              type:
                type: string
                enum:
                  - TEXT
                  - NUMBER
                  - DATE
              label:
                type: string
              fallback:
                type:
                  - string
                  - 'null'
            required:
              - tag
              - type
              - label
        tags:
          type: array
          items:
            type: string
        counts:
          type: object
          properties:
            pending:
              type: integer
            subscribed:
              type: integer
            unsubscribed:
              type: integer
          required:
            - pending
            - subscribed
            - unsubscribed
      required:
        - id
        - name
        - doubleOptIn
        - fields
        - tags
        - counts
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Dashboard access token. Send as Authorization: Bearer <token>.'
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Organization API key (sk_...). Send as X-API-Key: <key>.'

````