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

> Returns one EmailOctopus list, its destination fields, and supported source fields for mapping audience contacts. The connected account must be healthy and owned by the authenticated organization. Requires a non-viewer member using bearer authentication. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.



## 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
      description: >-
        Returns one EmailOctopus list, its destination fields, and supported
        source fields for mapping audience contacts. The connected account must
        be healthy and owned by the authenticated organization. Requires a
        non-viewer member using bearer authentication. Requests share a
        120-per-60-second allowance per source IP within this integration,
        destination, or delivery route family.
      operationId: getAnEmailoctopusListAndItsFields
      parameters:
        - schema:
            type: string
            minLength: 1
            description: EmailOctopus list identifier in the connected account.
            example: example-newsletter
          required: true
          description: EmailOctopus list identifier in the connected account.
          name: listId
          in: path
          example: example-newsletter
        - schema:
            type: string
            format: uuid
            description: >-
              Healthy EmailOctopus connected account identifier in the
              authenticated organization.
            example: 66666666-6666-4666-8666-666666666666
          required: true
          description: >-
            Healthy EmailOctopus connected account identifier in the
            authenticated organization.
          name: connectedAccountId
          in: query
          example: 66666666-6666-4666-8666-666666666666
      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
              example:
                data:
                  list:
                    id: example-newsletter
                    name: Example newsletter
                    doubleOptIn: false
                    fields:
                      - tag: FirstName
                        type: TEXT
                        label: First name
                        fallback: null
                    tags:
                      - research
                    counts:
                      pending: 0
                      subscribed: 12
                      unsubscribed: 1
                  sourceFields:
                    - 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
                meta:
                  timestamp: '2026-01-15T12:00:00.000Z'
                  request_id: example-request
        '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>.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.