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

# Pixel lookup

> Retrieves pixel events. Auto-detects the pixel provider and returns V3 (PixelFetchResponse) or V4 (PixelFetchResponseV4) format accordingly.



## OpenAPI

````yaml /openapi.yaml get /pixels/{id}
openapi: 3.0.0
info:
  title: AudienceLab API
  version: 1.0.0
  description: API endpoints for AudienceLab
servers:
  - url: https://api.audiencelab.io
    description: Production API
security:
  - ApiKeyAuth: []
tags:
  - name: Audience
  - name: Pixel
  - name: Enrichment
paths:
  /pixels/{id}:
    get:
      tags:
        - Pixel
      summary: Pixel lookup
      description: >-
        Retrieves pixel events. Auto-detects the pixel provider and returns V3
        (PixelFetchResponse) or V4 (PixelFetchResponseV4) format accordingly.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: The UUID of the pixel to fetch events for
          example: 003daacb-d261-421c-9781-311df9c381d8
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: Page number (1-indexed)
          example: 1
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 100
          description: Number of items per page (max 1000)
          example: 100
      responses:
        '200':
          description: >-
            Successfully retrieved pixel events. Returns V3 or V4 format based
            on the pixel's provider.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/PixelFetchResponse'
                  - $ref: '#/components/schemas/PixelFetchResponseV4'
        '400':
          description: Bad request - invalid parameters or pixel missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - pixel does not belong to the authenticated account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found - pixel does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    PixelFetchResponse:
      type: object
      properties:
        total_records:
          type: integer
          example: 500
        page_size:
          type: integer
          example: 100
        page:
          type: integer
          example: 1
        total_pages:
          type: integer
          example: 5
        events:
          type: array
          items:
            $ref: '#/components/schemas/PixelEvent'
    PixelFetchResponseV4:
      type: object
      properties:
        total_records:
          type: integer
          example: 500
        page_size:
          type: integer
          example: 100
        page:
          type: integer
          example: 1
        total_pages:
          type: integer
          example: 5
        events:
          type: array
          items:
            $ref: '#/components/schemas/PixelEventV4'
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          example: error message
    PixelEvent:
      type: object
      properties:
        pixel_id:
          type: string
          example: PIX123456
        hem_sha256:
          type: string
          example: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3
        event_timestamp:
          type: string
          format: date-time
          example: '2024-01-15T10:30:00Z'
        event_type:
          type: string
          example: page_view
        ip_address:
          type: string
          example: 192.168.1.1
        activity_start_date:
          type: string
          format: date-time
          example: '2024-01-15T00:00:00Z'
        activity_end_date:
          type: string
          format: date-time
          example: '2024-01-15T23:59:59Z'
        referrer_url:
          type: string
          example: https://example.com/page
        resolution:
          $ref: '#/components/schemas/PixelResolutionV3'
        event_data:
          type: object
          description: Additional event data
    PixelEventV4:
      type: object
      properties:
        pixel_id:
          type: string
          example: PIX123456
        hem_sha256:
          type: string
          example: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3
        event_timestamp:
          type: string
          example: '2024-01-15'
        referrer_url:
          type: string
          example: https://example.com/page
        full_url:
          type: string
          description: Full URL extracted from event data
          example: https://example.com/products/item-123
        edid:
          type: string
          description: External Device ID (UUID from resolution)
          example: f47ac10b-58cc-4372-a567-0e02b2c3d479
        resolution:
          $ref: '#/components/schemas/PixelResolutionV4'
    PixelResolutionV3:
      type: object
      description: Resolution data containing enriched information for v3
      properties:
        UUID:
          type: string
          example: f47ac10b-58cc-4372-a567-0e02b2c3d479
        FIRST_NAME:
          type: string
          example: John
        LAST_NAME:
          type: string
          example: Doe
        PERSONAL_ADDRESS:
          type: string
          example: 123 Main St
        PERSONAL_CITY:
          type: string
          example: San Francisco
        PERSONAL_STATE:
          type: string
          example: CA
        PERSONAL_ZIP:
          type: string
          example: '94105'
        PERSONAL_ZIP4:
          type: string
          example: '1234'
        AGE_RANGE:
          type: string
          example: 25-34
        CHILDREN:
          type: string
          example: 'Yes'
        GENDER:
          type: string
          example: Male
        HOMEOWNER:
          type: string
          example: 'Yes'
        MARRIED:
          type: string
          example: 'No'
        NET_WORTH:
          type: string
          example: $100K-$250K
        INCOME_RANGE:
          type: string
          example: $75K-$100K
        DIRECT_NUMBER:
          type: string
          example: '+14155551234'
        DIRECT_NUMBER_DNC:
          type: string
          example: 'No'
        MOBILE_PHONE:
          type: string
          example: '+14155555678'
        MOBILE_PHONE_DNC:
          type: string
          example: 'No'
        PERSONAL_PHONE:
          type: string
          example: '+14155559012'
        PERSONAL_PHONE_DNC:
          type: string
          example: 'No'
        BUSINESS_EMAIL:
          type: string
          example: jdoe@acmecorp.com
        PERSONAL_EMAILS:
          type: string
          example: john.doe@email.com
        PERSONAL_VERIFIED_EMAILS:
          type: string
          example: john.doe@email.com
        BUSINESS_VERIFIED_EMAILS:
          type: string
          example: jdoe@acmecorp.com
        SHA256_PERSONAL_EMAIL:
          type: string
          example: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3
        SHA256_BUSINESS_EMAIL:
          type: string
          example: b665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae4
        JOB_TITLE:
          type: string
          example: Senior Software Engineer
        HEADLINE:
          type: string
          example: Building great software
        DEPARTMENT:
          type: string
          example: Engineering
        SENIORITY_LEVEL:
          type: string
          example: Senior
        INFERRED_YEARS_EXPERIENCE:
          type: string
          example: '10'
        COMPANY_NAME_HISTORY:
          type: string
          example: Previous Corp, Another Inc
        JOB_TITLE_HISTORY:
          type: string
          example: Software Engineer, Junior Developer
        EDUCATION_HISTORY:
          type: string
          example: Stanford University, BS Computer Science
        COMPANY_ADDRESS:
          type: string
          example: 456 Business Ave
        COMPANY_DESCRIPTION:
          type: string
          example: Technology solutions provider
        COMPANY_DOMAIN:
          type: string
          example: acmecorp.com
        COMPANY_EMPLOYEE_COUNT:
          type: string
          example: 100-500
        COMPANY_LINKEDIN_URL:
          type: string
          example: https://linkedin.com/company/acmecorp
        COMPANY_NAME:
          type: string
          example: Acme Corp
        COMPANY_PHONE:
          type: string
          example: '+14155550000'
        COMPANY_REVENUE:
          type: string
          example: $10M-$50M
        COMPANY_SIC:
          type: string
          example: '7371'
        COMPANY_NAICS:
          type: string
          example: '541511'
        COMPANY_CITY:
          type: string
          example: San Francisco
        COMPANY_STATE:
          type: string
          example: CA
        COMPANY_ZIP:
          type: string
          example: '94107'
        COMPANY_INDUSTRY:
          type: string
          example: Technology
        LINKEDIN_URL:
          type: string
          example: https://linkedin.com/in/johndoe
        TWITTER_URL:
          type: string
          example: https://twitter.com/johndoe
        FACEBOOK_URL:
          type: string
          example: https://facebook.com/johndoe
        SOCIAL_CONNECTIONS:
          type: string
          example: 500+
        SKILLS:
          type: string
          example: Python, Go, JavaScript
        INTERESTS:
          type: string
          example: Technology, Startups
        SKIPTRACE_MATCH_SCORE:
          type: integer
          nullable: true
          example: 95
        SKIPTRACE_NAME:
          type: string
          example: John Doe
        SKIPTRACE_ADDRESS:
          type: string
          example: 123 Main St
        SKIPTRACE_CITY:
          type: string
          example: San Francisco
        SKIPTRACE_STATE:
          type: string
          example: CA
        SKIPTRACE_ZIP:
          type: string
          example: '94105'
        SKIPTRACE_LANDLINE_NUMBERS:
          type: string
          example: '+14155551111'
        SKIPTRACE_WIRELESS_NUMBERS:
          type: string
          example: '+14155552222'
        SKIPTRACE_CREDIT_RATING:
          type: string
          example: Good
        SKIPTRACE_DNC:
          type: string
          example: 'No'
        SKIPTRACE_EXACT_AGE:
          type: string
          example: '32'
        SKIPTRACE_ETHNIC_CODE:
          type: string
          example: A
        SKIPTRACE_LANGUAGE_CODE:
          type: string
          example: EN
        SKIPTRACE_IP:
          type: string
          example: 192.168.1.1
        SKIPTRACE_B2B_ADDRESS:
          type: string
          example: 456 Business Ave
        SKIPTRACE_B2B_PHONE:
          type: string
          example: '+14155550000'
        SKIPTRACE_B2B_SOURCE:
          type: string
          example: LinkedIn
        SKIPTRACE_B2B_WEBSITE:
          type: string
          example: https://acmecorp.com
        VALID_PHONES:
          type: string
          example: +14155551234,+14155555678
    PixelResolutionV4:
      type: object
      description: Resolution data containing enrichment fields for v4 (UPPER_CASE keys)
      properties:
        FIRST_NAME:
          type: string
          example: John
        LAST_NAME:
          type: string
          example: Doe
        PERSONAL_ADDRESS:
          type: string
          example: 123 Main St
        PERSONAL_CITY:
          type: string
          example: San Francisco
        PERSONAL_STATE:
          type: string
          example: CA
        PERSONAL_ZIP:
          type: string
          example: '94105'
        PERSONAL_ZIP4:
          type: string
          example: '1234'
        AGE_RANGE:
          type: string
          example: 25-34
        CHILDREN:
          type: string
          example: 'Yes'
        GENDER:
          type: string
          example: Male
        HOMEOWNER:
          type: string
          example: 'Yes'
        MARRIED:
          type: string
          example: 'No'
        NET_WORTH:
          type: string
          example: $100K-$250K
        INCOME_RANGE:
          type: string
          example: $75K-$100K
        ALL_LANDLINES:
          type: string
          example: '+14155551234'
        LANDLINE_DNC:
          type: string
          example: 'No'
        ALL_MOBILES:
          type: string
          example: '+14155555678'
        MOBILE_DNC:
          type: string
          example: 'No'
        PERSONAL_EMAILS:
          type: string
          example: john.doe@email.com
        PERSONAL_VERIFIED_EMAILS:
          type: string
          example: john.doe@email.com
        SHA256_PERSONAL_EMAIL:
          type: string
          example: a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3
        COMPANY_NAME:
          type: string
          example: Acme Corp
        COMPANY_DESCRIPTION:
          type: string
          example: Technology solutions provider
        COMPANY_EMPLOYEE_COUNT:
          type: string
          example: 100-500
        COMPANY_DOMAIN:
          type: string
          example: acmecorp.com
        COMPANY_ADDRESS:
          type: string
          example: 456 Business Ave
        COMPANY_CITY:
          type: string
          example: San Francisco
        COMPANY_STATE:
          type: string
          example: CA
        COMPANY_ZIP:
          type: string
          example: '94107'
        COMPANY_PHONE:
          type: string
          example: '+14155550000'
        COMPANY_REVENUE:
          type: string
          example: $10M-$50M
        COMPANY_SIC:
          type: string
          example: '7371'
        COMPANY_NAICS:
          type: string
          example: '541511'
        COMPANY_INDUSTRY:
          type: string
          example: Technology
        BUSINESS_EMAIL:
          type: string
          example: jdoe@acmecorp.com
        BUSINESS_VERIFIED_EMAILS:
          type: string
          example: jdoe@acmecorp.com
        SHA256_BUSINESS_EMAIL:
          type: string
          example: b665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae4
        JOB_TITLE:
          type: string
          example: Senior Software Engineer
        HEADLINE:
          type: string
          example: Building great software
        DEPARTMENT:
          type: string
          example: Engineering
        SENIORITY_LEVEL:
          type: string
          example: Senior
        INFERRED_YEARS_EXPERIENCE:
          type: string
          example: '10'
        COMPANY_NAME_HISTORY:
          type: string
          example: Previous Corp, Another Inc
        JOB_TITLE_HISTORY:
          type: string
          example: Software Engineer, Junior Developer
        EDUCATION_HISTORY:
          type: string
          example: Stanford University, BS Computer Science
        COMPANY_LINKEDIN_URL:
          type: string
          example: https://linkedin.com/company/acmecorp
        INDIVIDUAL_LINKEDIN_URL:
          type: string
          example: https://linkedin.com/in/johndoe
        INDIVIDUAL_TWITTER_URL:
          type: string
          example: https://twitter.com/johndoe
        INDIVIDUAL_FACEBOOK_URL:
          type: string
          example: https://facebook.com/johndoe
        SKILLS:
          type: string
          example: Python, Go, JavaScript
        INTERESTS:
          type: string
          example: Technology, Startups
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key

````