openapi: 3.0.3
info:
  title: 'Sona Labs API Reference'
  description: ''
  version: 1.0.0
servers:
  -
    url: 'https://api2.sonalabs.com'
tags:
  -
    name: Accounts
    description: ''
  -
    name: Companies
    description: ''
  -
    name: People
    description: ''
components:
  securitySchemes:
    default:
      type: apiKey
      name: x-api-key
      in: header
      description: null
security:
  -
    default: []
paths:
  /resource/profile360/overview:
    get:
      summary: Profile360
      operationId: profile360
      description: "<div class=\"endpoint-header\">\n    <span class=\"get\">GET</span>\n    <span class=\"url\">https://api2.sonalabs.com/resource/profile360/overview</span>\n</div>\n\nUse the Profile360 endpoint to enrich data for one person based on their email address. To process multiple profiles in a single request, use the Bulk Profile360 endpoint instead.\n\nProfile360 relies on the information you pass through the endpoint's parameters to identify and enrich the correct user record. The more specific and accurate the email you provide, the more likely Profile360 will return complete and verified profile data. If you submit a general or invalid email, you may still receive a 200 response, but the response data will indicate that no profile was found or enriched.\n\nBy default, this endpoint returns publicly available identity and professional details, such as name, job title, and profile photo. Attributes like company information, visitor journey, and ad conversions are only included when available in the connected data sources.\n\nCalling this endpoint consumes credits under your Sona pricing plan."
      parameters:
        -
          in: query
          name: email
          description: 'string The email identifier.'
          example: john.doe@example.com
          required: true
          schema:
            type: string
            description: 'string The email identifier.'
            example: john.doe@example.com
            nullable: false
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: success
                  data:
                    identifier: richard@piedpiper.com
                    companyUuid: pp123456-78ab-4cde-9012-345678901234
                    companyName: 'Pied Piper'
                    visitors:
                      - fd5140c26a86ab16644b695c1a859451
                      - 3747a38c5d7412d7baf320e28a611c26
                    ips:
                      - 24.9.178.35
                    journey: []
                    milestones: []
                    adConversions: []
                    fullName: 'Richard Hendricks'
                    firstName: Richard
                    lastName: Hendricks
                    gender: Male
                    jobTitle: 'CEO & Founder'
                    photoUrl: 'https://piedpiper.com/assets/team/richard-hendricks.jpg'
                    createdAt: '2024-03-14T04:56:49'
                    type: Suggested
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      identifier:
                        type: string
                        example: richard@piedpiper.com
                      companyUuid:
                        type: string
                        example: pp123456-78ab-4cde-9012-345678901234
                      companyName:
                        type: string
                        example: 'Pied Piper'
                      visitors:
                        type: array
                        example:
                          - fd5140c26a86ab16644b695c1a859451
                          - 3747a38c5d7412d7baf320e28a611c26
                        items:
                          type: string
                      ips:
                        type: array
                        example:
                          - 24.9.178.35
                        items:
                          type: string
                      journey:
                        type: array
                        example: []
                      milestones:
                        type: array
                        example: []
                      adConversions:
                        type: array
                        example: []
                      fullName:
                        type: string
                        example: 'Richard Hendricks'
                      firstName:
                        type: string
                        example: Richard
                      lastName:
                        type: string
                        example: Hendricks
                      gender:
                        type: string
                        example: Male
                      jobTitle:
                        type: string
                        example: 'CEO & Founder'
                      photoUrl:
                        type: string
                        example: 'https://piedpiper.com/assets/team/richard-hendricks.jpg'
                      createdAt:
                        type: string
                        example: '2024-03-14T04:56:49'
                      type:
                        type: string
                        example: Suggested
        404:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'Profile not found'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'Profile not found'
      tags:
        - Accounts
  /resource/account360/overview:
    get:
      summary: Account360
      operationId: account360
      description: "<div class=\"endpoint-header\">\n   <span class=\"get\">GET</span>\n   <span class=\"url\">https://api2.sonalabs.com/resource/account360/overview</span>\n</div>\n\nUse the Account360 endpoint to retrieve comprehensive account intelligence for a company based on its domain. This endpoint provides a holistic view of account activity, engagement signals, and firmographic data in a single API call.\n\nAccount360 aggregates data across multiple dimensions including visitor activity, intent signals, technology stack, and engagement history. The more interaction data available for a domain in your connected sources, the richer the insights returned. If you query a domain with limited or no tracked activity, you may receive a 200 response with empty arrays for activity-based fields like journey, people, and intent signals.\n\nBy default, this endpoint returns account details, buying stage indicators, ICP scoring, and technology information. Fields like website visitors, intent signals, and people are populated based on available tracking data from your connected data sources.\n\nCalling this endpoint consumes credits under your Sona pricing plan."
      parameters:
        -
          in: query
          name: domain
          description: 'string The domain identifier of the account.'
          example: example.com
          required: true
          schema:
            type: string
            description: 'string The domain identifier of the account.'
            example: example.com
            nullable: false
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: success
                  data:
                    details:
                      name: 'Pied Piper'
                      description: 'Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity.'
                      domain: piedpiper.com
                      type: private
                      phone: +1-650-555-0123
                      uuid: pp123456-78ab-4cde-9012-345678901234
                      createdAt: '2014-04-15T10:30:00'
                      employees: 42
                      employeesRange: 11-50
                      visitorsCount: 156
                      identifiedPeople: 23
                      annualRevenue: 15000000
                      estimatedAnnualRevenue: $10M-$50M
                      foundedYear: 2014
                      streetAddress: '5230 Newell Road'
                      city: 'Palo Alto'
                      postalCode: '94303'
                      state: California
                      country: 'United States'
                      industry: 'Data Compression Technology'
                      subIndustry: 'Data Compression Software'
                      linkedin: company/pied-piper-compression
                    activity: []
                    journey:
                      -
                        date: '2024-03-14'
                        dataLayer: null
                        scrollPercentage: 0
                        source: report
                        duration: null
                        browser: null
                        customTimestamp: null
                        userAgentBrowser: null
                        userAgentOS: null
                        iframe: null
                        event: null
                        segmentAnonymousId: null
                        key: null
                        email: null
                        eventId: null
                        identifier: richard@piedpiper.com
                        timeSpent: 0
                        ip: null
                        isMilestone: true
                        adblocker: null
                        params: null
                        version: null
                        userId: null
                        utm:
                          channelSubchannel: 'With intent signal'
                          ad: null
                          adId: null
                          color: null
                          campaignId: null
                          adgroupId: null
                          campaign: null
                          term: null
                          source: 'With intent signal'
                          medium: null
                          content: null
                          adgroup: null
                        referrer: null
                        userAgentModel: null
                        deviceInformation: null
                        customIndex: null
                        phone: null
                        meta: null
                        customEvent: null
                        pageParams: null
                        userAgentType: null
                        hitTimestamp: '2024-03-14T05:00:08'
                        name: 'With intent signal'
                        ajaxResponse: null
                        formData: null
                        attributes:
                          'Buying Stage': Purchase
                        page: null
                        time: '05:00:08'
                        visitorId: null
                      -
                        date: '2024-03-14'
                        dataLayer: null
                        scrollPercentage: 0
                        source: report
                        duration: null
                        browser: null
                        customTimestamp: null
                        userAgentBrowser: null
                        userAgentOS: null
                        iframe: null
                        event: null
                        segmentAnonymousId: null
                        key: null
                        email: null
                        eventId: null
                        identifier: dinesh@piedpiper.com
                        timeSpent: 0
                        ip: null
                        isMilestone: true
                        adblocker: null
                        params: null
                        version: null
                        userId: null
                        utm:
                          channelSubchannel: 'With intent signal'
                          ad: null
                          adId: null
                          color: '#4A6AF2'
                          campaignId: null
                          adgroupId: null
                          campaign: null
                          term: null
                          source: 'With intent signal'
                          medium: null
                          content: null
                          adgroup: null
                        referrer: null
                        userAgentModel: null
                        deviceInformation: null
                        customIndex: null
                        phone: null
                        meta: null
                        customEvent: null
                        pageParams: null
                        userAgentType: null
                        hitTimestamp: '2024-03-14T05:00:08'
                        name: 'With intent signal'
                        ajaxResponse: null
                        formData: null
                        attributes:
                          'Buying Stage': Purchase
                        page: null
                        time: '05:00:08'
                        visitorId: null
                    people: []
                    intentSignals:
                      - 'Visited Website'
                    intentTrends: []
                    sessionsDuration: 7
                    totalActiveTime: 0
                    buyingStage: Awareness
                    lifecycleStage: ''
                    icpScore: 17
                    websiteVisitors: []
                    topPages: []
                    tags:
                      - 'Data Compression'
                      - Technology
                      - Software
                      - Startup
                      - 'Silicon Valley'
                      - Enterprise
                      - 'Cloud Computing'
                      - B2B
                    tech:
                      - python
                      - javascript
                      - react
                      - nodejs
                      - mongodb
                      - aws
                      - docker
                      - kubernetes
                      - redis
                      - nginx
                      - google_analytics
                      - stripe
                      - github
                      - slack
                    techCategories:
                      - programming_languages
                      - web_frameworks
                      - databases
                      - cloud_computing_services
                      - containerization
                      - web_servers
                      - analytics
                      - payment_processing
                      - version_control
                      - communication
                      - development_tools
                      - data_compression
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      details:
                        type: object
                        properties:
                          name:
                            type: string
                            example: 'Pied Piper'
                          description:
                            type: string
                            example: 'Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity.'
                          domain:
                            type: string
                            example: piedpiper.com
                          type:
                            type: string
                            example: private
                          phone:
                            type: string
                            example: +1-650-555-0123
                          uuid:
                            type: string
                            example: pp123456-78ab-4cde-9012-345678901234
                          createdAt:
                            type: string
                            example: '2014-04-15T10:30:00'
                          employees:
                            type: integer
                            example: 42
                          employeesRange:
                            type: string
                            example: 11-50
                          visitorsCount:
                            type: integer
                            example: 156
                          identifiedPeople:
                            type: integer
                            example: 23
                          annualRevenue:
                            type: integer
                            example: 15000000
                          estimatedAnnualRevenue:
                            type: string
                            example: $10M-$50M
                          foundedYear:
                            type: integer
                            example: 2014
                          streetAddress:
                            type: string
                            example: '5230 Newell Road'
                          city:
                            type: string
                            example: 'Palo Alto'
                          postalCode:
                            type: string
                            example: '94303'
                          state:
                            type: string
                            example: California
                          country:
                            type: string
                            example: 'United States'
                          industry:
                            type: string
                            example: 'Data Compression Technology'
                          subIndustry:
                            type: string
                            example: 'Data Compression Software'
                          linkedin:
                            type: string
                            example: company/pied-piper-compression
                      activity:
                        type: array
                        example: []
                      journey:
                        type: array
                        example:
                          -
                            date: '2024-03-14'
                            dataLayer: null
                            scrollPercentage: 0
                            source: report
                            duration: null
                            browser: null
                            customTimestamp: null
                            userAgentBrowser: null
                            userAgentOS: null
                            iframe: null
                            event: null
                            segmentAnonymousId: null
                            key: null
                            email: null
                            eventId: null
                            identifier: richard@piedpiper.com
                            timeSpent: 0
                            ip: null
                            isMilestone: true
                            adblocker: null
                            params: null
                            version: null
                            userId: null
                            utm:
                              channelSubchannel: 'With intent signal'
                              ad: null
                              adId: null
                              color: null
                              campaignId: null
                              adgroupId: null
                              campaign: null
                              term: null
                              source: 'With intent signal'
                              medium: null
                              content: null
                              adgroup: null
                            referrer: null
                            userAgentModel: null
                            deviceInformation: null
                            customIndex: null
                            phone: null
                            meta: null
                            customEvent: null
                            pageParams: null
                            userAgentType: null
                            hitTimestamp: '2024-03-14T05:00:08'
                            name: 'With intent signal'
                            ajaxResponse: null
                            formData: null
                            attributes:
                              'Buying Stage': Purchase
                            page: null
                            time: '05:00:08'
                            visitorId: null
                          -
                            date: '2024-03-14'
                            dataLayer: null
                            scrollPercentage: 0
                            source: report
                            duration: null
                            browser: null
                            customTimestamp: null
                            userAgentBrowser: null
                            userAgentOS: null
                            iframe: null
                            event: null
                            segmentAnonymousId: null
                            key: null
                            email: null
                            eventId: null
                            identifier: dinesh@piedpiper.com
                            timeSpent: 0
                            ip: null
                            isMilestone: true
                            adblocker: null
                            params: null
                            version: null
                            userId: null
                            utm:
                              channelSubchannel: 'With intent signal'
                              ad: null
                              adId: null
                              color: '#4A6AF2'
                              campaignId: null
                              adgroupId: null
                              campaign: null
                              term: null
                              source: 'With intent signal'
                              medium: null
                              content: null
                              adgroup: null
                            referrer: null
                            userAgentModel: null
                            deviceInformation: null
                            customIndex: null
                            phone: null
                            meta: null
                            customEvent: null
                            pageParams: null
                            userAgentType: null
                            hitTimestamp: '2024-03-14T05:00:08'
                            name: 'With intent signal'
                            ajaxResponse: null
                            formData: null
                            attributes:
                              'Buying Stage': Purchase
                            page: null
                            time: '05:00:08'
                            visitorId: null
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              example: '2024-03-14'
                            dataLayer:
                              type: string
                              example: null
                            scrollPercentage:
                              type: integer
                              example: 0
                            source:
                              type: string
                              example: report
                            duration:
                              type: string
                              example: null
                            browser:
                              type: string
                              example: null
                            customTimestamp:
                              type: string
                              example: null
                            userAgentBrowser:
                              type: string
                              example: null
                            userAgentOS:
                              type: string
                              example: null
                            iframe:
                              type: string
                              example: null
                            event:
                              type: string
                              example: null
                            segmentAnonymousId:
                              type: string
                              example: null
                            key:
                              type: string
                              example: null
                            email:
                              type: string
                              example: null
                            eventId:
                              type: string
                              example: null
                            identifier:
                              type: string
                              example: richard@piedpiper.com
                            timeSpent:
                              type: integer
                              example: 0
                            ip:
                              type: string
                              example: null
                            isMilestone:
                              type: boolean
                              example: true
                            adblocker:
                              type: string
                              example: null
                            params:
                              type: string
                              example: null
                            version:
                              type: string
                              example: null
                            userId:
                              type: string
                              example: null
                            utm:
                              type: object
                              properties:
                                channelSubchannel:
                                  type: string
                                  example: 'With intent signal'
                                ad:
                                  type: string
                                  example: null
                                adId:
                                  type: string
                                  example: null
                                color:
                                  type: string
                                  example: null
                                campaignId:
                                  type: string
                                  example: null
                                adgroupId:
                                  type: string
                                  example: null
                                campaign:
                                  type: string
                                  example: null
                                term:
                                  type: string
                                  example: null
                                source:
                                  type: string
                                  example: 'With intent signal'
                                medium:
                                  type: string
                                  example: null
                                content:
                                  type: string
                                  example: null
                                adgroup:
                                  type: string
                                  example: null
                            referrer:
                              type: string
                              example: null
                            userAgentModel:
                              type: string
                              example: null
                            deviceInformation:
                              type: string
                              example: null
                            customIndex:
                              type: string
                              example: null
                            phone:
                              type: string
                              example: null
                            meta:
                              type: string
                              example: null
                            customEvent:
                              type: string
                              example: null
                            pageParams:
                              type: string
                              example: null
                            userAgentType:
                              type: string
                              example: null
                            hitTimestamp:
                              type: string
                              example: '2024-03-14T05:00:08'
                            name:
                              type: string
                              example: 'With intent signal'
                            ajaxResponse:
                              type: string
                              example: null
                            formData:
                              type: string
                              example: null
                            attributes:
                              type: object
                              properties:
                                'Buying Stage':
                                  type: string
                                  example: Purchase
                            page:
                              type: string
                              example: null
                            time:
                              type: string
                              example: '05:00:08'
                            visitorId:
                              type: string
                              example: null
                      people:
                        type: array
                        example: []
                      intentSignals:
                        type: array
                        example:
                          - 'Visited Website'
                        items:
                          type: string
                      intentTrends:
                        type: array
                        example: []
                      sessionsDuration:
                        type: integer
                        example: 7
                      totalActiveTime:
                        type: integer
                        example: 0
                      buyingStage:
                        type: string
                        example: Awareness
                      lifecycleStage:
                        type: string
                        example: ''
                      icpScore:
                        type: integer
                        example: 17
                      websiteVisitors:
                        type: array
                        example: []
                      topPages:
                        type: array
                        example: []
                      tags:
                        type: array
                        example:
                          - 'Data Compression'
                          - Technology
                          - Software
                          - Startup
                          - 'Silicon Valley'
                          - Enterprise
                          - 'Cloud Computing'
                          - B2B
                        items:
                          type: string
                      tech:
                        type: array
                        example:
                          - python
                          - javascript
                          - react
                          - nodejs
                          - mongodb
                          - aws
                          - docker
                          - kubernetes
                          - redis
                          - nginx
                          - google_analytics
                          - stripe
                          - github
                          - slack
                        items:
                          type: string
                      techCategories:
                        type: array
                        example:
                          - programming_languages
                          - web_frameworks
                          - databases
                          - cloud_computing_services
                          - containerization
                          - web_servers
                          - analytics
                          - payment_processing
                          - version_control
                          - communication
                          - development_tools
                          - data_compression
                        items:
                          type: string
        404:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'Account not found'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'Account not found'
      tags:
        - Accounts
  /resource/companies/search:
    post:
      summary: 'Company Search'
      operationId: companySearch
      description: "<div class=\"endpoint-header\">\n    <span class=\"post\">POST</span>\n    <span class=\"url\">https://api2.sonalabs.com/resource/companies/search</span>\n</div>\n\nUse the Company Search endpoint to discover and filter companies based on various firmographic criteria. This endpoint allows you to search through thousands of company records using parameters like domain, name, industry, and location to find organizations that match your ideal customer profile.\n\nCompany Search supports flexible filtering by combining multiple parameters to narrow down results. You can search by specific domains, company names, industries, or geographic locations. The endpoint returns paginated results with detailed company information including firmographic data, technology stack, social media profiles, and estimated revenue ranges.\n\nThe response includes comprehensive company details such as employee count ranges, founding year, headquarters location, industry classifications, and technology categories. Each company record also provides social media URLs, website traffic estimates, and advertising activity indicators when available in the database.\n\nCalling this endpoint consumes credits under your Sona pricing plan."
      parameters:
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.22
                  status: success
                  data:
                    list:
                      -
                        website: piedpiper.com
                        name: 'Pied Piper'
                        founded: 2014
                        employeesRange: 11-50
                        locality: 'Palo Alto'
                        region: California
                        country: 'United States'
                        industry: 'Data Compression Technology'
                        tech:
                          - Python
                          - JavaScript
                          - React
                          - Node.js
                          - MongoDB
                          - AWS
                        techCategories:
                          - 'Data Compression'
                          - 'Cloud Computing'
                          - 'Software Development'
                          - 'Information Technology'
                          - 'Artificial Intelligence'
                          - 'Machine Learning'
                        minEstimatedAnnualRevenue: 5000000
                        maxEstimatedAnnualRevenue: 25000000
                        subIndustry: 'Data Compression Software'
                        lat: 37.4419
                        lng: -122.143
                        description: "Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity. Founded by Richard Hendricks, we're transforming how the world stores and transmits data, making the internet faster and more efficient for everyone. Our platform serves enterprise clients looking to optimize their data storage costs and improve transfer speeds."
                        logo: 'https://piedpiper.com/assets/logo.png'
                        type: 'Private Company'
                        timezone: America/Los_Angeles
                        employees: 42
                        annualRevenue: 15000000
                        estimatedAnnualRevenue: $10M-$50M
                        streetAddress: '5230 Newell Road'
                        city: 'Palo Alto'
                        postalCode: '94303'
                        phone: +1-650-555-0123
                        state: California
                        tags:
                          - startup
                          - compression
                          - technology
                          - silicon-valley
                          - b2b
                        ips:
                          - 192.168.1.100
                          - 10.0.0.50
                        category: Technology
                        subCategory: 'Data Management'
                        tagline: 'Making data smaller, faster, better'
                        specialties: 'Lossless data compression, Enterprise data solutions, Cloud storage optimization'
                        ads30days: 15
                        ads365days: 180
                        adsYTD: 145
                        socialHandles: '@piedpipertech'
                        linkedinUrl: linkedin.com/company/pied-piper-compression
                        facebookUrl: facebook.com/piedpipertech
                        twitterUrl: twitter.com/piedpipertech
                        instagramUrl: instagram.com/piedpipertech
                        youtubeUrl: youtube.com/c/piedpipertech
                        tiktokUrl: tiktok.com/@piedpipertech
                        pinterestUrl: pinterest.com/piedpipertech
                        githubUrl: github.com/piedpiper
                        discordUrl: discord.gg/piedpiper
                        telegramUrl: t.me/piedpipertech
                        redditUrl: reddit.com/r/piedpiper
                        snapchatUrl: snapchat.com/add/piedpipertech
                        mediumUrl: medium.com/@piedpiper
                        twitchUrl: twitch.tv/piedpipertech
                        crunchbaseUrl: crunchbase.com/organization/pied-piper
                        g2Url: g2.com/products/pied-piper
                        organicKeywords: 2500
                        organicTraffic: 45000
                        organicCost: 125000
                        adwordsKeywords: 150
                        adwordsTraffic: 8500
                        adwordsCost: 25000
                    total: 2321
                    page: 1
                    offset: 0
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.22
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      list:
                        type: array
                        example:
                          -
                            website: piedpiper.com
                            name: 'Pied Piper'
                            founded: 2014
                            employeesRange: 11-50
                            locality: 'Palo Alto'
                            region: California
                            country: 'United States'
                            industry: 'Data Compression Technology'
                            tech:
                              - Python
                              - JavaScript
                              - React
                              - Node.js
                              - MongoDB
                              - AWS
                            techCategories:
                              - 'Data Compression'
                              - 'Cloud Computing'
                              - 'Software Development'
                              - 'Information Technology'
                              - 'Artificial Intelligence'
                              - 'Machine Learning'
                            minEstimatedAnnualRevenue: 5000000
                            maxEstimatedAnnualRevenue: 25000000
                            subIndustry: 'Data Compression Software'
                            lat: 37.4419
                            lng: -122.143
                            description: "Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity. Founded by Richard Hendricks, we're transforming how the world stores and transmits data, making the internet faster and more efficient for everyone. Our platform serves enterprise clients looking to optimize their data storage costs and improve transfer speeds."
                            logo: 'https://piedpiper.com/assets/logo.png'
                            type: 'Private Company'
                            timezone: America/Los_Angeles
                            employees: 42
                            annualRevenue: 15000000
                            estimatedAnnualRevenue: $10M-$50M
                            streetAddress: '5230 Newell Road'
                            city: 'Palo Alto'
                            postalCode: '94303'
                            phone: +1-650-555-0123
                            state: California
                            tags:
                              - startup
                              - compression
                              - technology
                              - silicon-valley
                              - b2b
                            ips:
                              - 192.168.1.100
                              - 10.0.0.50
                            category: Technology
                            subCategory: 'Data Management'
                            tagline: 'Making data smaller, faster, better'
                            specialties: 'Lossless data compression, Enterprise data solutions, Cloud storage optimization'
                            ads30days: 15
                            ads365days: 180
                            adsYTD: 145
                            socialHandles: '@piedpipertech'
                            linkedinUrl: linkedin.com/company/pied-piper-compression
                            facebookUrl: facebook.com/piedpipertech
                            twitterUrl: twitter.com/piedpipertech
                            instagramUrl: instagram.com/piedpipertech
                            youtubeUrl: youtube.com/c/piedpipertech
                            tiktokUrl: tiktok.com/@piedpipertech
                            pinterestUrl: pinterest.com/piedpipertech
                            githubUrl: github.com/piedpiper
                            discordUrl: discord.gg/piedpiper
                            telegramUrl: t.me/piedpipertech
                            redditUrl: reddit.com/r/piedpiper
                            snapchatUrl: snapchat.com/add/piedpipertech
                            mediumUrl: medium.com/@piedpiper
                            twitchUrl: twitch.tv/piedpipertech
                            crunchbaseUrl: crunchbase.com/organization/pied-piper
                            g2Url: g2.com/products/pied-piper
                            organicKeywords: 2500
                            organicTraffic: 45000
                            organicCost: 125000
                            adwordsKeywords: 150
                            adwordsTraffic: 8500
                            adwordsCost: 25000
                        items:
                          type: object
                          properties:
                            website:
                              type: string
                              example: piedpiper.com
                            name:
                              type: string
                              example: 'Pied Piper'
                            founded:
                              type: integer
                              example: 2014
                            employeesRange:
                              type: string
                              example: 11-50
                            locality:
                              type: string
                              example: 'Palo Alto'
                            region:
                              type: string
                              example: California
                            country:
                              type: string
                              example: 'United States'
                            industry:
                              type: string
                              example: 'Data Compression Technology'
                            tech:
                              type: array
                              example:
                                - Python
                                - JavaScript
                                - React
                                - Node.js
                                - MongoDB
                                - AWS
                              items:
                                type: string
                            techCategories:
                              type: array
                              example:
                                - 'Data Compression'
                                - 'Cloud Computing'
                                - 'Software Development'
                                - 'Information Technology'
                                - 'Artificial Intelligence'
                                - 'Machine Learning'
                              items:
                                type: string
                            minEstimatedAnnualRevenue:
                              type: integer
                              example: 5000000
                            maxEstimatedAnnualRevenue:
                              type: integer
                              example: 25000000
                            subIndustry:
                              type: string
                              example: 'Data Compression Software'
                            lat:
                              type: number
                              example: 37.4419
                            lng:
                              type: number
                              example: -122.143
                            description:
                              type: string
                              example: "Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity. Founded by Richard Hendricks, we're transforming how the world stores and transmits data, making the internet faster and more efficient for everyone. Our platform serves enterprise clients looking to optimize their data storage costs and improve transfer speeds."
                            logo:
                              type: string
                              example: 'https://piedpiper.com/assets/logo.png'
                            type:
                              type: string
                              example: 'Private Company'
                            timezone:
                              type: string
                              example: America/Los_Angeles
                            employees:
                              type: integer
                              example: 42
                            annualRevenue:
                              type: integer
                              example: 15000000
                            estimatedAnnualRevenue:
                              type: string
                              example: $10M-$50M
                            streetAddress:
                              type: string
                              example: '5230 Newell Road'
                            city:
                              type: string
                              example: 'Palo Alto'
                            postalCode:
                              type: string
                              example: '94303'
                            phone:
                              type: string
                              example: +1-650-555-0123
                            state:
                              type: string
                              example: California
                            tags:
                              type: array
                              example:
                                - startup
                                - compression
                                - technology
                                - silicon-valley
                                - b2b
                              items:
                                type: string
                            ips:
                              type: array
                              example:
                                - 192.168.1.100
                                - 10.0.0.50
                              items:
                                type: string
                            category:
                              type: string
                              example: Technology
                            subCategory:
                              type: string
                              example: 'Data Management'
                            tagline:
                              type: string
                              example: 'Making data smaller, faster, better'
                            specialties:
                              type: string
                              example: 'Lossless data compression, Enterprise data solutions, Cloud storage optimization'
                            ads30days:
                              type: integer
                              example: 15
                            ads365days:
                              type: integer
                              example: 180
                            adsYTD:
                              type: integer
                              example: 145
                            socialHandles:
                              type: string
                              example: '@piedpipertech'
                            linkedinUrl:
                              type: string
                              example: linkedin.com/company/pied-piper-compression
                            facebookUrl:
                              type: string
                              example: facebook.com/piedpipertech
                            twitterUrl:
                              type: string
                              example: twitter.com/piedpipertech
                            instagramUrl:
                              type: string
                              example: instagram.com/piedpipertech
                            youtubeUrl:
                              type: string
                              example: youtube.com/c/piedpipertech
                            tiktokUrl:
                              type: string
                              example: tiktok.com/@piedpipertech
                            pinterestUrl:
                              type: string
                              example: pinterest.com/piedpipertech
                            githubUrl:
                              type: string
                              example: github.com/piedpiper
                            discordUrl:
                              type: string
                              example: discord.gg/piedpiper
                            telegramUrl:
                              type: string
                              example: t.me/piedpipertech
                            redditUrl:
                              type: string
                              example: reddit.com/r/piedpiper
                            snapchatUrl:
                              type: string
                              example: snapchat.com/add/piedpipertech
                            mediumUrl:
                              type: string
                              example: medium.com/@piedpiper
                            twitchUrl:
                              type: string
                              example: twitch.tv/piedpipertech
                            crunchbaseUrl:
                              type: string
                              example: crunchbase.com/organization/pied-piper
                            g2Url:
                              type: string
                              example: g2.com/products/pied-piper
                            organicKeywords:
                              type: integer
                              example: 2500
                            organicTraffic:
                              type: integer
                              example: 45000
                            organicCost:
                              type: integer
                              example: 125000
                            adwordsKeywords:
                              type: integer
                              example: 150
                            adwordsTraffic:
                              type: integer
                              example: 8500
                            adwordsCost:
                              type: integer
                              example: 25000
                      total:
                        type: integer
                        example: 2321
                      page:
                        type: integer
                        example: 1
                      offset:
                        type: integer
                        example: 0
        400:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'Please provide at least one filter.'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'Please provide at least one filter.'
        404:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'No results found'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'No results found'
      tags:
        - Companies
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                filters:
                  type: array
                  description: 'An array of filter objects. Each filter object contains 3 attributes: field, operator, and value.'
                  example:
                    -
                      field: name
                      operator: contains
                      value: Apple
                    -
                      field: industry
                      operator: '='
                      value: Technology
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                        description: 'The field to filter on. Supported fields: `name`, `logo`, `website`, `industry`, `country`, `city`, `state`, `postalCode`, `linkedinUrl`, `tech`, `techCategories`, `founded`, `employeesRange`, `employees`, `description`, `tags`, `annualRevenue`, `estimatedAnnualRevenue`, `minEstimatedAnnualRevenue`, `maxEstimatedAnnualRevenue`, `type`, `timezone`, `phone`, `streetAddress`, `lat`, `lng`, `subIndustry`, `ips`, `category`, `subCategory`, `tagline`, `specialties`, `ads30days`, `ads365days`, `adsYTD`, `socialHandles`, `facebookUrl`, `twitterUrl`, `instagramUrl`, `youtubeUrl`, `tiktokUrl`, `pinterestUrl`, `githubUrl`, `discordUrl`, `telegramUrl`, `redditUrl`, `snapchatUrl`, `mediumUrl`, `twitchUrl`, `crunchbaseUrl`, `g2Url`, `organicKeywords`, `organicTraffic`, `organicCost`, `adwordsKeywords`, `adwordsTraffic`, `adwordsCost`, `founderIdentifiers`, `numFounders`'
                        example: null
                        nullable: false
                      operator:
                        type: string
                        description: 'The filter operator. Supported operators: `is not empty`, `contains`, `=`, `>`, `<`, `>=`, `<=`, `<>`, `range`, `in set (exact)`, `in set (phrase)`, `starts with`, `does not contain`, `is empty`'
                        example: null
                        nullable: false
                      value:
                        type: string
                        description: 'The value to filter by. In the case of `is not empty` and `is empty` operators this is not required.'
                        example: null
                        nullable: false
                    required:
                      - field
                      - operator
                      - value
              required:
                - filters
  /resource/company/enrich:
    get:
      summary: 'Company Enrichment'
      operationId: companyEnrichment
      description: "<div class=\"endpoint-header\">\n    <span class=\"get\">GET</span>\n    <span class=\"url\">https://api2.sonalabs.com/resource/company/enrich</span>\n</div>\n\nUse the Company Enrichment endpoint to enrich data for a single company. To enrich data for multiple companies with a single API call, use the Bulk Company Enrichment endpoint instead.\n\nThe API relies on the company domain you provide via the website parameter to identify and retrieve comprehensive company information from the database. Providing an accurate and complete domain ensures the highest match rate and data quality.\n\nBy default, this endpoint returns a wide range of company attributes including firmographic data, social media profiles, technology usage, and revenue estimates. The response includes company details such as founding year, employee count, location, industry classification, and estimated annual revenue ranges.\n\nImportant: Calling this endpoint consumes credits as part of your pricing plan."
      parameters:
        -
          in: query
          name: website
          description: 'The domain identifier of the company.'
          example: ifs.com
          required: true
          schema:
            type: string
            description: 'The domain identifier of the company.'
            example: ifs.com
            nullable: false
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.22
                  status: success
                  data:
                    website: piedpiper.com
                    name: 'Pied Piper'
                    founded: 2014
                    employeesRange: 11-50
                    locality: 'Palo Alto'
                    region: California
                    country: 'United States'
                    industry: 'Data Compression Technology'
                    tech:
                      - Python
                      - JavaScript
                      - React
                      - Node.js
                      - MongoDB
                      - AWS
                    techCategories:
                      - 'Data Compression'
                      - 'Cloud Computing'
                      - 'Software Development'
                      - 'Information Technology'
                      - 'Artificial Intelligence'
                      - 'Machine Learning'
                    minEstimatedAnnualRevenue: 5000000
                    maxEstimatedAnnualRevenue: 25000000
                    subIndustry: 'Data Compression Software'
                    lat: 37.4419
                    lng: -122.143
                    description: "Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity. Founded by Richard Hendricks, we're transforming how the world stores and transmits data, making the internet faster and more efficient for everyone. Our platform serves enterprise clients looking to optimize their data storage costs and improve transfer speeds."
                    logo: 'https://piedpiper.com/assets/logo.png'
                    type: 'Private Company'
                    timezone: America/Los_Angeles
                    employees: 42
                    annualRevenue: 15000000
                    estimatedAnnualRevenue: $10M-$50M
                    streetAddress: '5230 Newell Road'
                    city: 'Palo Alto'
                    postalCode: '94303'
                    phone: +1-650-555-0123
                    state: California
                    tags:
                      - startup
                      - compression
                      - technology
                      - silicon-valley
                      - b2b
                    ips:
                      - 192.168.1.100
                      - 10.0.0.50
                    category: Technology
                    subCategory: 'Data Management'
                    tagline: 'Making data smaller, faster, better'
                    specialties: 'Lossless data compression, Enterprise data solutions, Cloud storage optimization'
                    ads30days: 15
                    ads365days: 180
                    adsYTD: 145
                    socialHandles: '@piedpipertech'
                    linkedinUrl: linkedin.com/company/pied-piper-compression
                    facebookUrl: facebook.com/piedpipertech
                    twitterUrl: twitter.com/piedpipertech
                    instagramUrl: instagram.com/piedpipertech
                    youtubeUrl: youtube.com/c/piedpipertech
                    tiktokUrl: tiktok.com/@piedpipertech
                    pinterestUrl: pinterest.com/piedpipertech
                    githubUrl: github.com/piedpiper
                    discordUrl: discord.gg/piedpiper
                    telegramUrl: t.me/piedpipertech
                    redditUrl: reddit.com/r/piedpiper
                    snapchatUrl: snapchat.com/add/piedpipertech
                    mediumUrl: medium.com/@piedpiper
                    twitchUrl: twitch.tv/piedpipertech
                    crunchbaseUrl: crunchbase.com/organization/pied-piper
                    g2Url: g2.com/products/pied-piper
                    organicKeywords: 2500
                    organicTraffic: 45000
                    organicCost: 125000
                    adwordsKeywords: 150
                    adwordsTraffic: 8500
                    adwordsCost: 25000
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.22
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      website:
                        type: string
                        example: piedpiper.com
                      name:
                        type: string
                        example: 'Pied Piper'
                      founded:
                        type: integer
                        example: 2014
                      employeesRange:
                        type: string
                        example: 11-50
                      locality:
                        type: string
                        example: 'Palo Alto'
                      region:
                        type: string
                        example: California
                      country:
                        type: string
                        example: 'United States'
                      industry:
                        type: string
                        example: 'Data Compression Technology'
                      tech:
                        type: array
                        example:
                          - Python
                          - JavaScript
                          - React
                          - Node.js
                          - MongoDB
                          - AWS
                        items:
                          type: string
                      techCategories:
                        type: array
                        example:
                          - 'Data Compression'
                          - 'Cloud Computing'
                          - 'Software Development'
                          - 'Information Technology'
                          - 'Artificial Intelligence'
                          - 'Machine Learning'
                        items:
                          type: string
                      minEstimatedAnnualRevenue:
                        type: integer
                        example: 5000000
                      maxEstimatedAnnualRevenue:
                        type: integer
                        example: 25000000
                      subIndustry:
                        type: string
                        example: 'Data Compression Software'
                      lat:
                        type: number
                        example: 37.4419
                      lng:
                        type: number
                        example: -122.143
                      description:
                        type: string
                        example: "Pied Piper is a revolutionary data compression company that has developed a groundbreaking lossless compression algorithm. Our proprietary technology achieves unprecedented compression ratios while maintaining perfect data integrity. Founded by Richard Hendricks, we're transforming how the world stores and transmits data, making the internet faster and more efficient for everyone. Our platform serves enterprise clients looking to optimize their data storage costs and improve transfer speeds."
                      logo:
                        type: string
                        example: 'https://piedpiper.com/assets/logo.png'
                      type:
                        type: string
                        example: 'Private Company'
                      timezone:
                        type: string
                        example: America/Los_Angeles
                      employees:
                        type: integer
                        example: 42
                      annualRevenue:
                        type: integer
                        example: 15000000
                      estimatedAnnualRevenue:
                        type: string
                        example: $10M-$50M
                      streetAddress:
                        type: string
                        example: '5230 Newell Road'
                      city:
                        type: string
                        example: 'Palo Alto'
                      postalCode:
                        type: string
                        example: '94303'
                      phone:
                        type: string
                        example: +1-650-555-0123
                      state:
                        type: string
                        example: California
                      tags:
                        type: array
                        example:
                          - startup
                          - compression
                          - technology
                          - silicon-valley
                          - b2b
                        items:
                          type: string
                      ips:
                        type: array
                        example:
                          - 192.168.1.100
                          - 10.0.0.50
                        items:
                          type: string
                      category:
                        type: string
                        example: Technology
                      subCategory:
                        type: string
                        example: 'Data Management'
                      tagline:
                        type: string
                        example: 'Making data smaller, faster, better'
                      specialties:
                        type: string
                        example: 'Lossless data compression, Enterprise data solutions, Cloud storage optimization'
                      ads30days:
                        type: integer
                        example: 15
                      ads365days:
                        type: integer
                        example: 180
                      adsYTD:
                        type: integer
                        example: 145
                      socialHandles:
                        type: string
                        example: '@piedpipertech'
                      linkedinUrl:
                        type: string
                        example: linkedin.com/company/pied-piper-compression
                      facebookUrl:
                        type: string
                        example: facebook.com/piedpipertech
                      twitterUrl:
                        type: string
                        example: twitter.com/piedpipertech
                      instagramUrl:
                        type: string
                        example: instagram.com/piedpipertech
                      youtubeUrl:
                        type: string
                        example: youtube.com/c/piedpipertech
                      tiktokUrl:
                        type: string
                        example: tiktok.com/@piedpipertech
                      pinterestUrl:
                        type: string
                        example: pinterest.com/piedpipertech
                      githubUrl:
                        type: string
                        example: github.com/piedpiper
                      discordUrl:
                        type: string
                        example: discord.gg/piedpiper
                      telegramUrl:
                        type: string
                        example: t.me/piedpipertech
                      redditUrl:
                        type: string
                        example: reddit.com/r/piedpiper
                      snapchatUrl:
                        type: string
                        example: snapchat.com/add/piedpipertech
                      mediumUrl:
                        type: string
                        example: medium.com/@piedpiper
                      twitchUrl:
                        type: string
                        example: twitch.tv/piedpipertech
                      crunchbaseUrl:
                        type: string
                        example: crunchbase.com/organization/pied-piper
                      g2Url:
                        type: string
                        example: g2.com/products/pied-piper
                      organicKeywords:
                        type: integer
                        example: 2500
                      organicTraffic:
                        type: integer
                        example: 45000
                      organicCost:
                        type: integer
                        example: 125000
                      adwordsKeywords:
                        type: integer
                        example: 150
                      adwordsTraffic:
                        type: integer
                        example: 8500
                      adwordsCost:
                        type: integer
                        example: 25000
        404:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'No results found.'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'No results found.'
      tags:
        - Companies
  /resource/company/logo:
    get:
      summary: 'Company Logo'
      operationId: companyLogo
      description: "<div class=\"endpoint-header\">\n    <span class=\"get\">GET</span>\n    <span class=\"url\">https://api2.sonalabs.com/resource/company/logo</span>\n</div>\n\nUse the Company Logo endpoint to retrieve the logo image URL for a specific company. This lightweight endpoint is designed for quickly fetching company logos without consuming the full enrichment credits required by the Company Enrichment endpoint.\n\nThe API identifies the company based on the domain you provide and returns a direct URL to the company's logo image hosted on our CDN. This endpoint is ideal for populating UI elements, building company directories, or displaying visual brand identifiers in your application.\n\nImportant: Calling this endpoint consumes credits as part of your pricing plan, though typically at a lower rate than full company enrichment."
      parameters:
        -
          in: query
          name: website
          description: 'The domain identifier of the company.'
          example: computerguru.net
          required: true
          schema:
            type: string
            description: 'The domain identifier of the company.'
            example: computerguru.net
            nullable: false
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: success
                  data:
                    logo: 'https://sonalabs-1.sfo2.digitaloceanspaces.com/companies/computerguru.net'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      logo:
                        type: string
                        example: 'https://sonalabs-1.sfo2.digitaloceanspaces.com/companies/computerguru.net'
        404:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.19
                  status: error
                  data:
                    message: 'No results found'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.19
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'No results found'
      tags:
        - Companies
  /resource/people/by-company:
    post:
      summary: 'People Search'
      operationId: peopleSearch
      description: "<div class=\"endpoint-header\">\n    <span class=\"post\">POST</span>\n    <span class=\"url\">https://api2.sonalabs.com/resource/people/search</span>\n</div>\n\nUse the People Search endpoint to discover professionals working at a specific company. This endpoint allows you to filter and retrieve detailed employee information based on various professional and demographic criteria, making it ideal for building targeted prospecting lists, identifying decision-makers, and enriching your CRM data.\n\nHow it works:The API searches for people associated with a company domain you provide via the website parameter. You can further refine results using flexible filters based on job titles, names, locations, skills, and other professional attributes. The endpoint returns paginated results with comprehensive profile information including contact details, social media profiles, and professional history.\n\nNote: Calling this endpoint consumes credits under your Sona pricing plan. Email addresses marked as email_not_unlocked@domain.com require additional credits to unlock full contact information."
      parameters:
        -
          in: header
          name: x-api-key
          description: ''
          example: your-api-key-here
          schema:
            type: string
      responses:
        200:
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.22
                  status: success
                  data:
                    list:
                      -
                        createdAt: '2014-04-15T10:30:00'
                        email: richard@piedpiper.com
                        firstName: Richard
                        lastName: Hendricks
                        fullName: 'Richard Hendricks'
                        jobTitle: 'CEO & Founder'
                        gender: Male
                        photoUrl: 'https://piedpiper.com/assets/team/richard-hendricks.jpg'
                        birthDate: '1987-03-15'
                        linkedinUrl: 'http://www.linkedin.com/in/richard-hendricks-piedpiper'
                        facebookUrl: facebook.com/richard.hendricks.pp
                        twitterUrl: twitter.com/richardhendricks
                        githubUrl: github.com/richardhendricks
                        workEmail: richard@piedpiper.com
                        personalEmails:
                          - richard.hendricks@gmail.com
                        phone: +1-650-555-0101
                        phoneNumbers:
                          - +1-650-555-0101
                          - +1-650-555-0102
                        emails:
                          - richard@piedpiper.com
                          - richard.hendricks@gmail.com
                        timezone: America/Los_Angeles
                        city: 'Palo Alto'
                        state: California
                        country: 'United States'
                        continent: 'North America'
                        streetAddress: '5230 Newell Road'
                        postalCode: '94303'
                        lat: 37.4419
                        lng: -122.143
                        skills:
                          - 'Data Compression'
                          - 'Algorithm Development'
                          - 'Software Engineering'
                          - Leadership
                          - 'Product Management'
                        socials:
                          - '@richardhendricks'
                          - '@piedpipertech'
                        tags:
                          - 'buying committee'
                      -
                        createdAt: '2014-04-15T10:35:00'
                        email: dinesh@piedpiper.com
                        firstName: Dinesh
                        lastName: Chugtai
                        fullName: 'Dinesh Chugtai'
                        jobTitle: 'Senior Software Engineer'
                        gender: Male
                        photoUrl: 'https://piedpiper.com/assets/team/dinesh-chugtai.jpg'
                        birthDate: '1988-07-22'
                        linkedinUrl: 'http://www.linkedin.com/in/dinesh-chugtai-piedpiper'
                        facebookUrl: facebook.com/dinesh.chugtai.pp
                        twitterUrl: twitter.com/dineshchugtai
                        githubUrl: github.com/dineshchugtai
                        workEmail: dinesh@piedpiper.com
                        personalEmails:
                          - dinesh.chugtai@gmail.com
                        phone: +1-650-555-0201
                        phoneNumbers:
                          - +1-650-555-0201
                        emails:
                          - dinesh@piedpiper.com
                          - dinesh.chugtai@gmail.com
                        timezone: America/Los_Angeles
                        city: 'Palo Alto'
                        state: California
                        country: 'United States'
                        continent: 'North America'
                        streetAddress: '5230 Newell Road'
                        postalCode: '94303'
                        lat: 37.4419
                        lng: -122.143
                        skills:
                          - Java
                          - Python
                          - 'Software Development'
                          - 'System Architecture'
                          - 'Database Design'
                        socials:
                          - '@dineshchugtai'
                          - '@piedpipertech'
                        tags:
                          - 'location match'
                    total: 2
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.22
                  status:
                    type: string
                    example: success
                  data:
                    type: object
                    properties:
                      list:
                        type: array
                        example:
                          -
                            createdAt: '2014-04-15T10:30:00'
                            email: richard@piedpiper.com
                            firstName: Richard
                            lastName: Hendricks
                            fullName: 'Richard Hendricks'
                            jobTitle: 'CEO & Founder'
                            gender: Male
                            photoUrl: 'https://piedpiper.com/assets/team/richard-hendricks.jpg'
                            birthDate: '1987-03-15'
                            linkedinUrl: 'http://www.linkedin.com/in/richard-hendricks-piedpiper'
                            facebookUrl: facebook.com/richard.hendricks.pp
                            twitterUrl: twitter.com/richardhendricks
                            githubUrl: github.com/richardhendricks
                            workEmail: richard@piedpiper.com
                            personalEmails:
                              - richard.hendricks@gmail.com
                            phone: +1-650-555-0101
                            phoneNumbers:
                              - +1-650-555-0101
                              - +1-650-555-0102
                            emails:
                              - richard@piedpiper.com
                              - richard.hendricks@gmail.com
                            timezone: America/Los_Angeles
                            city: 'Palo Alto'
                            state: California
                            country: 'United States'
                            continent: 'North America'
                            streetAddress: '5230 Newell Road'
                            postalCode: '94303'
                            lat: 37.4419
                            lng: -122.143
                            skills:
                              - 'Data Compression'
                              - 'Algorithm Development'
                              - 'Software Engineering'
                              - Leadership
                              - 'Product Management'
                            socials:
                              - '@richardhendricks'
                              - '@piedpipertech'
                            tags:
                              - 'buying committee'
                          -
                            createdAt: '2014-04-15T10:35:00'
                            email: dinesh@piedpiper.com
                            firstName: Dinesh
                            lastName: Chugtai
                            fullName: 'Dinesh Chugtai'
                            jobTitle: 'Senior Software Engineer'
                            gender: Male
                            photoUrl: 'https://piedpiper.com/assets/team/dinesh-chugtai.jpg'
                            birthDate: '1988-07-22'
                            linkedinUrl: 'http://www.linkedin.com/in/dinesh-chugtai-piedpiper'
                            facebookUrl: facebook.com/dinesh.chugtai.pp
                            twitterUrl: twitter.com/dineshchugtai
                            githubUrl: github.com/dineshchugtai
                            workEmail: dinesh@piedpiper.com
                            personalEmails:
                              - dinesh.chugtai@gmail.com
                            phone: +1-650-555-0201
                            phoneNumbers:
                              - +1-650-555-0201
                            emails:
                              - dinesh@piedpiper.com
                              - dinesh.chugtai@gmail.com
                            timezone: America/Los_Angeles
                            city: 'Palo Alto'
                            state: California
                            country: 'United States'
                            continent: 'North America'
                            streetAddress: '5230 Newell Road'
                            postalCode: '94303'
                            lat: 37.4419
                            lng: -122.143
                            skills:
                              - Java
                              - Python
                              - 'Software Development'
                              - 'System Architecture'
                              - 'Database Design'
                            socials:
                              - '@dineshchugtai'
                              - '@piedpipertech'
                            tags:
                              - 'location match'
                        items:
                          type: object
                          properties:
                            createdAt:
                              type: string
                              example: '2014-04-15T10:30:00'
                            email:
                              type: string
                              example: richard@piedpiper.com
                            firstName:
                              type: string
                              example: Richard
                            lastName:
                              type: string
                              example: Hendricks
                            fullName:
                              type: string
                              example: 'Richard Hendricks'
                            jobTitle:
                              type: string
                              example: 'CEO & Founder'
                            gender:
                              type: string
                              example: Male
                            photoUrl:
                              type: string
                              example: 'https://piedpiper.com/assets/team/richard-hendricks.jpg'
                            birthDate:
                              type: string
                              example: '1987-03-15'
                            linkedinUrl:
                              type: string
                              example: 'http://www.linkedin.com/in/richard-hendricks-piedpiper'
                            facebookUrl:
                              type: string
                              example: facebook.com/richard.hendricks.pp
                            twitterUrl:
                              type: string
                              example: twitter.com/richardhendricks
                            githubUrl:
                              type: string
                              example: github.com/richardhendricks
                            workEmail:
                              type: string
                              example: richard@piedpiper.com
                            personalEmails:
                              type: array
                              example:
                                - richard.hendricks@gmail.com
                              items:
                                type: string
                            phone:
                              type: string
                              example: +1-650-555-0101
                            phoneNumbers:
                              type: array
                              example:
                                - +1-650-555-0101
                                - +1-650-555-0102
                              items:
                                type: string
                            emails:
                              type: array
                              example:
                                - richard@piedpiper.com
                                - richard.hendricks@gmail.com
                              items:
                                type: string
                            timezone:
                              type: string
                              example: America/Los_Angeles
                            city:
                              type: string
                              example: 'Palo Alto'
                            state:
                              type: string
                              example: California
                            country:
                              type: string
                              example: 'United States'
                            continent:
                              type: string
                              example: 'North America'
                            streetAddress:
                              type: string
                              example: '5230 Newell Road'
                            postalCode:
                              type: string
                              example: '94303'
                            lat:
                              type: number
                              example: 37.4419
                            lng:
                              type: number
                              example: -122.143
                            skills:
                              type: array
                              example:
                                - 'Data Compression'
                                - 'Algorithm Development'
                                - 'Software Engineering'
                                - Leadership
                                - 'Product Management'
                              items:
                                type: string
                            socials:
                              type: array
                              example:
                                - '@richardhendricks'
                                - '@piedpipertech'
                              items:
                                type: string
                            tags:
                              type: array
                              example:
                                - 'buying committee'
                              items:
                                type: string
                      total:
                        type: integer
                        example: 2
        400:
          description: Error
          content:
            application/json:
              schema:
                type: object
                example:
                  version: 2.0.0
                  php: 8.3.22
                  status: error
                  data:
                    message: 'Please provide the company `website`'
                properties:
                  version:
                    type: string
                    example: 2.0.0
                  php:
                    type: string
                    example: 8.3.22
                  status:
                    type: string
                    example: error
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                        example: 'Please provide the company `website`'
      tags:
        - People
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website:
                  type: string
                  description: 'The company website to search for people'
                  example: reliancelogisticsgroup.com
                  nullable: false
                filters:
                  type: array
                  description: 'An array of filter objects. Each filter object contains 3 attributes: field, operator, and value.'
                  example:
                    -
                      field: name
                      operator: contains
                      value: Apple
                    -
                      field: industry
                      operator: '='
                      value: Technology
                  items:
                    type: object
                    properties:
                      field:
                        type: string
                        description: 'The field to filter on. Supported fields: `Email`, `First Name`, `Last Name`, `Full Name`, `Tags`, `Job Title`, `Gender`, `Photo Url`, `Birth Date`, `Linkedin Url`, `Facebook Url`, `Twitter Url`, `Github Url`, `Work Email`, `Personal Emails`, `Phone`, `Phone Numbers`, `Emails`, `Timezone`, `City`, `State`, `Country`, `Continent`, `Street Address`, `Postal Code`, `Lat`, `Lng`, `Skills`, `Socials`'
                        example: null
                        nullable: false
                      operator:
                        type: string
                        description: 'The filter operator. Supported operators: `is not empty`, `contains`, `=`, `>`, `<`, `>=`, `<=`, `<>`, `range`, `in set (exact)`, `in set (phrase)`, `starts with`, `does not contain`, `is empty`'
                        example: null
                        nullable: false
                      value:
                        type: string
                        description: 'The value to filter by. In the case of `is not empty` and `is empty` operators this is not required.'
                        example: null
                        nullable: false
                    required:
                      - field
                      - operator
                      - value
              required:
                - website
                - filters
