---
openapi: 3.0.1
info:
  title: Amplemarket API V1 Docs
  version: v1
components:
  schemas:
    response_error_object:
      type: object
      required:
      - code
      - title
      - detail
      additionalProperties: false
      properties:
        code:
          type: string
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          additionalProperties: false
          properties:
            pointer:
              type: string
    response_errors_object:
      type: object
      required:
      - object
      - _errors
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - error
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _links:
          "$ref": "#/components/schemas/response_links_object"
    response_link_object:
      type: object
      required:
      - href
      additionalProperties: false
      properties:
        href:
          type: string
    response_links_object:
      type: object
      required:
      - self
      additionalProperties: false
      properties:
        self:
          "$ref": "#/components/schemas/response_link_object"
        prev:
          "$ref": "#/components/schemas/response_link_object"
        next:
          "$ref": "#/components/schemas/response_link_object"
    response_pagination_object:
      type: object
      required:
      - page
      - page_size
      - total
      additionalProperties: false
      properties:
        page:
          type: integer
        page_size:
          type: integer
        total:
          type: integer
        total_pages:
          type: integer
    response_person_search_result_object:
      type: object
      required:
      - object
      - results
      - _pagination
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - person_search_result
        results:
          type: array
          items:
            "$ref": "#/components/schemas/response_person_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _pagination:
          "$ref": "#/components/schemas/response_pagination_object"
    response_person_object:
      type: object
      required:
      - id
      - object
      - linkedin_url
      additionalProperties: true
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
          - person
        linkedin_url:
          nullable: false
          type: string
        name:
          nullable: true
          type: string
        email:
          nullable: true
          type: string
        first_name:
          nullable: true
          type: string
        last_name:
          nullable: true
          type: string
        title:
          nullable: true
          type: string
        headline:
          nullable: true
          type: string
        about:
          nullable: true
          type: string
        current_position_start_date:
          nullable: true
          type: string
          format: date
        current_position_description:
          nullable: true
          type: string
        location:
          nullable: true
          type: string
        image_url:
          type: string
          format: uri
        gender:
          type: string
          enum:
          - male
          - female
          - likely_male
          - likely_female
          - unknown
        location_details:
          "$ref": "#/components/schemas/response_location_details_object"
        experiences:
          nullable: true
          type: array
          items:
            "$ref": "#/components/schemas/response_experience_object"
        educations:
          nullable: true
          type: array
          items:
            "$ref": "#/components/schemas/response_education_object"
        languages:
          nullable: true
          type: array
          items:
            "$ref": "#/components/schemas/response_language_object"
        phone_numbers:
          nullable: true
          type: array
          items:
            "$ref": "#/components/schemas/response_phone_number_object"
        company:
          nullable: true
          "$ref": "#/components/schemas/response_company_object"
        linkedin_presence:
          nullable: true
          type: string
          description: "`influencer` — Influencer (10,000+ followers), `micro_influencer`
            — Micro Influencer (5,000 - 9,999 followers), `large` — Large following
            (500 - 4,999 followers), `moderate` — Moderate following (100 - 499 followers),
            `limited` — Limited following (1 - 99 followers), `none` — No following
            (0 followers). All ranges are inclusive."
          enum:
          - influencer
          - micro_influencer
          - large
          - moderate
          - limited
          - none
    response_experience_object:
      type: object
      required:
      - object
      - title
      - company_name
      - company_linkedin_url
      - description
      - start_date
      - end_date
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - experience
        title:
          type: string
        company_name:
          type: string
        company_linkedin_url:
          nullable: true
          type: string
          format: uri
        description:
          nullable: true
          type: string
        start_date:
          nullable: true
          type: string
          format: date
        end_date:
          nullable: true
          type: string
          format: date
    response_education_object:
      type: object
      required:
      - object
      - degree
      - field_of_study
      - school_name
      - school_linkedin_url
      - start_date
      - end_date
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - education
        degree:
          nullable: true
          type: string
        field_of_study:
          nullable: true
          type: string
        school_name:
          type: string
        school_linkedin_url:
          nullable: true
          type: string
          format: uri
        start_date:
          nullable: true
          type: string
          format: date
        end_date:
          nullable: true
          type: string
          format: date
    response_language_object:
      type: object
      required:
      - object
      - language
      - iso_code
      - proficiency
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - language
        language:
          nullable: false
          type: string
        iso_code:
          nullable: false
          type: string
        proficiency:
          nullable: true
          type: string
    response_company_object:
      type: object
      required:
      - id
      - object
      - linkedin_url
      additionalProperties: true
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
          - company
        linkedin_url:
          nullable: false
          type: string
        name:
          nullable: true
          type: string
        overview:
          nullable: true
          type: string
        website:
          nullable: true
          type: string
        keywords:
          nullable: true
          type: array
          items:
            type: string
        followers:
          nullable: true
          type: integer
        linkedin_presence:
          nullable: true
          type: string
          description: "`massive` — Massive following (100,000+ followers), `large`
            — Large following (10,000 - 99,999 followers), `moderate` — Moderate following
            (1,000 - 9,999 followers), `limited` — Limited following (1 - 999 followers),
            `none` — No following (0 followers). All ranges are inclusive."
          enum:
          - massive
          - large
          - moderate
          - limited
          - none
        estimated_number_of_employees:
          nullable: true
          type: integer
        size:
          nullable: true
          type: string
          enum:
          - 10001+ employees
          - 201-500 employees
          - 51-200 employees
          - 11-50 employees
          - 1-10 employees
        location:
          nullable: true
          type: string
        location_details:
          "$ref": "#/components/schemas/response_location_details_object"
        locations:
          type: array
          nullable: true
          items:
            "$ref": "#/components/schemas/response_location_object"
        logo_url:
          type: string
          format: uri
        founded_year:
          nullable: true
          type: integer
        traffic_rank:
          nullable: true
          type: integer
        sic_codes:
          nullable: true
          type: array
          items:
            type: integer
        naics_codes:
          nullable: true
          type: array
          items:
            type: integer
        type:
          nullable: true
          type: string
          enum:
          - Public Company
          - Educational
          - Self Employed
          - Government Agency
          - Non Profit
          - Self Owned
          - Privately Held
          - Partnership
        total_funding:
          nullable: true
          type: integer
        latest_funding_stage:
          nullable: true
          type: string
          enum:
          - seed
          - angel
          - venture_round_unknown_series
          - series_a
          - series_b
          - series_c
          - series_d
          - series_e
          - series_f
          - series_g
          - series_h
          - series_i
          - series_j
          - debt
          - equity_crowdfunding
          - convertible_note
          - ico
          - private_equity
          - other
        latest_funding_date:
          nullable: true
          type: string
          format: date
        is_b2b:
          nullable: true
          type: boolean
        is_b2c:
          nullable: true
          type: boolean
        technologies:
          nullable: true
          type: array
          items:
            type: string
        department_headcount:
          "$ref": "#/components/schemas/response_department_headcount_object"
        job_function_headcount:
          "$ref": "#/components/schemas/response_job_function_headcount_object"
        estimated_revenue:
          nullable: true
          type: string
          enum:
          - "$0-$1M"
          - "$1M-$10M"
          - "$10M-$100M"
          - "$100M-$1B"
          - "$1B+"
        revenue:
          nullable: true
          type: integer
    response_location_details_object:
      type: object
      additionalProperties: false
      properties:
        country:
          nullable: true
          type: string
        state:
          nullable: true
          type: string
        city:
          nullable: true
          type: string
        postal_code:
          nullable: true
          type: string
        lat:
          nullable: true
          type: number
        long:
          nullable: true
          type: number
    response_location_object:
      type: object
      additionalProperties: false
      properties:
        address:
          nullable: false
          type: string
          description: Full address as a single string
        is_primary:
          nullable: false
          type: boolean
          description: Indicates if this is the primary location
        country:
          nullable: true
          type: string
          description: Country name (e.g., United States)
        state:
          nullable: true
          type: string
          description: State or subdivision name (e.g., California, New York)
        city:
          nullable: true
          type: string
          description: City name
        postal_code:
          nullable: true
          type: string
          description: Postal code
    response_department_headcount_object:
      type: object
      additionalProperties:
        type: integer
    response_job_function_headcount_object:
      type: object
      additionalProperties:
        type: object
        additionalProperties:
          type: integer
    response_phone_number_object:
      type: object
      required:
      - object
      - id
      - number
      - type
      - is_wrong_number
      additionalProperties: true
      properties:
        object:
          type: string
          enum:
          - phone_number
        id:
          type: string
          format: uuid
        number:
          type: string
        type:
          type: string
          enum:
          - mobile
          - office
          - phone
          - landline
          - voip
          - direct
        source:
          type: string
          enum:
          - amplemarket
          - crm
          - user_uploaded
        is_wrong_number:
          type: boolean
        is_dnc_listed:
          type: boolean
          description: Present only when the account has phone number DNC list enabled
    response_lead_list_object:
      type: object
      required:
      - id
      - object
      - name
      - status
      - url
      - shared
      - visible
      - owner
      - type
      - leads
      - _links
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
          - lead_list
        name:
          type: string
        status:
          type: string
          enum:
          - queued
          - processing
          - completed
        url:
          type: string
        shared:
          type: boolean
        visible:
          type: boolean
        owner:
          type: string
          format: email
        type:
          type: string
          enum:
          - linkedin
          - email
          - title_and_company
          - name_and_company
          - salesforce
          - hubspot
          - person
          - adaptive
        created_at:
          type: string
          format: date_time
        updated_at:
          type: string
          format: date_time
        options:
          type: object
          required:
          - reveal_phone_numbers
          - validate_email
          - enrich
          additionalProperties: false
          properties:
            reveal_phone_numbers:
              type: boolean
            validate_email:
              type: boolean
            enrich:
              type: boolean
        leads:
          type: array
          items:
            "$ref": "#/components/schemas/response_lead_list_entry_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _links:
          "$ref": "#/components/schemas/response_links_object"
    response_lead_list_entry_object:
      type: object
      required:
      - id
      - object
      - email
      - person_id
      - linkedin_url
      - linkedin
      - first_name
      - last_name
      - company_name
      - company_domain
      - industry
      - title
      - email_validation_result
      - data
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
          - lead_list_entry
        email:
          type: string
          format: email
        person_id:
          type: string
          format: uuid
        linkedin_url:
          type: string
        linkedin:
          type: string
        first_name:
          type: string
        last_name:
          type: string
        company_name:
          type: string
        company_domain:
          type: string
        industry:
          type: string
        title:
          type: string
        email_validation_result:
          "$ref": "#/components/schemas/response_lead_list_entry_email_validation_result_object"
        data:
          type: object
          additionalProperties: true
        phone_numbers:
          type: array
          items:
            "$ref": "#/components/schemas/response_phone_number_object"
    response_lead_list_entry_email_validation_result_object:
      type: object
      required:
      - object
      - email
      - result
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - email_validation_result
        email:
          type: string
          format: email
        result:
          type: string
          enum:
          - deliverable
          - risky
          - undeliverable
          - unknown
    response_account_details_object:
      type: object
      required:
      - id
      - name
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
    response_email_validation_object:
      type: object
      required:
      - id
      - object
      - status
      - results
      - _links
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
          - email_validation
        status:
          type: string
          enum:
          - queued
          - processing
          - completed
          - canceled
          - error
        results:
          type: array
          items:
            "$ref": "#/components/schemas/response_email_validation_result_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _links:
          "$ref": "#/components/schemas/response_links_object"
    response_email_validation_result_object:
      type: object
      required:
      - object
      - email
      - result
      - catch_all
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - email_validation_result
        email:
          type: string
          format: email
        result:
          type: string
          enum:
          - deliverable
          - risky
          - undeliverable
          - unknown
        catch_all:
          type: boolean
    response_person_enrichment_result_object:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        status:
          nullable: true
          type: string
          enum:
          - enriched
          - not_found
          - gdpr_removed
        result:
          nullable: true
          "$ref": "#/components/schemas/response_person_object"
        email:
          nullable: true
          type: string
        linkedin_url:
          nullable: true
          type: string
        company_domain:
          nullable: true
          type: string
        company_name:
          nullable: true
          type: string
        name:
          nullable: true
          type: string
        title:
          nullable: true
          type: string
    response_person_enrichment_object:
      type: object
      required:
      - id
      - object
      - status
      - results
      - _links
      additionalProperties: false
      properties:
        id:
          type: integer
        object:
          type: string
          enum:
          - person_enrichment
        status:
          type: string
          enum:
          - queued
          - processing
          - completed
          - canceled
          - error
        results:
          type: array
          items:
            "$ref": "#/components/schemas/response_person_enrichment_result_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _links:
          "$ref": "#/components/schemas/response_links_object"
    response_company_search_result_object:
      type: object
      required:
      - object
      - results
      - _pagination
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
          - company_search_result
        results:
          type: array
          items:
            "$ref": "#/components/schemas/response_company_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _pagination:
          "$ref": "#/components/schemas/response_pagination_object"
    response_company_enrichment_result_object:
      type: object
      additionalProperties: true
      properties:
        id:
          type: integer
        status:
          type: string
          enum:
          - found
          - not_found
          - pending
        result:
          nullable: true
          "$ref": "#/components/schemas/response_company_object"
        domain:
          nullable: true
          type: string
        linkedin_url:
          nullable: true
          type: string
    response_company_enrichment_object:
      type: object
      required:
      - id
      - object
      - status
      - results
      - _links
      additionalProperties: false
      properties:
        id:
          type: integer
        object:
          type: string
          enum:
          - company_enrichment
        status:
          type: string
          enum:
          - queued
          - processing
          - completed
          - canceled
          - error
        results:
          type: array
          items:
            "$ref": "#/components/schemas/response_company_enrichment_result_object"
        _errors:
          type: array
          items:
            "$ref": "#/components/schemas/response_error_object"
        _links:
          "$ref": "#/components/schemas/response_links_object"
    response_contact_object:
      type: object
      required:
      - id
      - email
      additionalProperties: true
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
          nullable: true
        first_name:
          type: string
          nullable: true
        last_name:
          type: string
          nullable: true
        email:
          type: string
          nullable: true
        linkedin_url:
          type: string
          format: uri
          nullable: true
        title:
          type: string
          nullable: true
        location:
          type: string
          nullable: true
        time_zone:
          type: string
          nullable: true
        company_name:
          type: string
          nullable: true
        company_domain:
          type: string
          nullable: true
        owner:
          type: string
          nullable: true
        created_at:
          type: string
          format: date_time
        last_contacted_at:
          type: string
          format: date_time
          nullable: true
        crm:
          type: object
          nullable: true
          additionalProperties: false
          properties:
            provider:
              type: string
              enum:
              - salesforce
              - hubspot
            contact_name:
              type: string
              nullable: true
            contact_url:
              type: string
              format: uri
              nullable: true
            owner:
              type: object
              nullable: true
              additionalProperties: false
              properties:
                name:
                  type: string
                  nullable: true
                email:
                  type: string
                  nullable: true
            type:
              type: string
              enum:
              - contact
              - lead
            id:
              type: string
        phone_numbers:
          type: array
          items:
            "$ref": "#/components/schemas/response_phone_number_object"
    response_contact_with_activity_object:
      allOf:
      - "$ref": "#/components/schemas/response_contact_object"
      - type: object
        additionalProperties: true
        properties:
          recent_activity:
            type: array
            items:
              "$ref": "#/components/schemas/response_contact_activity_object"
    response_contact_activity_object:
      type: object
      required:
      - event_at
      - event_type
      additionalProperties: false
      properties:
        event_at:
          type: string
          format: date_time
        event_type:
          type: string
        automatic:
          type: boolean
          nullable: true
        type:
          type: string
          nullable: true
        description:
          type: string
          nullable: true
        subject:
          type: string
          nullable: true
        body:
          type: string
          nullable: true
        sequence_id:
          type: string
          nullable: true
        sequence_name:
          type: string
          nullable: true
        sequence_type:
          type: string
          nullable: true
        index:
          type: integer
          nullable: true
        tags:
          type: array
          items:
            type: string
          nullable: true
        notes:
          type: string
          nullable: true
        call_disposition:
          type: string
          nullable: true
        call_notes:
          type: string
          nullable: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
paths:
  "/excluded-domains":
    get:
      summary: List excluded domains
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: filter[domain]
        in: query
        required: false
        description: Filter by domain keyword
        schema:
          type: string
      tags:
      - Exclusion lists
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    excluded_domains:
                    - domain: domain.com
                      source: amplemarket
                      date_added: '2026-08-19T14:46:10.776Z'
                      excluded_reason: api
                      excluded_reasons:
                      - api
                    _links:
                      self:
                        href: "/excluded-domains?page[size]=2000"
              schema:
                type: object
                properties:
                  excluded_domains:
                    type: array
                    items:
                      type: object
                      properties:
                        domain:
                          type: string
                        source:
                          type: string
                        date_added:
                          type: string
                          format: date_time
                        excluded_reason:
                          type: string
                        excluded_reasons:
                          type: array
                          items:
                            type: string
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
      description: List excluded domains
    post:
      summary: Create domain exclusions
      parameters: []
      tags:
      - Exclusion lists
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    existing_domain.com: duplicated
                    new_domain.com: success
              schema:
                type: object
                additionalProperties:
                  type: string
                  enum:
                  - success
                  - duplicated
                  - error
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
                Unspported value:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                excluded_domains:
                  type: array
                  items:
                    type: object
                    properties:
                      domain:
                        type: string
              required:
              - excluded_domains
      description: Create domain exclusions
    delete:
      summary: Delete domain exclusions
      parameters: []
      tags:
      - Exclusion lists
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    existing_domain.com: success
                    existing_domain_from_crm.com: unsupported
                    unexistent_domain.com: not_found
              schema:
                type: object
                additionalProperties:
                  type: string
                  enum:
                  - success
                  - not_found
                  - unsupported
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
                Unspported value:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                excluded_domains:
                  type: array
                  items:
                    type: object
                    properties:
                      domain:
                        type: string
              required:
              - excluded_domains
      description: Delete domain exclusions
  "/excluded-emails":
    get:
      summary: List excluded emails
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: filter[email]
        in: query
        required: false
        description: Filter by email keyword
        schema:
          type: string
      tags:
      - Exclusion lists
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    excluded_emails:
                    - email: someone@domain.com
                      source: amplemarket
                      date_added: '2026-08-19T14:46:18.172Z'
                      excluded_reason: api
                      excluded_reasons:
                      - api
                    _links:
                      self:
                        href: "/excluded-emails?page[size]=2000"
              schema:
                type: object
                properties:
                  excluded_emails:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        source:
                          type: string
                        date_added:
                          type: string
                          format: date_time
                        excluded_reason:
                          type: string
                        excluded_reasons:
                          type: array
                          items:
                            type: string
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
      description: List excluded emails
    post:
      summary: Create email exclusions
      parameters: []
      tags:
      - Exclusion lists
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    existing@domain.com: duplicated
                    new@domain.com: success
              schema:
                type: object
                additionalProperties:
                  type: string
                  enum:
                  - success
                  - duplicated
                  - error
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
                Unsupported value:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                excluded_emails:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
              required:
              - excluded_emails
      description: Create email exclusions
    delete:
      summary: Delete email exclusions
      parameters: []
      tags:
      - Exclusion lists
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    existing@domain.com: success
                    existing_from_crm@domain.com: unsupported
                    unexistent@domain.com: not_found
              schema:
                type: object
                additionalProperties:
                  type: string
                  enum:
                  - success
                  - not_found
                  - unsupported
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
                Unspported value:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array'
                      source:
                        pointer: "/emails"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                excluded_emails:
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
              required:
              - excluded_emails
      description: Delete email exclusions
  "/mailboxes":
    get:
      summary: List mailboxes
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size (max 20)
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by mailbox status
        schema:
          type: string
          enum:
          - active
          - inactive
          - needs_reconnection
      - name: email_provider
        in: query
        required: false
        description: Filter by email provider
        schema:
          type: string
          enum:
          - google
          - outlook
          - other
          - other_mixed
      - name: user_email
        in: query
        required: false
        description: Filter by user email
        schema:
          type: string
      tags:
      - Mailboxes
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    mailboxes:
                    - id: 01a01a7c-c87d-7d06-8b84-d5705fa91a0c
                      email: mailbox@example.com
                      email_provider: google
                      daily_email_limit: 50
                      status: active
                      user:
                        id: 01a01a7c-c7bb-749f-93e6-8a49c9323751
                        name: Example User
                        email: foo-33@email.com
                      created_at: '2026-08-19T14:46:20Z'
                      updated_at: '2026-08-19T14:46:20Z'
                    _links:
                      self:
                        href: "/mailboxes?page[size]=20"
              schema:
                type: object
                properties:
                  mailboxes:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        email:
                          type: string
                        email_provider:
                          type: string
                          enum:
                          - google
                          - outlook
                          - other
                          - other_mixed
                        daily_email_limit:
                          type: integer
                          nullable: true
                        status:
                          type: string
                          enum:
                          - active
                          - inactive
                          - needs_reconnection
                        user:
                          type: object
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                              nullable: true
                            email:
                              type: string
                        created_at:
                          type: string
                          format: date-time
                        updated_at:
                          type: string
                          format: date-time
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
      description: List mailboxes
  "/mailboxes/{id}":
    patch:
      summary: Update mailbox daily email limit
      parameters:
      - name: id
        in: path
        required: true
        description: Mailbox id
        schema:
          type: string
      tags:
      - Mailboxes
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 01a01a7c-ca39-7546-89de-ab623b2efedc
                    email: mailbox@example.com
                    email_provider: google
                    daily_email_limit: 100
                    status: active
                    user:
                      id: 01a01a7c-c9e3-7cfa-92cf-797ba46b2f84
                      name: Example User
                      email: foo-34@email.com
                    created_at: '2026-08-19T14:46:20Z'
                    updated_at: '2026-08-19T14:46:21Z'
                    _links:
                      self:
                        href: "/mailboxes/01a01a7c-ca39-7546-89de-ab623b2efedc"
              schema:
                type: object
                properties:
                  id:
                    type: string
                  email:
                    type: string
                  email_provider:
                    type: string
                    enum:
                    - google
                    - outlook
                    - other
                    - other_mixed
                  daily_email_limit:
                    type: integer
                  status:
                    type: string
                    enum:
                    - active
                    - inactive
                    - needs_reconnection
                  user:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                        nullable: true
                      email:
                        type: string
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  _links:
                    type: object
                    properties:
                      self:
                        type: object
                        properties:
                          href:
                            type: string
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Bad request:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: daily_email_limit cannot exceed the account's maximum
                        limit of 150
                      source:
                        pointer: "/daily_email_limit"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Mailbox not found
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - daily_email_limit
              properties:
                daily_email_limit:
                  type: integer
                  description: New daily email limit for the mailbox
        required: true
        description: Daily email limit update
      description: Update mailbox daily email limit
  "/users":
    get:
      summary: List users
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by user status
        schema:
          type: string
      - name: role
        in: query
        required: false
        description: Filter by user role
        schema:
          type: string
      - name: email
        in: query
        required: false
        description: Filter by user email
        schema:
          type: string
      tags:
      - Users
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    users:
                    - id: 01a01a7c-cf9f-7f0b-b2bd-0e32c20760b9
                      name: Example User
                      email: user@example.com
                      status: active
                      role: sales_rep
                      mailboxes:
                      - id: 01a01a7c-d021-7272-8b09-fe01979ebffa
                        email: mailbox@example.com
                    _links:
                      self:
                        href: "/users?page[size]=20"
              schema:
                type: object
                properties:
                  users:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                          nullable: true
                        email:
                          type: string
                        role:
                          type: string
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
      description: List users
  "/calls":
    post:
      summary: Log call
      parameters: []
      tags:
      - Calls
      responses:
        '201':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    id: 01a08646-856e-72b7-9bc3-829b4c880ac4
                    disposition_id: 01a08646-833c-7428-ab8a-9d7d369cd02a
                    disposition_name: custom disposition
                    duration: 5
                    external: true
                    direction: outgoing
                    start_date: '2026-09-09T13:06:03Z'
                    from: "+1 123456789"
                    to: "+1 123456789"
                    notes:
                    recording_url: https://recordings.example.com/abc123.mp3
                    task_id: 01a08646-84ec-72e2-bf65-6d6a643931e8
                    user_id: 01a08646-8497-70c6-aaca-ff7a450538b1
                    user_email: user@example.com
                    human: false
                    answered: true
                    contact:
                    transcription:
                    transcript: []
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  disposition_id:
                    type: string
                    format: uuid
                  disposition_name:
                    type: string
                    nullable: true
                  duration:
                    type: integer
                  from:
                    type: string
                  to:
                    type: string
                  notes:
                    type: string
                    nullable: true
                  transcription:
                    type: string
                    nullable: true
                  transcript:
                    description: Chronological, speaker-labelled transcript. When
                      the call has no native transcript, `transcription` is returned
                      as a single entry; empty when neither is available.
                    type: array
                    items:
                      type: object
                      properties:
                        speaker:
                          type: string
                          enum:
                          - user
                          - contact
                          nullable: true
                        text:
                          type: string
                        timestamp:
                          type: string
                          format: date_time
                          nullable: true
                  recording_url:
                    description: URL of the call recording, as submitted when logging
                      the call. Empty if no recording URL was submitted.
                    type: string
                    nullable: true
                  task_id:
                    type: string
                    format: uuid
                  user_id:
                    type: string
                    format: uuid
                  user_email:
                    type: string
                  answered:
                    type: boolean
                  human:
                    type: boolean
                  external:
                    type: boolean
                  direction:
                    type: string
                    enum:
                    - incoming
                    - outgoing
                  start_date:
                    type: string
                    format: date_time
                  contact:
                    type: object
                    nullable: true
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                        nullable: true
                      email:
                        type: string
                        nullable: true
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: user_id'
                      source:
                        pointer: "/user_id"
                    object: error
                Invalid user:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: answered'
                      source:
                        pointer: "/answered"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                from:
                  description: The phone number that initiated the call
                  type: string
                to:
                  description: The phone number that received the call
                  type: string
                duration:
                  description: The duration of the call in seconds
                  type: integer
                answered:
                  description: A boolean indicating whether the call was answered
                  type: boolean
                human:
                  description: A boolean indicating whether a human answered the call
                    or if it was detected as a machine/voicemail
                  type: boolean
                transcription:
                  description: The text representation of the call's audio, if available
                  type: string
                recording_url:
                  description: URL of the call recording. Amplemarket stores the URL
                    and does not download the recording.
                  type: string
                disposition_id:
                  type: string
                  format: uuid
                  description: Call disposition ID. If the given disposition has its
                    action set to "complete", the specified task will be marked as
                    completed, along with the associated sequence lead.
                task_id:
                  type: string
                  format: uuid
                user_id:
                  type: string
                  format: uuid
              required:
              - from
              - to
              - duration
              - answered
              - human
              - task_id
              - user_id
      description: Log call
    get:
      summary: List calls
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: user_id
        in: query
        required: false
        description: Filter by user ID
        schema:
          type: string
      - name: from
        in: query
        required: false
        description: Filter by call from number
        schema:
          type: string
      - name: to
        in: query
        required: false
        description: Filter by call to number
        schema:
          type: string
      - name: direction
        in: query
        schema:
          type: string
          enum:
          - incoming
          - outgoing
        required: false
        description: Filter by call direction
      - name: start_date_from
        in: query
        required: false
        description: Select calls starting after this date (ISO 8601 format)
        schema:
          type: string
      - name: start_date_to
        in: query
        required: false
        description: Select calls starting before this date (ISO 8601 format)
        schema:
          type: string
      tags:
      - Calls
      description: List calls, newest first. Like the dashboard, calls that never
        connected and Parallel Dialer legs dropped or canceled without a logged outcome
        are not returned.
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    calls:
                    - id: 01a08646-88f2-7928-8ad4-fc1dacb96fe1
                      disposition_id:
                      disposition_name:
                      duration:
                      external: true
                      direction: outgoing
                      start_date: '2026-09-09T13:05:04Z'
                      from: "+351999999999"
                      to: "+351888888888"
                      notes:
                      recording_url: https://recordings.example.com/abc123.mp3
                      task_id:
                      user_id: 01a08646-8723-795e-b1fe-43a93bf23ac7
                      user_email: user@example.com
                      human: false
                      answered:
                      contact:
                      transcription:
                      transcript: []
                    - id: 01a08646-88a6-7723-bad9-27a80fac27ed
                      disposition_id:
                      disposition_name:
                      duration:
                      external: false
                      direction: outgoing
                      start_date: '2026-09-09T13:05:04Z'
                      from: "+351999999999"
                      to: "+351888888888"
                      notes:
                      recording_url:
                      task_id:
                      user_id: 01a08646-8723-795e-b1fe-43a93bf23ac7
                      user_email: user@example.com
                      human: false
                      answered:
                      contact:
                      transcription:
                      transcript: []
                    - id: 01a08646-883e-738f-ad88-f94b9f04e74a
                      disposition_id:
                      disposition_name:
                      duration:
                      external: false
                      direction: outgoing
                      start_date: '2026-09-09T13:05:04Z'
                      from: "+351999999999"
                      to: "+351888888888"
                      notes:
                      recording_url:
                      task_id:
                      user_id: 01a08646-8723-795e-b1fe-43a93bf23ac7
                      user_email: user@example.com
                      human: false
                      answered:
                      contact:
                      transcription:
                      transcript: []
                    - id: 01a08646-87e5-72b7-8edd-8e8f94ecf1b8
                      disposition_id:
                      disposition_name:
                      duration:
                      external: false
                      direction: outgoing
                      start_date: '2026-09-09T13:05:04Z'
                      from: "+351999999999"
                      to: "+351888888888"
                      notes:
                      recording_url:
                      task_id:
                      user_id: 01a08646-8723-795e-b1fe-43a93bf23ac7
                      user_email: user@example.com
                      human: false
                      answered:
                      contact:
                      transcription:
                      transcript: []
                    _links:
                      self:
                        href: "/calls?page[size]=20"
              schema:
                type: object
                properties:
                  calls:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        from:
                          type: string
                        to:
                          type: string
                        duration:
                          type: integer
                          nullable: true
                        transcription:
                          type: string
                          nullable: true
                        transcript:
                          description: Chronological, speaker-labelled transcript.
                            When the call has no native transcript, `transcription`
                            is returned as a single entry; empty when neither is available.
                          type: array
                          items:
                            type: object
                            properties:
                              speaker:
                                type: string
                                enum:
                                - user
                                - contact
                                nullable: true
                              text:
                                type: string
                              timestamp:
                                type: string
                                format: date_time
                                nullable: true
                        recording_url:
                          description: URL of the call recording for external calls.
                            Empty for calls placed through Amplemarket, whose recordings
                            are available from `GET /calls/{id}/recording`.
                          type: string
                          nullable: true
                        answered:
                          type: boolean
                          nullable: true
                        human:
                          type: boolean
                        external:
                          type: boolean
                        direction:
                          type: string
                          enum:
                          - incoming
                          - outgoing
                        start_date:
                          type: string
                          format: date_time
                        disposition_id:
                          type: string
                          format: uuid
                          nullable: true
                        disposition_name:
                          type: string
                          nullable: true
                        task_id:
                          type: string
                          format: uuid
                          nullable: true
                        user_id:
                          type: string
                          format: uuid
                        user_email:
                          type: string
                        contact:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                              nullable: true
                            email:
                              type: string
                              nullable: true
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Bad request:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Invalid date format
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
  "/calls/dispositions":
    get:
      summary: List dispositions
      parameters: []
      tags:
      - Calls
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    dispositions:
                    - id: 01a035ff-6043-7e56-a7c6-f68f24e26346
                      name: No Answer
                      slug: no_answer
                      action: next_stage
                    - id: 01a035ff-6043-7e19-9b34-31219a88d141
                      name: Left VM
                      slug: no_answer_voicemail
                      action: next_stage
                    - id: 01a035ff-6043-752a-b6a9-bff174f4f7a9
                      name: Wrong Number
                      slug: wrong_number
                      action: next_stage
                    - id: 01a035ff-6043-70cb-af2c-37cbf9eb8a07
                      name: Busy call later
                      slug: busy
                      action: next_stage
                    - id: 01a035ff-6043-7617-8115-09609e2e0ce6
                      name: Not interested
                      slug: not_interested
                      action: complete
                    - id: 01a035ff-6043-72b3-ad52-fb5e46fcce71
                      name: Interested
                      slug: interested
                      action: complete
              schema:
                type: object
                properties:
                  dispositions:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        slug:
                          type: string
                          nullable: true
                        name:
                          type: string
                        action:
                          type: string
      description: List dispositions
  "/calls/{id}/recording":
    get:
      summary: Get call recording
      parameters:
      - name: id
        in: path
        required: true
        description: Call ID
        schema:
          type: string
      tags:
      - Calls
      responses:
        '200':
          description: successful
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Call not found
                      source:
                        pointer: "/id"
                    object: error
            audio/mpeg:
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '413':
          description: Content too large
          content:
            application/json:
              examples:
                Content too large:
                  value:
                    _errors:
                    - code: content_too_large
                      title: Content Too Large
                      detail: Recording is too big
                    object: error
            audio/mpeg:
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Get call recording
  "/job-openings":
    get:
      summary: List Job Openings
      parameters:
      - name: company_id
        in: query
        required: false
        description: Amplemarket company ID
        schema:
          type: string
      - name: domain
        in: query
        required: false
        description: Company domain
        schema:
          type: string
      - name: linkedin_url
        in: query
        required: false
        description: Company LinkedIn URL
        schema:
          type: string
      - name: person_seniorities[]
        in: query
        schema:
          type: array
          items:
            type: string
            enum:
            - Owner
            - Founder
            - C-Suite
            - Partner
            - VP
            - Head
            - Director
            - Manager
            - Senior
            - Entry
            - Intern
            - Other
            - Non-Manager
            - Founder / Owner
        required: false
        description: Filter by job seniorities
      - name: person_departments[]
        in: query
        schema:
          type: array
          items:
            type: string
        required: false
        description: 'Available options: [Supported departments](/api-reference/supported-departments)'
      - name: person_job_functions[]
        in: query
        schema:
          type: array
          items:
            type: string
        required: false
        description: 'Available options: [Supported job functions](/api-reference/supported-job-functions)'
      - name: only_remote
        in: query
        required: false
        description: Only return remote job openings
        schema:
          type: boolean
      - name: page[size]
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 100
        required: false
        description: 'Page size (default: 10, max: 100)'
      - name: page[after]
        in: query
        required: false
        description: Cursor for the next page (from _links.next)
        schema:
          type: string
      tags:
      - Job Openings
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    company:
                      id: 6410f5bc-b911-49aa-90dd-2f49cd47d609
                      name: Example Inc
                      domain: example.com
                      linkedin_url: https://www.linkedin.com/company/example
                    job_openings:
                    - id: c5dcc248-6238-4cda-b6a9-883490218592
                      title: Senior Software Engineer
                      url: https://example.com/jobs/123
                      raw_location: Remote - US
                      first_seen_at: '2026-04-01T12:00:00Z'
                      seniorities:
                      - Senior
                      departments:
                      - Engineering & Technical
                      job_functions:
                      - Software Development
                    _links:
                      self:
                        href: "/job-openings?domain=example.com&page[size]=10"
              schema:
                type: object
                properties:
                  company:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      name:
                        type: string
                        nullable: true
                      domain:
                        type: string
                        nullable: true
                      linkedin_url:
                        type: string
                        nullable: true
                  job_openings:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        title:
                          type: string
                          nullable: true
                        url:
                          type: string
                          nullable: true
                        raw_location:
                          type: string
                          nullable: true
                        first_seen_at:
                          type: string
                          format: date_time
                          nullable: true
                        seniorities:
                          type: array
                          items:
                            type: string
                        departments:
                          type: array
                          items:
                            type: string
                        job_functions:
                          type: array
                          items:
                            type: string
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing company lookup:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide one of company_id, domain, or linkedin_url
                    object: error
                Invalid cursor:
                  value:
                    _errors:
                    - code: invalid_parameter
                      title: Invalid Parameter
                      detail: Invalid cursor
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: company_not_found
                      title: Company Not Found
                      detail: Company not found
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: List Job Openings
  "/job-openings/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Job opening ID
      schema:
        type: string
    get:
      summary: Retrieve Job Opening
      parameters: []
      tags:
      - Job Openings
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 39154a80-27ea-479d-8e6b-3ccee8940316
                    title: Senior Software Engineer
                    url: https://example.com/jobs/123
                    raw_location: Remote - US
                    first_seen_at: '2026-04-01T12:00:00Z'
                    seniorities:
                    - Senior
                    departments:
                    - Engineering & Technical
                    job_functions:
                    - Software Development
                    description: Full job description
                    company_name: Example Inc
                    company_domain: example.com
                    raw_salary: "$140k-$180k"
                    contract_types:
                    - remote
                    last_seen_at: '2026-04-02T12:00:00Z'
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  title:
                    type: string
                    nullable: true
                  url:
                    type: string
                    nullable: true
                  raw_location:
                    type: string
                    nullable: true
                  first_seen_at:
                    type: string
                    format: date_time
                    nullable: true
                  seniorities:
                    type: array
                    items:
                      type: string
                  departments:
                    type: array
                    items:
                      type: string
                  job_functions:
                    type: array
                    items:
                      type: string
                  description:
                    type: string
                    nullable: true
                  company_name:
                    type: string
                    nullable: true
                  company_domain:
                    type: string
                    nullable: true
                  raw_salary:
                    type: string
                    nullable: true
                  contract_types:
                    type: array
                    items:
                      type: string
                  last_seen_at:
                    type: string
                    format: date_time
                    nullable: true
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Job opening not found
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '410':
          description: Gone
          content:
            application/json:
              examples:
                Gone:
                  value:
                    _errors:
                    - code: gone
                      title: Gone
                      detail: Job opening is no longer available
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve Job Opening
  "/companies/enrichment-requests":
    post:
      summary: Start batch of company enrichments
      parameters: []
      tags:
      - Companies Enrichment
      responses:
        '202':
          description: Batch accepted
          content:
            application/json:
              examples:
                Batch accepted:
                  value:
                    id: 1
                    object: company_enrichment
                    status: queued
                    results: []
                    _links:
                      self:
                        href: "/companies/enrichment-requests/1"
              schema:
                "$ref": "#/components/schemas/response_company_enrichment_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: companies'
                      source:
                        pointer: "/companies"
                    object: error
                Empty companies:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: companies'
                      source:
                        pointer: "/companies"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - companies
              additionalProperties: false
              properties:
                companies:
                  type: array
                  items:
                    type: object
                    additionalProperties: false
                    properties:
                      domain:
                        type: string
                      linkedin_url:
                        type: string
        required: true
        description: Companies to be enriched
      description: Start batch of company enrichments
  "/companies/enrichment-requests/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Batch id
      schema:
        type: string
    - name: page[size]
      in: query
      required: false
      description: Page size
      schema:
        type: string
    - name: page[after]
      in: query
      required: false
      description: Page after
      schema:
        type: string
    - name: page[before]
      in: query
      required: false
      description: Page before
      schema:
        type: string
    get:
      summary: Retrieve company enrichment results
      parameters: []
      tags:
      - Companies Enrichment
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Processing:
                  value:
                    id: 2
                    object: company_enrichment
                    status: processing
                    results: []
                    _links:
                      self:
                        href: "/companies/enrichment-requests/2"
                Completed:
                  value:
                    id: 3
                    object: company_enrichment
                    status: completed
                    results:
                    - id: 4
                      linkedin_url:
                      domain: example-1878e78b.com
                      status: found
                      result:
                        id: 01a01a7c-ed6c-77c0-a629-4c43a22b08b2
                        object: company
                        name: Test Company
                        website:
                        linkedin_url: https://www.linkedin.com/company/test-company
                        keywords:
                        - Private healthcare
                        estimated_number_of_employees: 0
                        size:
                        industry: Software Development
                        logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-ed6c-77c0-a629-4c43a22b08b2
                        location: United States
                        location_details:
                          city:
                          state:
                          country: United States
                          postal_code:
                          lat:
                          long:
                        locations: []
                        overview: Circle Health is a group of hospitals in the UK
                        followers: 0
                        linkedin_presence: none
                        founded_year:
                        traffic_rank:
                        sic_codes: []
                        naics_codes:
                        - 5112
                        - 511
                        - 51
                        type:
                        total_funding:
                        latest_funding_stage:
                        latest_funding_date:
                        funding_events: []
                        is_b2b:
                        is_b2c:
                        technologies: []
                        department_headcount: {}
                        job_function_headcount: {}
                        estimated_revenue: "$1M-$10M"
                    - id: 5
                      linkedin_url:
                      domain: example-8ab06f5d.com
                      status: found
                      result:
                        id: 01a01a7c-ed6c-77c0-a629-4c43a22b08b2
                        object: company
                        name: Test Company
                        website:
                        linkedin_url: https://www.linkedin.com/company/test-company
                        keywords:
                        - Private healthcare
                        estimated_number_of_employees: 0
                        size:
                        industry: Software Development
                        logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-ed6c-77c0-a629-4c43a22b08b2
                        location: United States
                        location_details:
                          city:
                          state:
                          country: United States
                          postal_code:
                          lat:
                          long:
                        locations: []
                        overview: Circle Health is a group of hospitals in the UK
                        followers: 0
                        linkedin_presence: none
                        founded_year:
                        traffic_rank:
                        sic_codes: []
                        naics_codes:
                        - 5112
                        - 511
                        - 51
                        type:
                        total_funding:
                        latest_funding_stage:
                        latest_funding_date:
                        funding_events: []
                        is_b2b:
                        is_b2c:
                        technologies: []
                        department_headcount: {}
                        job_function_headcount: {}
                        estimated_revenue: "$1M-$10M"
                    _links:
                      self:
                        href: "/companies/enrichment-requests/3"
                Canceled:
                  value:
                    id: 4
                    object: company_enrichment
                    status: canceled
                    results:
                    - id: 6
                      linkedin_url:
                      domain: example-9e16f2b0.com
                      status: found
                      result:
                        id: 01a01a7c-ef55-7c6b-9c18-eee98b9cec26
                        object: company
                        name: Test Company
                        website:
                        linkedin_url: https://www.linkedin.com/company/test-company
                        keywords:
                        - Private healthcare
                        estimated_number_of_employees: 0
                        size:
                        industry: Software Development
                        logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-ef55-7c6b-9c18-eee98b9cec26
                        location: United States
                        location_details:
                          city:
                          state:
                          country: United States
                          postal_code:
                          lat:
                          long:
                        locations: []
                        overview: Circle Health is a group of hospitals in the UK
                        followers: 0
                        linkedin_presence: none
                        founded_year:
                        traffic_rank:
                        sic_codes: []
                        naics_codes:
                        - 5112
                        - 511
                        - 51
                        type:
                        total_funding:
                        latest_funding_stage:
                        latest_funding_date:
                        funding_events: []
                        is_b2b:
                        is_b2c:
                        technologies: []
                        department_headcount: {}
                        job_function_headcount: {}
                        estimated_revenue: "$1M-$10M"
                    _links:
                      self:
                        href: "/companies/enrichment-requests/4"
              schema:
                "$ref": "#/components/schemas/response_company_enrichment_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find company enrichment.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve company enrichment results
    patch:
      summary: Cancel batch of company enrichments
      parameters: []
      tags:
      - Companies Enrichment
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 5
                    object: company_enrichment
                    status: canceled
                    results: []
                    _links:
                      self:
                        href: "/companies/enrichment-requests/5"
              schema:
                "$ref": "#/components/schemas/response_company_enrichment_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: status'
                      source:
                        pointer: "/status"
                    object: error
                Unsupported value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: You used status 'error' when only 'canceled' is accepted.
                      source:
                        pointer: "/status"
                    object: error
                Cannot cancel finished batch:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Cannot update status of a finished company enrichment
                        batch.
                      source:
                        pointer: "/status"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find company enrichment batch.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - status
              additionalProperties: false
              properties:
                status:
                  type: string
                  enum:
                  - canceled
        required: true
        description: New batch status
      description: Cancel batch of company enrichments
  "/companies/find":
    parameters:
    - name: domain
      in: query
      schema:
        type: string
      required: false
      description: Domain to use for matching
    - name: linkedin_url
      in: query
      required: false
      description: LinkedIn URL to use for matching
      schema:
        type: string
    get:
      summary: Single company enrichment
      parameters: []
      tags:
      - Companies Enrichment
      responses:
        '200':
          description: Ok
          content:
            application/json:
              examples:
                With linkedin_url:
                  value:
                    id: 01a01a7c-f766-7211-b764-773f94de89e3
                    object: company
                    name: A Company
                    website: https://company.com
                    linkedin_url: https://www.linkedin.com/company/company-1
                    keywords:
                    - sales
                    - ai sales
                    - sales engagement
                    estimated_number_of_employees: 500
                    size: 201-500 employees
                    industry: Software Development
                    logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-f766-7211-b764-773f94de89e3
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      postal_code: '94103'
                      lat: 37.7749
                      long: -122.4194
                    locations:
                    - is_primary: true
                      address: 123 Main St, San Francisco, CA 94103, United States
                      country: United States
                      state: California
                      city: San Francisco
                      postal_code: '94103'
                    - is_primary: false
                      address: 456 Broadway, New York, NY 10001, United States
                      country: United States
                      state: New York
                      city: New York
                      postal_code: '10001'
                    overview: We're an AI company.
                    followers: 300
                    linkedin_presence: limited
                    founded_year: 1995
                    traffic_rank: 50
                    sic_codes:
                    - 1
                    - 2
                    - 3
                    naics_codes:
                    - 5112
                    - 511
                    - 51
                    type: Privately Held
                    total_funding: 0
                    latest_funding_stage: series_b
                    latest_funding_date: '2019-11-02'
                    funding_events:
                    - date: '2019-11-02'
                      type: Series B
                      investors: []
                      amount: 40000000
                      currency:
                      amount_usd:
                    is_b2b: true
                    is_b2c: false
                    technologies: []
                    department_headcount:
                      consulting: 31420
                      design: 5312
                      education: 9063
                      engineering_technical: 167805
                      finance: 31894
                      human_resources: 33265
                      information_technology: 94657
                      legal: 41863
                      marketing: 38192
                      medical_health: 11440
                      operations: 198127
                      product: 11077
                      revenue: 75777
                      senior_leadership: 1933
                    job_function_headcount:
                      finance:
                        accounting: 12824
                        finance: 12197
                        financial_planning_analysis: 2468
                        financial_reporting: 250
                        financial_risk: 886
                        financial_strategy: 91
                        financial_systems: 11
                        internal_audit_control: 850
                        investor_relations: 129
                        mergers_acquisitions: 259
                        real_estate_finance: 117
                        shared_services: 56
                        sourcing_procurement: 3767
                        tax: 822
                        treasury: 179
                      legal:
                        acquisitions: 8
                        compliance: 4921
                        contracts: 206
                        corporate_secretary: 217
                        ediscovery: 57
                        ethics: 1070
                        governance: 66
                        governmental_affairs_regulatory_law: 518
                        intellectual_property_patent: 63
                        labor_employment: 96
                        lawyer_attorney: 2014
                        legal: 31969
                        legal_counsel: 879
                        legal_operations: 3777
                        litigation: 89
                        privacy: 198
                      revenue:
                        account_management: 16253
                        business_development: 10633
                        channel_sales: 618
                        customer_retention_development: 1746
                        customer_success: 15253
                        field_outside_sales: 5375
                        inside_sales: 3475
                        partnerships: 380
                        revenue_operations: 26
                        sales: 43809
                        sales_enablement: 26
                        sales_engineering: 135
                        sales_operations: 254
                        sales_training: 465
                      engineering_technical:
                        artificial_intelligence_machine_learning: 4466
                        bioengineering_biometrics: 2
                        business_intelligence: 6811
                        chemical_engineering: 3014
                        cloud_mobility: 1144
                        data_science: 9589
                        devops: 502
                        digital_transformation: 13
                        emerging_technology_innovation: 576
                        engineering_technical: 37540
                        industrial_engineering: 1242
                        mechanic: 1037
                        mobile_development: 3282
                        project_management: 4923
                        research_development: 10123
                        scrum_master_agile_coach: 173
                        software_development: 57246
                        support_technical_services: 8328
                        technician: 7999
                        technology_operations: 64
                        test_quality_assurance: 6722
                        ui_ux: 458
                        web_development: 2551
                      operations:
                        call_center: 2095
                        construction: 2338
                        corporate_strategy: 1194
                        customer_service_support: 21434
                        enterprise_resource_planning: 389
                        facilities_management: 18036
                        leasing: 33
                        logistics: 75145
                        office_operations: 32304
                        operations: 27241
                        physical_security: 3280
                        project_development: 695
                        quality_management: 1801
                        real_estate: 961
                        safety: 2794
                        store_operations: 26641
                        supply_chain: 2728
                      senior_leadership:
                        executive: 348
                        finance_executive: 71
                        founder: 1128
                        human_resources_executive: 3
                        information_technology_executive: 35
                        legal_executive: 2
                        marketing_executive: 314
                        medical_health_executive: 3
                        operations_executive: 32
                        sales_executive: 2
                      medical_health:
                        anesthesiology: 33
                        chiropractics: 64
                        clinical_systems: 91
                        dentistry: 480
                        dermatology: 6
                        doctors_physicians: 1214
                        epidemiology: 1
                        first_responder: 504
                        medical_administration: 767
                        medical_education_training: 19
                        medical_research: 92
                        medicine: 1202
                        neurology: 1
                        nursing: 2053
                        nutrition_dietetics: 94
                        obstetrics_gynecology: 50
                        oncology: 3
                        ophthalmology: 11
                        optometry: 46
                        orthopedics: 14
                        pathology: 15
                        pediatrics: 20
                        pharmacy: 873
                        physical_therapy: 342
                        psychiatry: 383
                        psychology: 663
                        public_health: 803
                        radiology: 215
                        social_work: 2495
                      information_technology:
                        application_development: 37630
                        business_service_management_itsm: 1710
                        collaboration_web_app: 281
                        data_center: 597
                        data_warehouse: 2090
                        database_administration: 309
                        ecommerce_development: 285
                        enterprise_architecture: 784
                        help_desk_desktop_services: 4164
                        hr_financial_erp_systems: 807
                        information_security: 1742
                        information_technology: 9139
                        infrastructure: 2254
                        it_asset_management: 100
                        it_audit_it_compliance: 50
                        it_operations: 6941
                        it_procurement: 866
                        it_strategy: 439
                        it_training: 51
                        networking: 1528
                        project_program_management: 15780
                        quality_assurance: 8126
                        retail_store_systems: 1042
                        servers: 984
                        storage_disaster_recovery: 111
                        telecommunications: 186
                        virtualization: 915
                      education:
                        principal: 458
                        professor: 694
                        superintendent: 28
                        teacher: 7885
                      marketing:
                        advertising: 3032
                        brand_management: 2504
                        content_marketing: 2641
                        customer_experience: 812
                        customer_marketing: 8
                        demand_generation: 507
                        digital_marketing: 1640
                        ecommerce_marketing: 1121
                        event_marketing: 125
                        field_marketing: 740
                        lead_generation: 2937
                        marketing: 18980
                        marketing_analytics_insights: 716
                        marketing_communications: 496
                        marketing_operations: 71
                        product_marketing: 1319
                        public_relations: 972
                        search_engine_optimization_pay_per_click: 974
                        social_media_marketing: 1411
                        strategic_communications: 709
                        technical_marketing: 5
                      consulting:
                        consultant: 31420
                      human_resources:
                        compensation_benefits: 908
                        culture_diversity_inclusion: 182
                        employee_labor_relations: 1147
                        health_safety: 1087
                        hr_business_partner: 3332
                        human_resource_information_system: 1321
                        human_resources: 13884
                        learning_development: 7386
                        organizational_development: 154
                        people_operations: 10
                        recruiting_talent_acquisition: 5764
                        talent_management: 911
                        workforce_management: 571
                      design:
                        graphic_visual_brand_design: 3707
                        product_or_ui_ux_design: 2364
                      product:
                        product_development: 266
                        product_management: 10811
                    estimated_revenue: "$1M-$10M"
                With domain:
                  value:
                    id: 01a01a7c-f938-7046-881a-da9db4c2849f
                    object: company
                    name: A Company
                    website: https://company.com
                    linkedin_url: https://www.linkedin.com/company/company-1
                    keywords:
                    - sales
                    - ai sales
                    - sales engagement
                    estimated_number_of_employees: 500
                    size: 201-500 employees
                    industry: Software Development
                    logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-f938-7046-881a-da9db4c2849f
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      postal_code: '94103'
                      lat: 37.7749
                      long: -122.4194
                    locations:
                    - is_primary: true
                      address: 123 Main St, San Francisco, CA 94103, United States
                      country: United States
                      state: California
                      city: San Francisco
                      postal_code: '94103'
                    - is_primary: false
                      address: 456 Broadway, New York, NY 10001, United States
                      country: United States
                      state: New York
                      city: New York
                      postal_code: '10001'
                    overview: We're an AI company.
                    followers: 300
                    linkedin_presence: limited
                    founded_year: 1995
                    traffic_rank: 50
                    sic_codes:
                    - 1
                    - 2
                    - 3
                    naics_codes:
                    - 5112
                    - 511
                    - 51
                    type: Privately Held
                    total_funding: 0
                    latest_funding_stage: series_b
                    latest_funding_date: '2019-11-02'
                    funding_events:
                    - date: '2019-11-02'
                      type: Series B
                      investors: []
                      amount: 40000000
                      currency:
                      amount_usd:
                    is_b2b: true
                    is_b2c: false
                    technologies: []
                    department_headcount:
                      consulting: 31420
                      design: 5312
                      education: 9063
                      engineering_technical: 167805
                      finance: 31894
                      human_resources: 33265
                      information_technology: 94657
                      legal: 41863
                      marketing: 38192
                      medical_health: 11440
                      operations: 198127
                      product: 11077
                      revenue: 75777
                      senior_leadership: 1933
                    job_function_headcount:
                      finance:
                        accounting: 12824
                        finance: 12197
                        financial_planning_analysis: 2468
                        financial_reporting: 250
                        financial_risk: 886
                        financial_strategy: 91
                        financial_systems: 11
                        internal_audit_control: 850
                        investor_relations: 129
                        mergers_acquisitions: 259
                        real_estate_finance: 117
                        shared_services: 56
                        sourcing_procurement: 3767
                        tax: 822
                        treasury: 179
                      legal:
                        acquisitions: 8
                        compliance: 4921
                        contracts: 206
                        corporate_secretary: 217
                        ediscovery: 57
                        ethics: 1070
                        governance: 66
                        governmental_affairs_regulatory_law: 518
                        intellectual_property_patent: 63
                        labor_employment: 96
                        lawyer_attorney: 2014
                        legal: 31969
                        legal_counsel: 879
                        legal_operations: 3777
                        litigation: 89
                        privacy: 198
                      revenue:
                        account_management: 16253
                        business_development: 10633
                        channel_sales: 618
                        customer_retention_development: 1746
                        customer_success: 15253
                        field_outside_sales: 5375
                        inside_sales: 3475
                        partnerships: 380
                        revenue_operations: 26
                        sales: 43809
                        sales_enablement: 26
                        sales_engineering: 135
                        sales_operations: 254
                        sales_training: 465
                      engineering_technical:
                        artificial_intelligence_machine_learning: 4466
                        bioengineering_biometrics: 2
                        business_intelligence: 6811
                        chemical_engineering: 3014
                        cloud_mobility: 1144
                        data_science: 9589
                        devops: 502
                        digital_transformation: 13
                        emerging_technology_innovation: 576
                        engineering_technical: 37540
                        industrial_engineering: 1242
                        mechanic: 1037
                        mobile_development: 3282
                        project_management: 4923
                        research_development: 10123
                        scrum_master_agile_coach: 173
                        software_development: 57246
                        support_technical_services: 8328
                        technician: 7999
                        technology_operations: 64
                        test_quality_assurance: 6722
                        ui_ux: 458
                        web_development: 2551
                      operations:
                        call_center: 2095
                        construction: 2338
                        corporate_strategy: 1194
                        customer_service_support: 21434
                        enterprise_resource_planning: 389
                        facilities_management: 18036
                        leasing: 33
                        logistics: 75145
                        office_operations: 32304
                        operations: 27241
                        physical_security: 3280
                        project_development: 695
                        quality_management: 1801
                        real_estate: 961
                        safety: 2794
                        store_operations: 26641
                        supply_chain: 2728
                      senior_leadership:
                        executive: 348
                        finance_executive: 71
                        founder: 1128
                        human_resources_executive: 3
                        information_technology_executive: 35
                        legal_executive: 2
                        marketing_executive: 314
                        medical_health_executive: 3
                        operations_executive: 32
                        sales_executive: 2
                      medical_health:
                        anesthesiology: 33
                        chiropractics: 64
                        clinical_systems: 91
                        dentistry: 480
                        dermatology: 6
                        doctors_physicians: 1214
                        epidemiology: 1
                        first_responder: 504
                        medical_administration: 767
                        medical_education_training: 19
                        medical_research: 92
                        medicine: 1202
                        neurology: 1
                        nursing: 2053
                        nutrition_dietetics: 94
                        obstetrics_gynecology: 50
                        oncology: 3
                        ophthalmology: 11
                        optometry: 46
                        orthopedics: 14
                        pathology: 15
                        pediatrics: 20
                        pharmacy: 873
                        physical_therapy: 342
                        psychiatry: 383
                        psychology: 663
                        public_health: 803
                        radiology: 215
                        social_work: 2495
                      information_technology:
                        application_development: 37630
                        business_service_management_itsm: 1710
                        collaboration_web_app: 281
                        data_center: 597
                        data_warehouse: 2090
                        database_administration: 309
                        ecommerce_development: 285
                        enterprise_architecture: 784
                        help_desk_desktop_services: 4164
                        hr_financial_erp_systems: 807
                        information_security: 1742
                        information_technology: 9139
                        infrastructure: 2254
                        it_asset_management: 100
                        it_audit_it_compliance: 50
                        it_operations: 6941
                        it_procurement: 866
                        it_strategy: 439
                        it_training: 51
                        networking: 1528
                        project_program_management: 15780
                        quality_assurance: 8126
                        retail_store_systems: 1042
                        servers: 984
                        storage_disaster_recovery: 111
                        telecommunications: 186
                        virtualization: 915
                      education:
                        principal: 458
                        professor: 694
                        superintendent: 28
                        teacher: 7885
                      marketing:
                        advertising: 3032
                        brand_management: 2504
                        content_marketing: 2641
                        customer_experience: 812
                        customer_marketing: 8
                        demand_generation: 507
                        digital_marketing: 1640
                        ecommerce_marketing: 1121
                        event_marketing: 125
                        field_marketing: 740
                        lead_generation: 2937
                        marketing: 18980
                        marketing_analytics_insights: 716
                        marketing_communications: 496
                        marketing_operations: 71
                        product_marketing: 1319
                        public_relations: 972
                        search_engine_optimization_pay_per_click: 974
                        social_media_marketing: 1411
                        strategic_communications: 709
                        technical_marketing: 5
                      consulting:
                        consultant: 31420
                      human_resources:
                        compensation_benefits: 908
                        culture_diversity_inclusion: 182
                        employee_labor_relations: 1147
                        health_safety: 1087
                        hr_business_partner: 3332
                        human_resource_information_system: 1321
                        human_resources: 13884
                        learning_development: 7386
                        organizational_development: 154
                        people_operations: 10
                        recruiting_talent_acquisition: 5764
                        talent_management: 911
                        workforce_management: 571
                      design:
                        graphic_visual_brand_design: 3707
                        product_or_ui_ux_design: 2364
                      product:
                        product_development: 266
                        product_management: 10811
                    estimated_revenue: "$1M-$10M"
              schema:
                "$ref": "#/components/schemas/response_company_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: company_not_found
                      title: Company Not Found
                      detail: A matching company was not found in our database
                      source:
                        pointer: "/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either domain or linkedin_url
                    object: error
                Type error:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Unsupported value provided for field: linkedin_url.'
                      source:
                        pointer: "/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Single company enrichment
  "/companies/search":
    post:
      summary: Search companies
      parameters: []
      tags:
      - Searcher
      responses:
        '200':
          description: Ok
          content:
            application/json:
              examples:
                Ok:
                  value:
                    object: company_search_result
                    results:
                    - id: 01a01a7c-fcb8-7a78-a3a6-53fe3e15d2d2
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7c-fcb8-7a78-a3a6-53fe3e15d2d2
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations:
                      - is_primary: true
                        address: 123 Main St, San Francisco, CA 94103, United States
                        country: United States
                        state: California
                        city: San Francisco
                        postal_code: '94103'
                      - is_primary: false
                        address: 456 Broadway, New York, NY 10001, United States
                        country: United States
                        state: New York
                        city: New York
                        postal_code: '10001'
                      overview: We're an AI company.
                      followers: 300
                      linkedin_presence: limited
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    _pagination:
                      page: 1
                      page_size: 30
                      total_pages: 1
                      total: 1
              schema:
                "$ref": "#/components/schemas/response_company_search_result_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Bad industry:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Industry A' is not a supported industry."
                      source:
                        pointer: "/company_industries"
                    object: error
                Bad company type:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Some company type' is not a supported company type."
                      source:
                        pointer: "/company_types"
                    object: error
                Bad company focus:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'business2business' is not a supported company focus
                        value."
                      source:
                        pointer: "/company_focuses"
                    object: error
                Bad company size:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'1000000000+' is not a supported company size."
                      source:
                        pointer: "/company_sizes"
                    object: error
                Bad company LinkedIn presence:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'invalid_slug' is not a supported company LinkedIn
                        presence tier."
                      source:
                        pointer: "/company_linkedin_presence"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                company_names:
                  type: array
                  items:
                    type: string
                company_exclude_names:
                  type: array
                  items:
                    type: string
                company_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                company_exclude_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                company_locations:
                  type: array
                  items:
                    type: string
                company_exclude_locations:
                  type: array
                  items:
                    type: string
                company_domains:
                  type: array
                  items:
                    type: string
                    format: domain
                company_exclude_domains:
                  type: array
                  items:
                    type: string
                    format: domain
                company_linkedin_urls:
                  type: array
                  items:
                    type: string
                company_exclude_linkedin_urls:
                  type: array
                  items:
                    type: string
                company_domains_match_subsidiaries_and_affiliates:
                  type: boolean
                company_focuses:
                  type: array
                  items:
                    type: string
                    enum:
                    - b2b
                    - b2c
                company_types:
                  type: array
                  items:
                    type: string
                    enum:
                    - Public Company
                    - Educational
                    - Self Employed
                    - Government Agency
                    - Non Profit
                    - Self Owned
                    - Privately Held
                    - Partnership
                company_sizes:
                  type: array
                  items:
                    type: string
                    enum:
                    - 1-10 employees
                    - 11-50 employees
                    - 51-200 employees
                    - 201-500 employees
                    - 501-1000 employees
                    - 1001-5000 employees
                    - 5001-10000 employees
                    - 10001+ employees
                company_industries:
                  type: array
                  description: 'Available options: [Supported industries](/api-reference/supported-industries)'
                  items:
                    type: string
                company_exclude_industries:
                  type: array
                  description: 'Available options: [Supported industries](/api-reference/supported-industries)'
                  items:
                    type: string
                company_investors:
                  type: array
                  description: Array of investor names. Filter for companies that
                    have received investment by any of the specified investors.
                  items:
                    type: string
                company_shares_investors_with:
                  type: array
                  description: Array of company names. Filter for companies that share
                    one or more common investors with the specified companies.
                  items:
                    type: string
                company_keywords:
                  type: array
                  description: Keywords to search in the company description. Matches
                    any keyword by default.
                  items:
                    type: string
                company_exclude_keywords:
                  type: array
                  description: Keywords to exclude from the company description.
                  items:
                    type: string
                company_revenue:
                  type: array
                  description: Filter by estimated revenue range.
                  items:
                    type: string
                    enum:
                    - "$0-$1M"
                    - "$1M-$10M"
                    - "$10M-$100M"
                    - "$100M-$1B"
                    - "$1B+"
                company_founded_date:
                  type: object
                  description: Filter by founding year range.
                  properties:
                    min:
                      type: integer
                      description: Minimum founding year
                    max:
                      type: integer
                      description: Maximum founding year
                company_web_traffic_rank:
                  type: object
                  description: Filter by web traffic rank. Lower rank means more traffic.
                  properties:
                    min:
                      type: integer
                      description: Minimum traffic rank
                    max:
                      type: integer
                      description: Maximum traffic rank
                job_openings:
                  type: object
                  description: Filter by companies with matching open positions.
                  properties:
                    titles:
                      type: array
                      description: Free-text job titles to filter by.
                      items:
                        type: string
                news:
                  type: object
                  description: Filter by recent company news.
                  properties:
                    categories:
                      type: array
                      description: News category slugs to filter by (e.g. hires, launches,
                        partners_with). Defaults to all categories if omitted.
                      items:
                        type: string
                    range_months:
                      type: integer
                      description: Number of months to look back for news.
                headcount_growth:
                  type: object
                  description: Filter by total headcount growth percentage over a
                    time period.
                  properties:
                    growth_rates:
                      type: array
                      items:
                        type: object
                        properties:
                          min:
                            type: integer
                            description: Minimum growth percentage
                          max:
                            type: integer
                            description: Maximum growth percentage
                    time_frame_in_months:
                      type: integer
                      enum:
                      - 3
                      - 6
                      - 12
                      description: Time frame in months to measure growth over.
                crm_account_owner:
                  type: array
                  description: Filter by CRM account owner emails. Requires a connected
                    CRM integration (Salesforce or HubSpot). Returns an error if no
                    owners match the provided emails.
                  items:
                    type: string
                    format: email
                company_last_funding:
                  type: object
                  description: Filter by last funding round.
                  properties:
                    round_type:
                      type: array
                      description: Funding round types to filter by.
                      items:
                        type: string
                        enum:
                        - pre_seed
                        - seed
                        - angel
                        - venture_round_unknown_series
                        - series_a
                        - series_b
                        - series_c
                        - series_d
                        - series_e
                        - series_f
                        - series_g
                        - series_h
                        - series_i
                        - series_j
                        - debt
                        - equity_crowdfunding
                        - convertible_note
                        - ico
                        - private_equity
                        - other
                    range_months:
                      type: integer
                      description: Number of months to look back for the last funding
                        round.
                company_linkedin_presence:
                  type: array
                  description: 'Filter by the company''s LinkedIn follower tier. Supported
                    values: `massive` — Massive following (100,000+ followers), `large`
                    — Large following (10,000 - 99,999 followers), `moderate` — Moderate
                    following (1,000 - 9,999 followers), `limited` — Limited following
                    (1 - 999 followers), `none` — No following (0 followers). All
                    ranges are inclusive.'
                  items:
                    type: string
                    enum:
                    - large
                    - limited
                    - massive
                    - moderate
                    - none
                page:
                  type: integer
                  default: 1
                page_size:
                  type: integer
                  default: 5
                  minimum: 1
                  description: Number of results per page. Values greater than 50
                    are accepted and capped at 50.
        required: true
        description: Parameters to use for searching companies.
      description: Search companies
  "/email-validations":
    post:
      summary: Start batch of email validations
      parameters: []
      tags:
      - Email Validation
      responses:
        '202':
          description: Batch accepted
          content:
            application/json:
              examples:
                Batch accepted:
                  value:
                    id: 01a01a7d-0376-7888-82df-3e1ae1107980
                    object: email_validation
                    status: queued
                    results: []
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0376-7888-82df-3e1ae1107980"
              schema:
                "$ref": "#/components/schemas/response_email_validation_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array of objects containing
                        the key `email`'
                      source:
                        pointer: "/emails"
                    object: error
                Type error:
                  value:
                    _errors:
                    - code: type_error
                      title: Type Error
                      detail: 'Type error: emails must be an array of objects containing
                        the key `email`'
                      source:
                        pointer: "/emails"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - emails
              additionalProperties: false
              properties:
                emails:
                  type: array
                  items:
                    type: object
                    required:
                    - email
                    additionalProperties: false
                    properties:
                      email:
                        type: string
                        format: email
        required: true
        description: Emails to be validated
      description: Start batch of email validations
  "/email-validations/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Batch id
      schema:
        type: string
    - name: page[size]
      in: query
      required: false
      description: Page size
      schema:
        type: string
    - name: page[after]
      in: query
      required: false
      description: Page after
      schema:
        type: string
    - name: page[before]
      in: query
      required: false
      description: Page before
      schema:
        type: string
    get:
      summary: Retrieve email validation results
      parameters: []
      tags:
      - Email Validation
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Processing:
                  value:
                    id: 01a01a7d-0883-78ad-a808-6161fd83b73b
                    object: email_validation
                    status: processing
                    results: []
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0883-78ad-a808-6161fd83b73b"
                Completed:
                  value:
                    id: 01a01a7d-0987-7d7e-988a-eb10b65019f7
                    object: email_validation
                    status: completed
                    results:
                    - object: email_validation_result
                      email: foo+3@example.com
                      result: deliverable
                      catch_all: false
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0987-7d7e-988a-eb10b65019f7"
                Partial error:
                  value:
                    id: 01a01a7d-0ab2-7aee-83a4-090edfc46078
                    object: email_validation
                    status: error
                    results:
                    - object: email_validation_result
                      email: foo+6@example.com
                      result: deliverable
                      catch_all: false
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0ab2-7aee-83a4-090edfc46078"
                Canceled:
                  value:
                    id: 01a01a7d-0bf4-73f8-b94c-4059316392d6
                    object: email_validation
                    status: canceled
                    results:
                    - object: email_validation_result
                      email: foo+8@example.com
                      result: deliverable
                      catch_all: false
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0bf4-73f8-b94c-4059316392d6"
              schema:
                "$ref": "#/components/schemas/response_email_validation_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find email validation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve email validation results
    patch:
      summary: Cancel batch of email validations
      parameters: []
      tags:
      - Email Validation
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 01a01a7d-0eb1-72c7-bca5-79abc41b5144
                    object: email_validation
                    status: canceled
                    results: []
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0eb1-72c7-bca5-79abc41b5144"
              schema:
                "$ref": "#/components/schemas/response_email_validation_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field for request: status'
                      source:
                        pointer: "/status"
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-0ff9-7946-bcc6-1171f5af7f39"
                    object: error
                Unsupported value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: You used status 'error' when only 'canceled' is accepted.
                      source:
                        pointer: "/status"
                    _links:
                      self:
                        href: "/email-validations/01a01a7d-1103-73c7-b164-be99c3a26af1"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find email validation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - status
              additionalProperties: false
              properties:
                status:
                  type: string
                  enum:
                  - canceled
        required: true
        description: New batch status
      description: Cancel batch of email validations
  "/people/enrichment-requests":
    post:
      summary: Start batch of person enrichments
      parameters: []
      tags:
      - Person Enrichment
      responses:
        '202':
          description: Batch accepted
          content:
            application/json:
              examples:
                Batch accepted:
                  value:
                    id: 1
                    object: person_enrichment
                    status: queued
                    results: []
                    _links:
                      self:
                        href: "/people/enrichment-requests/1"
              schema:
                "$ref": "#/components/schemas/response_person_enrichment_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: leads'
                      source:
                        pointer: "/leads"
                    object: error
                Type error:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: leads'
                      source:
                        pointer: "/leads"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - leads
              additionalProperties: false
              properties:
                leads:
                  type: array
                  items:
                    type: object
                    additionalProperties: false
                    properties:
                      email:
                        type: string
                        format: email
                      linkedin_url:
                        type: string
                      company_domain:
                        type: string
                      company_name:
                        type: string
                      name:
                        type: string
                      title:
                        type: string
                reveal_email:
                  type: boolean
                reveal_phone_numbers:
                  type: boolean
        required: true
        description: Leads to be enriched
      description: Start batch of person enrichments
  "/people/enrichment-requests/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Batch id
      schema:
        type: string
    - name: page[size]
      in: query
      required: false
      description: Page size
      schema:
        type: string
    - name: page[after]
      in: query
      required: false
      description: Page after
      schema:
        type: string
    - name: page[before]
      in: query
      required: false
      description: Page before
      schema:
        type: string
    get:
      summary: Retrieve person enrichment results
      parameters: []
      tags:
      - Person Enrichment
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Processing:
                  value:
                    id: 2
                    object: person_enrichment
                    status: processing
                    results: []
                    _links:
                      self:
                        href: "/people/enrichment-requests/2"
                Completed:
                  value:
                    id: 3
                    object: person_enrichment
                    status: completed
                    results:
                    - linkedin_url: https://www.linkedin.com/in/test-linkedin-2a648811
                      id: 4
                      status: enriched
                      result:
                        id: 01a01a7d-1c33-7a93-b6fe-5661f01ffbb9
                        object: person
                        name: Test Person
                        first_name: Test
                        last_name: Person
                        linkedin_url: https://www.linkedin.com/in/person-1
                        title: Sales Manager
                        current_position_start_date: '2022-05-01'
                        image_url: https://example.com/resource
                        location: San Francisco, California, United States
                        location_details:
                          city: San Francisco
                          state: California
                          country: United States
                        linkedin_presence: none
                        company:
                          id: 01a01a7d-19cf-7c8c-9df7-d413a980fb64
                          object: company
                          name: Circle Health
                          linkedin_url: https://www.linkedin.com/company/company-1
                          keywords:
                          - Private healthcare
                          estimated_number_of_employees: 0
                          industry: Software Development
                          logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-19cf-7c8c-9df7-d413a980fb64
                          location: United States
                          location_details:
                            country: United States
                          overview: Circle Health is a group of hospitals in the UK
                          followers: 0
                          linkedin_presence: none
                          naics_codes:
                          - 5112
                          - 511
                          - 51
                        gender: unknown
                    - linkedin_url: https://www.linkedin.com/in/test-linkedin-48150551
                      id: 5
                      status: enriched
                      result:
                        id: 01a01a7d-1c5f-7d9d-a929-fa3baffa00ab
                        object: person
                        name: Test Person
                        first_name: Test
                        last_name: Person
                        linkedin_url: https://www.linkedin.com/in/person-2
                        title: Sales Manager
                        current_position_start_date: '2022-05-01'
                        image_url: https://example.com/resource
                        location: San Francisco, California, United States
                        location_details:
                          city: San Francisco
                          state: California
                          country: United States
                        linkedin_presence: none
                        company:
                          id: 01a01a7d-1c59-7729-83bc-1c17936528f1
                          object: company
                          name: Circle Health
                          linkedin_url: https://www.linkedin.com/company/company-2
                          keywords:
                          - Private healthcare
                          estimated_number_of_employees: 0
                          industry: Software Development
                          logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-1c59-7729-83bc-1c17936528f1
                          location: United States
                          location_details:
                            country: United States
                          overview: Circle Health is a group of hospitals in the UK
                          followers: 0
                          linkedin_presence: none
                          naics_codes:
                          - 5112
                          - 511
                          - 51
                        gender: unknown
                    _links:
                      self:
                        href: "/people/enrichment-requests/3"
                Partial error:
                  value:
                    id: 4
                    object: person_enrichment
                    status: error
                    results:
                    - linkedin_url: https://www.linkedin.com/in/test-linkedin-c58b5313
                      id: 6
                      status: enriched
                      result:
                        id: 01a01a7d-1df0-71ca-8d3e-17a1963c7900
                        object: person
                        name: Test Person
                        first_name: Test
                        last_name: Person
                        linkedin_url: https://www.linkedin.com/in/person-1
                        title: Sales Manager
                        current_position_start_date: '2022-05-01'
                        image_url: https://example.com/resource
                        location: San Francisco, California, United States
                        location_details:
                          city: San Francisco
                          state: California
                          country: United States
                        linkedin_presence: none
                        company:
                          id: 01a01a7d-1dea-7874-ae05-a79250c8b40f
                          object: company
                          name: Circle Health
                          linkedin_url: https://www.linkedin.com/company/company-1
                          keywords:
                          - Private healthcare
                          estimated_number_of_employees: 0
                          industry: Software Development
                          logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-1dea-7874-ae05-a79250c8b40f
                          location: United States
                          location_details:
                            country: United States
                          overview: Circle Health is a group of hospitals in the UK
                          followers: 0
                          linkedin_presence: none
                          naics_codes:
                          - 5112
                          - 511
                          - 51
                        gender: unknown
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    _links:
                      self:
                        href: "/people/enrichment-requests/4"
                Canceled:
                  value:
                    id: 5
                    object: person_enrichment
                    status: canceled
                    results:
                    - linkedin_url: https://www.linkedin.com/in/test-linkedin-ad5a6ab9
                      id: 7
                      status: enriched
                      result:
                        id: 01a01a7d-1f36-7212-948a-c447bd0eb06b
                        object: person
                        name: Test Person
                        first_name: Test
                        last_name: Person
                        linkedin_url: https://www.linkedin.com/in/person-1
                        title: Sales Manager
                        current_position_start_date: '2022-05-01'
                        image_url: https://example.com/resource
                        location: San Francisco, California, United States
                        location_details:
                          city: San Francisco
                          state: California
                          country: United States
                        linkedin_presence: none
                        company:
                          id: 01a01a7d-1f31-7ffe-8e84-68ce3b4e0668
                          object: company
                          name: Circle Health
                          linkedin_url: https://www.linkedin.com/company/company-1
                          keywords:
                          - Private healthcare
                          estimated_number_of_employees: 0
                          industry: Software Development
                          logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-1f31-7ffe-8e84-68ce3b4e0668
                          location: United States
                          location_details:
                            country: United States
                          overview: Circle Health is a group of hospitals in the UK
                          followers: 0
                          linkedin_presence: none
                          naics_codes:
                          - 5112
                          - 511
                          - 51
                        gender: unknown
                    _links:
                      self:
                        href: "/people/enrichment-requests/5"
              schema:
                "$ref": "#/components/schemas/response_person_enrichment_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find person enrichment.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve person enrichment results
    patch:
      summary: Cancel batch of person enrichments
      parameters: []
      tags:
      - Person Enrichment
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 6
                    object: person_enrichment
                    status: canceled
                    results: []
                    _links:
                      self:
                        href: "/people/enrichment-requests/6"
              schema:
                "$ref": "#/components/schemas/response_person_enrichment_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: status'
                      source:
                        pointer: "/status"
                    object: error
                Unsupported value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: You used status 'error' when only 'canceled' is accepted.
                      source:
                        pointer: "/status"
                    object: error
                Cannot cancel finished batch:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Cannot update status of a finished person enrichment
                        batch.
                      source:
                        pointer: "/status"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find person enrichment batch.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - status
              additionalProperties: false
              properties:
                status:
                  type: string
                  enum:
                  - canceled
        required: true
        description: New batch status
      description: Cancel batch of person enrichments
  "/lead-lists":
    get:
      summary: List Lead Lists
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by lead list status
        schema:
          type: string
      - name: owner_id
        in: query
        required: false
        description: Filter by lead list owner id
        schema:
          type: string
      - name: owner_email
        in: query
        required: false
        description: Filter by lead list owner email
        schema:
          type: string
      tags:
      - Lead List
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    lead_lists:
                    - id: 01a01a7d-26be-7c30-b0de-d191662ac881
                      name: Sample list 1
                      status: completed
                      url: https://localhost:3000/dashboard/lead_lists/01a01a7d-26be-7c30-b0de-d191662ac881
                      shared: false
                      visible: true
                      owner: admin@example.com
                      type: linkedin
                      created_at: '2026-08-19T14:46:44Z'
                      updated_at: '2026-08-19T14:46:44Z'
                    _links:
                      self:
                        href: "/lead-lists?page[size]=20"
              schema:
                type: object
                properties:
                  lead_lists:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        status:
                          type: string
                        url:
                          type: string
                        shared:
                          type: boolean
                        visible:
                          type: boolean
                        owner:
                          type: string
                        created_at:
                          type: string
                          format: date_time
                        updated_at:
                          type: string
                          format: date_time
                        type:
                          type: string
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Unsupported status value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'invalid' is not a supported status."
                      source:
                        pointer: "/status"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: List Lead Lists
    post:
      summary: Create Lead List
      parameters: []
      tags:
      - Lead List
      responses:
        '202':
          description: Lead List accepted
          content:
            application/json:
              schema:
                "$ref": "#/components/schemas/response_lead_list_object"
              examples:
                'Type: linkedin':
                  value:
                    id: 01a01a7d-2a6e-701d-b42d-3cd2bb4fe156
                    object: lead_list
                    name: my list
                    status: queued
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-2a6e-701d-b42d-3cd2bb4fe156
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:45Z'
                    updated_at: '2026-08-19T14:46:45Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-2a6e-701d-b42d-3cd2bb4fe156"
                'Type: email':
                  value:
                    id: 01a01a7d-2b1c-7601-80e8-3f3a41129cdb
                    object: lead_list
                    name: my list
                    status: queued
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-2b1c-7601-80e8-3f3a41129cdb
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: email
                    created_at: '2026-08-19T14:46:45Z'
                    updated_at: '2026-08-19T14:46:45Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-2b1c-7601-80e8-3f3a41129cdb"
                Blank name provided:
                  value:
                    id: 01a01a7d-2bd0-76e2-ad15-dc7ee63aa31a
                    object: lead_list
                    name: Lead List created via API
                    status: queued
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-2bd0-76e2-ad15-dc7ee63aa31a
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:45Z'
                    updated_at: '2026-08-19T14:46:45Z'
                    options:
                      reveal_phone_numbers: false
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-2bd0-76e2-ad15-dc7ee63aa31a"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Unsupported value (type):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'foo' is not a supported type."
                      source:
                        pointer: "/type"
                    object: error
                Missing value (type):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: type'
                      source:
                        pointer: "/type"
                    object: error
                Missing field (owner):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: owner'
                      source:
                        pointer: "/owner"
                    object: error
                Unsupported value (owner):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'null@example.com' is not a valid owner"
                      source:
                        pointer: "/owner"
                    object: error
                Missing field (leads):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: leads'
                      source:
                        pointer: "/leads"
                    object: error
                Unsupported value (leads over limit):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Number of leads exceeds 10,000 limit.
                      source:
                        pointer: "/leads"
                    object: error
                Unsupported value (lead with no LinkedIn URL):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Missing field from request: leads[0].linkedin_url'
                      source:
                        pointer: "/leads/0/linkedin_url"
                    object: error
                Unsupported value (lead with invalid LinkedIn URL):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Unsupported value provided for field: leads[0].linkedin_url'
                      source:
                        pointer: "/leads/0/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - shared
              - owner
              - leads
              - type
              additionalProperties: false
              properties:
                name:
                  type: string
                shared:
                  type: boolean
                visible:
                  type: boolean
                owner:
                  type: string
                  format: email
                type:
                  type: string
                  enum:
                  - linkedin
                  - email
                  - titles_and_company
                options:
                  type: object
                  additionalProperties: false
                  properties:
                    reveal_phone_numbers:
                      type: boolean
                    validate_email:
                      type: boolean
                    enrich:
                      type: boolean
                leads:
                  type: array
                  description: You may send up to 10000 leads at a time.
                  maxItems: 10000
                  items:
                    type: object
                    additionalProperties: true
                    properties:
                      linkedin_url:
                        type: string
                      email:
                        type: string
                        format: email
                      title:
                        type: string
                      company_name:
                        type: string
                      company_domain:
                        type: string
                      phone_numbers:
                        type: array
                        items:
                          type: string
                      context:
                        type: object
                        additionalProperties: true
                        description: Additional custom fields to store on the lead.
                          These fields are flattened into the lead data fields.
        required: true
        description: Leads to create the list with
      description: Create Lead List
  "/lead-lists/{id}":
    get:
      summary: Retrieve Lead List
      parameters:
      - name: id
        in: path
        required: true
        description: Lead List id
        schema:
          type: string
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      tags:
      - Lead List
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Processing:
                  value:
                    id: 01a01a7d-3184-76da-983c-fc7f66d11d6c
                    object: lead_list
                    name: my list
                    status: processing
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-3184-76da-983c-fc7f66d11d6c
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:47Z'
                    updated_at: '2026-08-19T14:46:47Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-3184-76da-983c-fc7f66d11d6c"
                Completed:
                  value:
                    id: 01a01a7d-321d-7797-8e23-e3c9c9e504b4
                    object: lead_list
                    name: my list
                    status: completed
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-321d-7797-8e23-e3c9c9e504b4
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:47Z'
                    updated_at: '2026-08-19T14:46:47Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                    - id: 4ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      object: lead_list_entry
                      email: john_smith@example.com
                      person_id: 01a01a7d-320f-7e4c-a3c4-59dd80a66fa7
                      linkedin_url: https://www.linkedin.com/in/john-smith
                      linkedin: https://www.linkedin.com/in/john-smith
                      first_name: John
                      last_name: Smith
                      company_name: Example, Inc
                      company_domain: example.com
                      industry: Computer Software
                      title: CEO
                      email_validation_result:
                        object: email_validation_result
                        email: john_smith@example.com
                        result: undeliverable
                      data:
                        example_data_field: '1'
                      phone_numbers:
                      - id: 01a01a7d-340f-7f77-b300-341f0a4ff77d
                        object: phone_number
                        number: "+1 639-300-0001"
                        type: mobile
                        source: amplemarket
                        is_wrong_number: false
                      - id: 01a01a7d-341a-74ca-a380-8e1781c14606
                        object: phone_number
                        number: "+1 639-300-0002"
                        type: mobile
                        source: amplemarket
                        is_wrong_number: false
                    - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      object: lead_list_entry
                      email: jane_smith@example.com
                      person_id: 01a01a7d-3466-78a0-bd5e-d808ebe2ad44
                      linkedin_url: https://www.linkedin.com/in/jane-smith
                      linkedin: https://www.linkedin.com/in/jane-smith
                      first_name: Jane
                      last_name: Smith
                      company_name: Example, Inc
                      company_domain: example.com
                      industry: Computer Software
                      title: CFO
                      email_validation_result:
                        object: email_validation_result
                        email: jane_smith@example.com
                        result: risky
                      data:
                        example_data_field: '2'
                      phone_numbers: []
                    - id: 6ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      object: lead_list_entry
                      email: jim_smith@example.com
                      person_id: 01a01a7d-3482-728e-877d-b2f66421ce1c
                      linkedin_url: https://www.linkedin.com/in/jim-smith
                      linkedin: https://www.linkedin.com/in/jim-smith
                      first_name: Jim
                      last_name: Smith
                      company_name: Example, Inc
                      company_domain: example.com
                      industry: Computer Software
                      title: CTO
                      email_validation_result:
                        object: email_validation_result
                        email: jim_smith@example.com
                        result: risky
                      data:
                        example_data_field: '3'
                      phone_numbers: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-321d-7797-8e23-e3c9c9e504b4"
                Completed (Pagination using after):
                  value:
                    id: 01a01a7d-358c-7d72-93a4-ba214e20eae5
                    object: lead_list
                    name: my list
                    status: completed
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-358c-7d72-93a4-ba214e20eae5
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:48Z'
                    updated_at: '2026-08-19T14:46:48Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                    - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      object: lead_list_entry
                      email: jane_smith@example.com
                      person_id: 01a01a7d-35c4-7e55-8664-e66b102106a1
                      linkedin_url: https://www.linkedin.com/in/jane-smith
                      linkedin: https://www.linkedin.com/in/jane-smith
                      first_name: Jane
                      last_name: Smith
                      company_name: Example, Inc
                      company_domain: example.com
                      industry: Computer Software
                      title: CFO
                      email_validation_result:
                        object: email_validation_result
                        email: jane_smith@example.com
                        result: risky
                      data:
                        example_data_field: '2'
                      phone_numbers: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-358c-7d72-93a4-ba214e20eae5"
                      prev:
                        href: "/lead-lists/01a01a7d-358c-7d72-93a4-ba214e20eae5?page[size]=1&page[before]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec"
                      next:
                        href: "/lead-lists/01a01a7d-358c-7d72-93a4-ba214e20eae5?page[size]=1&page[after]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec"
                Completed (Pagination using before):
                  value:
                    id: 01a01a7d-368e-7aed-9c0f-f44401362a54
                    object: lead_list
                    name: my list
                    status: completed
                    url: https://localhost:3000/dashboard/lead_lists/01a01a7d-368e-7aed-9c0f-f44401362a54
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-08-19T14:46:48Z'
                    updated_at: '2026-08-19T14:46:48Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                    - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      object: lead_list_entry
                      email: jane_smith@example.com
                      person_id: 01a01a7d-36cc-7915-91c3-e01bcc1bed9a
                      linkedin_url: https://www.linkedin.com/in/jane-smith
                      linkedin: https://www.linkedin.com/in/jane-smith
                      first_name: Jane
                      last_name: Smith
                      company_name: Example, Inc
                      company_domain: example.com
                      industry: Computer Software
                      title: CFO
                      email_validation_result:
                        object: email_validation_result
                        email: jane_smith@example.com
                        result: risky
                      data:
                        example_data_field: '2'
                      phone_numbers: []
                    _links:
                      self:
                        href: "/lead-lists/01a01a7d-368e-7aed-9c0f-f44401362a54"
                      prev:
                        href: "/lead-lists/01a01a7d-368e-7aed-9c0f-f44401362a54?page[size]=1&page[before]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec"
                      next:
                        href: "/lead-lists/01a01a7d-368e-7aed-9c0f-f44401362a54?page[size]=1&page[after]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec"
              schema:
                "$ref": "#/components/schemas/response_lead_list_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find lead list.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '410':
          description: Gone
          content:
            application/json:
              examples:
                Gone:
                  value:
                    _errors:
                    - code: gone
                      title: Gone
                      detail: Lead list is no longer available.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve Lead List
  "/lead-lists/{id}/leads":
    post:
      summary: Add Leads to a List
      parameters:
      - name: id
        in: path
        required: true
        description: Lead List id
        schema:
          type: string
      tags:
      - Lead List
      - Leads
      responses:
        '202':
          description: Lead List Leads accepted
          content:
            application/json:
              examples:
                'Lead List type: linkedin':
                  value:
                    total: 1
                    total_added_to_lead_list: 1
                'Lead List type: email':
                  value:
                    total: 1
                    total_added_to_lead_list: 1
                'Lead List type: email with phone numbers':
                  value:
                    total: 1
                    total_added_to_lead_list: 1
                Partial import due to reaching the total limit per list:
                  value:
                    total: 3
                    total_added_to_lead_list: 2
                Partial import due to duplicates in the batch:
                  value:
                    total: 3
                    total_added_to_lead_list: 2
                No import due to duplicates in the list:
                  value:
                    total: 2
                    total_added_to_lead_list: 0
              schema:
                type: object
                additionalProperties: false
                properties:
                  total:
                    type: integer
                    description: Total number of leads processed in the request.
                  total_added_to_lead_list:
                    type: integer
                    description: Total number of leads successfully added to the lead
                      list.
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing field (type):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: type'
                      source:
                        pointer: "/type"
                    object: error
                Unsupported value (type):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'foo' is not a supported type."
                      source:
                        pointer: "/type"
                    object: error
                Missing field (leads):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: leads'
                      source:
                        pointer: "/leads"
                    object: error
                Unsupported value (leads over limit per leads batch):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Number of leads exceeds 10,000 limit.
                      source:
                        pointer: "/leads"
                    object: error
                Unsupported value (lead with no LinkedIn URL for linkedin list):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Missing field from request: leads[1].linkedin_url'
                      source:
                        pointer: "/leads/1/linkedin_url"
                    object: error
                Unsupported value (lead with invalid LinkedIn URL for linkedin list):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Unsupported value provided for field: leads[1].linkedin_url'
                      source:
                        pointer: "/leads/1/linkedin_url"
                    object: error
                Unsupported value (lead with no email for email list):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Missing field from request: leads[1].email'
                      source:
                        pointer: "/leads/1/email"
                    object: error
                Unsupported value (lead with invalid email for email list):
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Unsupported value provided for field: leads[1].email'
                      source:
                        pointer: "/leads/1/email"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Could not find lead list.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '409':
          description: Conflict
          content:
            application/json:
              examples:
                Unsupported value (leads over limit per lead list):
                  value:
                    _errors:
                    - code: conflict
                      title: Conflict
                      detail: The maximum of 60,000 leads per list has been reached.
                      source:
                        pointer: "/leads"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '410':
          description: Gone
          content:
            application/json:
              examples:
                Gone:
                  value:
                    _errors:
                    - code: gone
                      title: Gone
                      detail: Lead list is no longer available.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - leads
              additionalProperties: false
              properties:
                type:
                  type: string
                  enum:
                  - linkedin
                  - email
                  - titles_and_company
                leads:
                  type: array
                  description: You can add up to 10,000 leads at a time. However,
                    each Lead List can have a maximum of 60,000 leads. When approaching
                    this limit, new leads will be added partially until the limit
                    is reached. When the limit is hit, a 409 HTTP status code will
                    be returned. Enriching, email validation, and reveal settings
                    are inherited from the Lead List settings. If credits are spent,
                    those will be deducted from the admin user of the account.
                  maxItems: 10000
                  items:
                    type: object
                    additionalProperties: true
                    properties:
                      linkedin_url:
                        type: string
                      email:
                        type: string
                        format: email
                      title:
                        type: string
                      company_name:
                        type: string
                      company_domain:
                        type: string
                      phone_numbers:
                        type: array
                        items:
                          type: string
                      context:
                        type: object
                        additionalProperties: true
                        description: Additional custom fields to store on the lead.
                          These fields are flattened into the lead data fields.
        required: true
        description: Leads to add to the list
      description: Add Leads to a List
  "/people/find":
    parameters:
    - name: email
      in: query
      schema:
        type: string
        format: email
      required: false
      description: Email to use for matching
    - name: linkedin_url
      in: query
      required: false
      description: LinkedIn URL to use for matching
      schema:
        type: string
    - name: name
      in: query
      required: false
      description: Person name to use for matching
      schema:
        type: string
    - name: title
      in: query
      required: false
      description: Person title to use for matching (optional when using name + company)
      schema:
        type: string
    - name: company_name
      in: query
      required: false
      description: Company name to use for matching
      schema:
        type: string
    - name: company_domain
      in: query
      required: false
      description: Company domain to use for matching
      schema:
        type: string
    - name: reveal_email
      in: query
      required: false
      description: Triggers email reveal for the matching person
      schema:
        type: boolean
    - name: reveal_phone_numbers
      in: query
      required: false
      description: Triggers phone number reveal for the matching person
      schema:
        type: boolean
    get:
      summary: Single person enrichment
      parameters: []
      tags:
      - People
      responses:
        '200':
          description: Ok
          content:
            application/json:
              examples:
                With linkedin_url:
                  value:
                    id: 01a01a7d-47a2-7ea2-97f4-7de094bad9e1
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4767-7ff4-a6a4-ac73bdcfd019
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4767-7ff4-a6a4-ac73bdcfd019
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                With email:
                  value:
                    id: 01a01a7d-49d2-76c7-a546-c9a641091c75
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-49af-7f5f-84b5-522168ec5e46
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-49af-7f5f-84b5-522168ec5e46
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                With name + title + company_name:
                  value:
                    id: 01a01a7d-4b7a-768b-9f11-4ac5e1367e51
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4b51-7628-965a-b1de3d0f143e
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4b51-7628-965a-b1de3d0f143e
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                With name + company_name (title optional):
                  value:
                    id: 01a01a7d-4c9d-7797-9a93-f1cbcb8ac61c
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4c76-73df-a994-10f7515de1aa
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4c76-73df-a994-10f7515de1aa
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                With name + title + company_domain:
                  value:
                    id: 01a01a7d-4dc8-7299-ac9b-94958d96b506
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4d8b-77ea-80d8-e4f431de2490
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4d8b-77ea-80d8-e4f431de2490
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                With name + company_domain (title optional):
                  value:
                    id: 01a01a7d-4ee5-75b9-ad8d-b8f07526b839
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4eb6-7792-b107-52a39e2b19e7
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4eb6-7792-b107-52a39e2b19e7
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                When revealing email and phone number:
                  value:
                    id: 01a01a7d-5009-73a6-9b06-7587e2941293
                    object: person
                    name: Jonh Doe
                    first_name: Jonh
                    last_name: Doe
                    linkedin_url: https://www.linkedin.com/in/person-1
                    title: Founder and CEO
                    headline: CEO @ Company
                    about:
                    current_position_start_date: '2022-05-01'
                    current_position_description:
                    image_url: https://example.com/resource
                    location: San Francisco, California, United States
                    location_details:
                      city: San Francisco
                      state: California
                      country: United States
                      lat: 37.7749
                      long: -122.4194
                    experiences:
                    - object: experience
                      title: CEO
                      company_name: A Company
                      company_linkedin_url: https://www.linkedin.com/company/company-1
                      description:
                      start_date: '2024-08-01'
                      end_date:
                    educations:
                    - object: education
                      degree: BSc
                      field_of_study: Computer Science
                      school_name: MIT
                      school_linkedin_url: https://www.linkedin.com/school/mit
                      start_date: '2020-08-01'
                      end_date: '2024-08-01'
                    languages:
                    - object: language
                      language: Portuguese
                      iso_code: por
                      proficiency: Native or bilingual proficiency
                    - object: language
                      language: English
                      iso_code: eng
                      proficiency: Professional working proficiency
                    - object: language
                      language: Spanish
                      iso_code: spa
                      proficiency:
                    linkedin_presence: none
                    company:
                      id: 01a01a7d-4fe3-7181-878e-d5a0e911a19f
                      object: company
                      name: A Company
                      website: https://company.com
                      linkedin_url: https://www.linkedin.com/company/company-1
                      keywords:
                      - sales
                      - ai sales
                      - sales engagement
                      estimated_number_of_employees: 500
                      size: 201-500 employees
                      industry: Software Development
                      logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-4fe3-7181-878e-d5a0e911a19f
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        postal_code: '94103'
                        lat: 37.7749
                        long: -122.4194
                      locations: []
                      overview: Circle Health is a group of hospitals in the UK
                      followers: 0
                      linkedin_presence: none
                      founded_year: 1995
                      traffic_rank: 50
                      sic_codes:
                      - 1
                      - 2
                      - 3
                      naics_codes:
                      - 5112
                      - 511
                      - 51
                      type: Privately Held
                      total_funding: 0
                      latest_funding_stage: series_b
                      latest_funding_date: '2019-11-02'
                      funding_events:
                      - date: '2019-11-02'
                        type: Series B
                        investors: []
                        amount: 40000000
                        currency:
                        amount_usd:
                      is_b2b: true
                      is_b2c: false
                      technologies: []
                      department_headcount:
                        consulting: 31420
                        design: 5312
                        education: 9063
                        engineering_technical: 167805
                        finance: 31894
                        human_resources: 33265
                        information_technology: 94657
                        legal: 41863
                        marketing: 38192
                        medical_health: 11440
                        operations: 198127
                        product: 11077
                        revenue: 75777
                        senior_leadership: 1933
                      job_function_headcount:
                        finance:
                          accounting: 12824
                          finance: 12197
                          financial_planning_analysis: 2468
                          financial_reporting: 250
                          financial_risk: 886
                          financial_strategy: 91
                          financial_systems: 11
                          internal_audit_control: 850
                          investor_relations: 129
                          mergers_acquisitions: 259
                          real_estate_finance: 117
                          shared_services: 56
                          sourcing_procurement: 3767
                          tax: 822
                          treasury: 179
                        legal:
                          acquisitions: 8
                          compliance: 4921
                          contracts: 206
                          corporate_secretary: 217
                          ediscovery: 57
                          ethics: 1070
                          governance: 66
                          governmental_affairs_regulatory_law: 518
                          intellectual_property_patent: 63
                          labor_employment: 96
                          lawyer_attorney: 2014
                          legal: 31969
                          legal_counsel: 879
                          legal_operations: 3777
                          litigation: 89
                          privacy: 198
                        revenue:
                          account_management: 16253
                          business_development: 10633
                          channel_sales: 618
                          customer_retention_development: 1746
                          customer_success: 15253
                          field_outside_sales: 5375
                          inside_sales: 3475
                          partnerships: 380
                          revenue_operations: 26
                          sales: 43809
                          sales_enablement: 26
                          sales_engineering: 135
                          sales_operations: 254
                          sales_training: 465
                        engineering_technical:
                          artificial_intelligence_machine_learning: 4466
                          bioengineering_biometrics: 2
                          business_intelligence: 6811
                          chemical_engineering: 3014
                          cloud_mobility: 1144
                          data_science: 9589
                          devops: 502
                          digital_transformation: 13
                          emerging_technology_innovation: 576
                          engineering_technical: 37540
                          industrial_engineering: 1242
                          mechanic: 1037
                          mobile_development: 3282
                          project_management: 4923
                          research_development: 10123
                          scrum_master_agile_coach: 173
                          software_development: 57246
                          support_technical_services: 8328
                          technician: 7999
                          technology_operations: 64
                          test_quality_assurance: 6722
                          ui_ux: 458
                          web_development: 2551
                        operations:
                          call_center: 2095
                          construction: 2338
                          corporate_strategy: 1194
                          customer_service_support: 21434
                          enterprise_resource_planning: 389
                          facilities_management: 18036
                          leasing: 33
                          logistics: 75145
                          office_operations: 32304
                          operations: 27241
                          physical_security: 3280
                          project_development: 695
                          quality_management: 1801
                          real_estate: 961
                          safety: 2794
                          store_operations: 26641
                          supply_chain: 2728
                        senior_leadership:
                          executive: 348
                          finance_executive: 71
                          founder: 1128
                          human_resources_executive: 3
                          information_technology_executive: 35
                          legal_executive: 2
                          marketing_executive: 314
                          medical_health_executive: 3
                          operations_executive: 32
                          sales_executive: 2
                        medical_health:
                          anesthesiology: 33
                          chiropractics: 64
                          clinical_systems: 91
                          dentistry: 480
                          dermatology: 6
                          doctors_physicians: 1214
                          epidemiology: 1
                          first_responder: 504
                          medical_administration: 767
                          medical_education_training: 19
                          medical_research: 92
                          medicine: 1202
                          neurology: 1
                          nursing: 2053
                          nutrition_dietetics: 94
                          obstetrics_gynecology: 50
                          oncology: 3
                          ophthalmology: 11
                          optometry: 46
                          orthopedics: 14
                          pathology: 15
                          pediatrics: 20
                          pharmacy: 873
                          physical_therapy: 342
                          psychiatry: 383
                          psychology: 663
                          public_health: 803
                          radiology: 215
                          social_work: 2495
                        information_technology:
                          application_development: 37630
                          business_service_management_itsm: 1710
                          collaboration_web_app: 281
                          data_center: 597
                          data_warehouse: 2090
                          database_administration: 309
                          ecommerce_development: 285
                          enterprise_architecture: 784
                          help_desk_desktop_services: 4164
                          hr_financial_erp_systems: 807
                          information_security: 1742
                          information_technology: 9139
                          infrastructure: 2254
                          it_asset_management: 100
                          it_audit_it_compliance: 50
                          it_operations: 6941
                          it_procurement: 866
                          it_strategy: 439
                          it_training: 51
                          networking: 1528
                          project_program_management: 15780
                          quality_assurance: 8126
                          retail_store_systems: 1042
                          servers: 984
                          storage_disaster_recovery: 111
                          telecommunications: 186
                          virtualization: 915
                        education:
                          principal: 458
                          professor: 694
                          superintendent: 28
                          teacher: 7885
                        marketing:
                          advertising: 3032
                          brand_management: 2504
                          content_marketing: 2641
                          customer_experience: 812
                          customer_marketing: 8
                          demand_generation: 507
                          digital_marketing: 1640
                          ecommerce_marketing: 1121
                          event_marketing: 125
                          field_marketing: 740
                          lead_generation: 2937
                          marketing: 18980
                          marketing_analytics_insights: 716
                          marketing_communications: 496
                          marketing_operations: 71
                          product_marketing: 1319
                          public_relations: 972
                          search_engine_optimization_pay_per_click: 974
                          social_media_marketing: 1411
                          strategic_communications: 709
                          technical_marketing: 5
                        consulting:
                          consultant: 31420
                        human_resources:
                          compensation_benefits: 908
                          culture_diversity_inclusion: 182
                          employee_labor_relations: 1147
                          health_safety: 1087
                          hr_business_partner: 3332
                          human_resource_information_system: 1321
                          human_resources: 13884
                          learning_development: 7386
                          organizational_development: 154
                          people_operations: 10
                          recruiting_talent_acquisition: 5764
                          talent_management: 911
                          workforce_management: 571
                        design:
                          graphic_visual_brand_design: 3707
                          product_or_ui_ux_design: 2364
                        product:
                          product_development: 266
                          product_management: 10811
                      estimated_revenue: "$1M-$10M"
                    gender: male
                    email: person-1@company.com
              schema:
                "$ref": "#/components/schemas/response_person_object"
        '429':
          description: Too many requests
          content:
            application/json:
              examples:
                When revealing email or phone number and facing a rate limit:
                  value:
                    _errors:
                    - code: rate_limited
                      title: Rate Limited
                      detail: Your reveals are currently rate limited, try again later.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '408':
          description: Request timeout
          content:
            application/json:
              examples:
                When revealing email or phone number and reaching a time out:
                  value:
                    _errors:
                    - code: request_timeout
                      title: Request Timeout
                      detail: We are processing your request, try again later.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: person_not_found
                      title: Person Not Found
                      detail: A matching person was not found in our database
                      source:
                        pointer: "/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing fields (1):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (2):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (3):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (4):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (5):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (6):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Missing fields (7):
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either email, or linkedin_url, or name
                        + company_name/company_domain (title is optional)
                    object: error
                Type error:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'Unsupported value provided for field: linkedin_url.'
                      source:
                        pointer: "/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '402':
          description: Insufficient credits
          content:
            application/json:
              examples:
                Insufficient credits:
                  value:
                    _errors:
                    - code: insufficient_credits
                      title: Insufficient Credits
                      detail: You do not have enough credits to perform this operation.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '451':
          description: Unavailable for Legal Reasons
          content:
            application/json:
              examples:
                Unavailable for Legal Reasons:
                  value:
                    _errors:
                    - code: unavailable_for_legal_reasons
                      title: Unavailable For Legal Reasons
                      detail: A matching person was found in our database, but has
                        been removed due to privacy reasons
                      source:
                        pointer: "/linkedin_url"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Single person enrichment
  "/people/search":
    post:
      summary: Search people
      parameters: []
      tags:
      - People
      responses:
        '200':
          description: Ok
          content:
            application/json:
              examples:
                Ok:
                  value:
                    object: person_search_result
                    results:
                    - id: 01a01a7d-6090-7e0b-8829-734876679ec3
                      object: person
                      name: Jonh Doe
                      first_name: Jonh
                      last_name: Doe
                      linkedin_url: https://www.linkedin.com/in/person-1
                      title: Founder and CEO
                      headline: CEO @ Company
                      about:
                      current_position_start_date: '2022-05-01'
                      current_position_description:
                      image_url: https://example.com/resource
                      location: San Francisco, California, United States
                      location_details:
                        city: San Francisco
                        state: California
                        country: United States
                        lat: 37.7749
                        long: -122.4194
                      experiences:
                      - object: experience
                        title: CEO
                        company_name: A Company
                        company_linkedin_url: https://www.linkedin.com/company/company-1
                        description:
                        start_date: '2024-08-01'
                        end_date:
                      educations:
                      - object: education
                        degree: BSc
                        field_of_study: Computer Science
                        school_name: MIT
                        school_linkedin_url: https://www.linkedin.com/school/mit
                        start_date: '2020-08-01'
                        end_date: '2024-08-01'
                      languages:
                      - object: language
                        language: Portuguese
                        iso_code: por
                        proficiency: Native or bilingual proficiency
                      - object: language
                        language: English
                        iso_code: eng
                        proficiency: Professional working proficiency
                      - object: language
                        language: Spanish
                        iso_code: spa
                        proficiency:
                      linkedin_presence: none
                      company:
                        id: 01a01a7d-606b-7d1c-8a2f-12afc35df9fd
                        object: company
                        name: A Company
                        website: https://company.com
                        linkedin_url: https://www.linkedin.com/company/company-1
                        keywords:
                        - sales
                        - ai sales
                        - sales engagement
                        estimated_number_of_employees: 500
                        size: 201-500 employees
                        industry: Software Development
                        logo_url: https://assets.amplemarket.com/avatars/company/01a01a7d-606b-7d1c-8a2f-12afc35df9fd
                        location: San Francisco, California, United States
                        location_details:
                          city: San Francisco
                          state: California
                          country: United States
                          postal_code: '94103'
                          lat: 37.7749
                          long: -122.4194
                        locations: []
                        overview: Circle Health is a group of hospitals in the UK
                        followers: 0
                        linkedin_presence: none
                        founded_year: 1995
                        traffic_rank: 50
                        sic_codes:
                        - 1
                        - 2
                        - 3
                        naics_codes:
                        - 5112
                        - 511
                        - 51
                        type: Privately Held
                        total_funding: 0
                        latest_funding_stage: series_b
                        latest_funding_date: '2019-11-02'
                        funding_events:
                        - date: '2019-11-02'
                          type: Series B
                          investors: []
                          amount: 40000000
                          currency:
                          amount_usd:
                        is_b2b: true
                        is_b2c: false
                        technologies: []
                        department_headcount:
                          consulting: 31420
                          design: 5312
                          education: 9063
                          engineering_technical: 167805
                          finance: 31894
                          human_resources: 33265
                          information_technology: 94657
                          legal: 41863
                          marketing: 38192
                          medical_health: 11440
                          operations: 198127
                          product: 11077
                          revenue: 75777
                          senior_leadership: 1933
                        job_function_headcount:
                          finance:
                            accounting: 12824
                            finance: 12197
                            financial_planning_analysis: 2468
                            financial_reporting: 250
                            financial_risk: 886
                            financial_strategy: 91
                            financial_systems: 11
                            internal_audit_control: 850
                            investor_relations: 129
                            mergers_acquisitions: 259
                            real_estate_finance: 117
                            shared_services: 56
                            sourcing_procurement: 3767
                            tax: 822
                            treasury: 179
                          legal:
                            acquisitions: 8
                            compliance: 4921
                            contracts: 206
                            corporate_secretary: 217
                            ediscovery: 57
                            ethics: 1070
                            governance: 66
                            governmental_affairs_regulatory_law: 518
                            intellectual_property_patent: 63
                            labor_employment: 96
                            lawyer_attorney: 2014
                            legal: 31969
                            legal_counsel: 879
                            legal_operations: 3777
                            litigation: 89
                            privacy: 198
                          revenue:
                            account_management: 16253
                            business_development: 10633
                            channel_sales: 618
                            customer_retention_development: 1746
                            customer_success: 15253
                            field_outside_sales: 5375
                            inside_sales: 3475
                            partnerships: 380
                            revenue_operations: 26
                            sales: 43809
                            sales_enablement: 26
                            sales_engineering: 135
                            sales_operations: 254
                            sales_training: 465
                          engineering_technical:
                            artificial_intelligence_machine_learning: 4466
                            bioengineering_biometrics: 2
                            business_intelligence: 6811
                            chemical_engineering: 3014
                            cloud_mobility: 1144
                            data_science: 9589
                            devops: 502
                            digital_transformation: 13
                            emerging_technology_innovation: 576
                            engineering_technical: 37540
                            industrial_engineering: 1242
                            mechanic: 1037
                            mobile_development: 3282
                            project_management: 4923
                            research_development: 10123
                            scrum_master_agile_coach: 173
                            software_development: 57246
                            support_technical_services: 8328
                            technician: 7999
                            technology_operations: 64
                            test_quality_assurance: 6722
                            ui_ux: 458
                            web_development: 2551
                          operations:
                            call_center: 2095
                            construction: 2338
                            corporate_strategy: 1194
                            customer_service_support: 21434
                            enterprise_resource_planning: 389
                            facilities_management: 18036
                            leasing: 33
                            logistics: 75145
                            office_operations: 32304
                            operations: 27241
                            physical_security: 3280
                            project_development: 695
                            quality_management: 1801
                            real_estate: 961
                            safety: 2794
                            store_operations: 26641
                            supply_chain: 2728
                          senior_leadership:
                            executive: 348
                            finance_executive: 71
                            founder: 1128
                            human_resources_executive: 3
                            information_technology_executive: 35
                            legal_executive: 2
                            marketing_executive: 314
                            medical_health_executive: 3
                            operations_executive: 32
                            sales_executive: 2
                          medical_health:
                            anesthesiology: 33
                            chiropractics: 64
                            clinical_systems: 91
                            dentistry: 480
                            dermatology: 6
                            doctors_physicians: 1214
                            epidemiology: 1
                            first_responder: 504
                            medical_administration: 767
                            medical_education_training: 19
                            medical_research: 92
                            medicine: 1202
                            neurology: 1
                            nursing: 2053
                            nutrition_dietetics: 94
                            obstetrics_gynecology: 50
                            oncology: 3
                            ophthalmology: 11
                            optometry: 46
                            orthopedics: 14
                            pathology: 15
                            pediatrics: 20
                            pharmacy: 873
                            physical_therapy: 342
                            psychiatry: 383
                            psychology: 663
                            public_health: 803
                            radiology: 215
                            social_work: 2495
                          information_technology:
                            application_development: 37630
                            business_service_management_itsm: 1710
                            collaboration_web_app: 281
                            data_center: 597
                            data_warehouse: 2090
                            database_administration: 309
                            ecommerce_development: 285
                            enterprise_architecture: 784
                            help_desk_desktop_services: 4164
                            hr_financial_erp_systems: 807
                            information_security: 1742
                            information_technology: 9139
                            infrastructure: 2254
                            it_asset_management: 100
                            it_audit_it_compliance: 50
                            it_operations: 6941
                            it_procurement: 866
                            it_strategy: 439
                            it_training: 51
                            networking: 1528
                            project_program_management: 15780
                            quality_assurance: 8126
                            retail_store_systems: 1042
                            servers: 984
                            storage_disaster_recovery: 111
                            telecommunications: 186
                            virtualization: 915
                          education:
                            principal: 458
                            professor: 694
                            superintendent: 28
                            teacher: 7885
                          marketing:
                            advertising: 3032
                            brand_management: 2504
                            content_marketing: 2641
                            customer_experience: 812
                            customer_marketing: 8
                            demand_generation: 507
                            digital_marketing: 1640
                            ecommerce_marketing: 1121
                            event_marketing: 125
                            field_marketing: 740
                            lead_generation: 2937
                            marketing: 18980
                            marketing_analytics_insights: 716
                            marketing_communications: 496
                            marketing_operations: 71
                            product_marketing: 1319
                            public_relations: 972
                            search_engine_optimization_pay_per_click: 974
                            social_media_marketing: 1411
                            strategic_communications: 709
                            technical_marketing: 5
                          consulting:
                            consultant: 31420
                          human_resources:
                            compensation_benefits: 908
                            culture_diversity_inclusion: 182
                            employee_labor_relations: 1147
                            health_safety: 1087
                            hr_business_partner: 3332
                            human_resource_information_system: 1321
                            human_resources: 13884
                            learning_development: 7386
                            organizational_development: 154
                            people_operations: 10
                            recruiting_talent_acquisition: 5764
                            talent_management: 911
                            workforce_management: 571
                          design:
                            graphic_visual_brand_design: 3707
                            product_or_ui_ux_design: 2364
                          product:
                            product_development: 266
                            product_management: 10811
                        estimated_revenue: "$1M-$10M"
                      gender: male
                    _pagination:
                      page: 1
                      page_size: 30
                      total_pages: 1
                      total: 1
              schema:
                "$ref": "#/components/schemas/response_person_search_result_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Bad industry:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Industry A' is not a supported industry."
                      source:
                        pointer: "/company_industries"
                    object: error
                Too many options in filter:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Industry 0' is not a supported industry."
                      source:
                        pointer: "/company_industries"
                    object: error
                Bad company type:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Some company type' is not a supported company type."
                      source:
                        pointer: "/company_types"
                    object: error
                Bad company focus:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'business2business' is not a supported company focus
                        value."
                      source:
                        pointer: "/company_focuses"
                    object: error
                Bad company size:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'1000000000+' is not a supported company size."
                      source:
                        pointer: "/company_sizes"
                    object: error
                Bad seniority:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Some seniority' is not a supported seniority."
                      source:
                        pointer: "/person_seniorities"
                    object: error
                Bad department:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Some department' is not a supported department."
                      source:
                        pointer: "/person_departments"
                    object: error
                Bad job function:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'Some function' is not a supported job function."
                      source:
                        pointer: "/person_job_functions"
                    object: error
                User missing:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'The following users don''t exist: missing@domain.com.'
                      source:
                        pointer: "/linkedin_networks"
                    object: error
                User missing linkedin account:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: 'The following users don''t exist: ChristineJEzell@example.com.'
                      source:
                        pointer: "/exclude_linkedin_networks"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                    - code: internal_server_error
                      title: Internal Server Error
                      detail: Something went wrong.
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                person_name:
                  type: string
                person_titles:
                  type: array
                  items:
                    type: string
                person_keywords:
                  type: array
                  description: Keywords to search in the person's profile summary
                    (headline, about, etc.). Matches any keyword by default.
                  items:
                    type: string
                person_exclude_keywords:
                  type: array
                  description: Keywords to exclude from the person's profile summary.
                  items:
                    type: string
                company_keywords:
                  type: array
                  description: Keywords to search in the person's company description.
                    Matches any keyword by default.
                  items:
                    type: string
                company_exclude_keywords:
                  type: array
                  description: Keywords to exclude from the person's company description.
                  items:
                    type: string
                person_title_exact_match:
                  type: boolean
                person_seniorities:
                  type: array
                  items:
                    type: string
                    enum:
                    - Owner
                    - Founder
                    - C-Suite
                    - Partner
                    - VP
                    - Head
                    - Director
                    - Manager
                    - Senior
                    - Entry
                    - Intern
                    - Other
                    - Non-Manager
                    - Founder / Owner
                person_departments:
                  type: array
                  description: 'Available options: [Supported departments](/api-reference/supported-departments)'
                  items:
                    type: string
                person_job_functions:
                  type: array
                  description: 'Available options: [Supported job functions](/api-reference/supported-job-functions)'
                  items:
                    type: string
                person_locations:
                  type: array
                  items:
                    type: string
                person_exclude_locations:
                  type: array
                  items:
                    type: string
                company_locations:
                  type: array
                  items:
                    type: string
                company_exclude_locations:
                  type: array
                  items:
                    type: string
                company_names:
                  type: array
                  items:
                    type: string
                company_exclude_names:
                  type: array
                  items:
                    type: string
                company_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                company_exclude_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                education_company_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                education_company_names:
                  type: array
                  items:
                    type: string
                company_domains:
                  type: array
                  items:
                    type: string
                    format: domain
                company_exclude_domains:
                  type: array
                  items:
                    type: string
                    format: domain
                company_linkedin_urls:
                  type: array
                  items:
                    type: string
                company_exclude_linkedin_urls:
                  type: array
                  items:
                    type: string
                company_domains_match_subsidiaries_and_affiliates:
                  type: boolean
                company_focuses:
                  type: array
                  items:
                    type: string
                    enum:
                    - b2b
                    - b2c
                company_types:
                  type: array
                  items:
                    type: string
                    enum:
                    - Public Company
                    - Educational
                    - Self Employed
                    - Government Agency
                    - Non Profit
                    - Self Owned
                    - Privately Held
                    - Partnership
                company_sizes:
                  type: array
                  items:
                    type: string
                    enum:
                    - 1-10 employees
                    - 11-50 employees
                    - 51-200 employees
                    - 201-500 employees
                    - 501-1000 employees
                    - 1001-5000 employees
                    - 5001-10000 employees
                    - 10001+ employees
                company_industries:
                  type: array
                  description: 'Available options: [Supported industries](/api-reference/supported-industries)'
                  items:
                    type: string
                company_exclude_industries:
                  type: array
                  description: 'Available options: [Supported industries](/api-reference/supported-industries)'
                  items:
                    type: string
                linkedin_networks:
                  type: array
                  description: Array of user email addresses. The LinkedIn networks
                    of these users will be used for filtering results. Use the special
                    string `all_networks` to include all LinkedIn networks associated
                    with the account's users.
                  items:
                    type: string
                exclude_linkedin_networks:
                  type: array
                  description: Array of user email addresses. The LinkedIn networks
                    of these users will be excluded from the results. Use the special
                    string `all_networks` to exclude all LinkedIn networks associated
                    with the account's users.
                  items:
                    type: string
                company_investors:
                  type: array
                  description: Array of investor names. Filter for companies that
                    have received investment by any of the specified investors.
                  items:
                    type: string
                company_shares_investors_with:
                  type: array
                  description: Array of company names. Filter for companies that share
                    one or more common investors with the specified companies.
                  items:
                    type: string
                company_revenue:
                  type: array
                  description: Filter by the person's company estimated revenue range.
                  items:
                    type: string
                    enum:
                    - "$0-$1M"
                    - "$1M-$10M"
                    - "$10M-$100M"
                    - "$100M-$1B"
                    - "$1B+"
                company_founded_date:
                  type: object
                  description: Filter by the person's company founding year range.
                  properties:
                    min:
                      type: integer
                      description: Minimum founding year
                    max:
                      type: integer
                      description: Maximum founding year
                company_web_traffic_rank:
                  type: object
                  description: Filter by the person's company web traffic rank.
                  properties:
                    min:
                      type: integer
                      description: Minimum traffic rank
                    max:
                      type: integer
                      description: Maximum traffic rank
                job_openings:
                  type: object
                  description: Filter by the person's company having matching open
                    positions.
                  properties:
                    titles:
                      type: array
                      description: Free-text job titles to filter by.
                      items:
                        type: string
                news:
                  type: object
                  description: Filter by the person's company having recent news.
                  properties:
                    categories:
                      type: array
                      description: News category slugs.
                      items:
                        type: string
                    range_months:
                      type: integer
                      description: Number of months to look back for news.
                headcount_growth:
                  type: object
                  description: Filter by the person's company total headcount growth
                    percentage.
                  properties:
                    growth_rates:
                      type: array
                      items:
                        type: object
                        properties:
                          min:
                            type: integer
                          max:
                            type: integer
                    time_frame_in_months:
                      type: integer
                      enum:
                      - 3
                      - 6
                      - 12
                crm_account_owner:
                  type: array
                  description: Filter by the person's company CRM account owner emails.
                    Requires a connected CRM integration (Salesforce or HubSpot).
                    Returns an error if no owners match the provided emails.
                  items:
                    type: string
                    format: email
                company_last_funding:
                  type: object
                  description: Filter by the person's company last funding round.
                  properties:
                    round_type:
                      type: array
                      items:
                        type: string
                        enum:
                        - pre_seed
                        - seed
                        - angel
                        - venture_round_unknown_series
                        - series_a
                        - series_b
                        - series_c
                        - series_d
                        - series_e
                        - series_f
                        - series_g
                        - series_h
                        - series_i
                        - series_j
                        - debt
                        - equity_crowdfunding
                        - convertible_note
                        - ico
                        - private_equity
                        - other
                    range_months:
                      type: integer
                      description: Number of months to look back for last funding.
                person_linkedin_presence:
                  type: array
                  description: 'Filter by the person''s LinkedIn follower tier. Supported
                    values: `influencer` — Influencer (10,000+ followers), `micro_influencer`
                    — Micro Influencer (5,000 - 9,999 followers), `large` — Large
                    following (500 - 4,999 followers), `moderate` — Moderate following
                    (100 - 499 followers), `limited` — Limited following (1 - 99 followers),
                    `none` — No following (0 followers). All ranges are inclusive.'
                  items:
                    type: string
                    enum:
                    - influencer
                    - large
                    - limited
                    - micro_influencer
                    - moderate
                    - none
                company_linkedin_presence:
                  type: array
                  description: 'Filter by the person''s company LinkedIn follower
                    tier. Supported values: `massive` — Massive following (100,000+
                    followers), `large` — Large following (10,000 - 99,999 followers),
                    `moderate` — Moderate following (1,000 - 9,999 followers), `limited`
                    — Limited following (1 - 999 followers), `none` — No following
                    (0 followers). All ranges are inclusive.'
                  items:
                    type: string
                    enum:
                    - large
                    - limited
                    - massive
                    - moderate
                    - none
                page:
                  type: integer
                  default: 1
                page_size:
                  type: integer
                  default: 5
                  minimum: 1
                  description: Number of results per page. Values greater than 100
                    are accepted and capped at 100.
        required: true
        description: Parameters to use for searching people.
      description: Search people
  "/phone_numbers/{id}/review":
    parameters:
    - name: id
      in: path
      required: true
      description: Phone Number id
      schema:
        type: string
    post:
      summary: Review phone number
      parameters: []
      tags:
      - Phone Numbers
      responses:
        '200':
          description: Phone number reviewed
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                user_id:
                  type: string
                  format: uuid
                reason:
                  type: string
                  enum:
                  - wrong_number
              required:
              - user_id
              - reason
      description: Review phone number
  "/accounts":
    get:
      summary: List Accounts
      parameters:
      - name: name
        in: query
        required: false
        description: Filter accounts by name (case-insensitive partial match)
        schema:
          type: string
      - name: domain
        in: query
        required: false
        description: Filter accounts by domain (exact match)
        schema:
          type: string
      - name: owner_email
        in: query
        required: false
        description: Filter accounts by owner email (exact match)
        schema:
          type: string
      - name: tags[]
        in: query
        schema:
          type: array
          items:
            type: string
        required: false
        description: Filter accounts by tag names
      - name: page[after]
        in: query
        required: false
        description: Cursor for next page (from _links.next)
        schema:
          type: string
      - name: page[size]
        in: query
        required: false
        description: 'Page size (default: 10, max: 50)'
        schema:
          type: integer
      tags:
      - Account
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    accounts:
                    - id: pub_123
                      name: Acme Corp
                      website: acme.com
                      linkedin_url: https://linkedin.com/company/acme
                      owner_email: owner@example.com
                      last_contacted_at:
                      last_engaged_at:
                    _links:
                      self:
                        href: "/accounts?page[size]=10"
              schema:
                type: object
                properties:
                  accounts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                          nullable: true
                        website:
                          type: string
                          nullable: true
                        linkedin_url:
                          type: string
                          nullable: true
                        owner_email:
                          type: string
                          nullable: true
                        last_contacted_at:
                          type: string
                          format: date-time
                          nullable: true
                        last_engaged_at:
                          type: string
                          format: date-time
                          nullable: true
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Invalid cursor:
                  value:
                    _errors:
                    - code: invalid_parameter
                      title: Invalid Parameter
                      detail: Invalid cursor
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: List Accounts
  "/accounts/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Account public ID
      schema:
        type: string
    get:
      summary: Retrieve Account
      parameters: []
      tags:
      - Account
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: pub_123
                    name: Acme Corp
                    domain: acme.com
                    linkedin_url:
                    description:
                    industry: Technology
                    size: 51-200
                    founded_year:
                    image_url:
                    location:
                      city: San Francisco
                      state:
                      country: US
                    owner:
                    tags: []
                    insights:
                    insights_generated_at:
                    insights_status: unavailable
                    engagement:
                      contacts_count: 0
                      active_contacts_count: 0
                      interested_contacts_count: 0
                      first_contacted_at:
                      last_contacted_at:
                      last_engaged_at:
                      emails_sent: 0
                      emails_received: 0
                      linkedin_sent: 0
                      linkedin_received: 0
                      calls_made: 0
                      calls_received: 0
                      meetings: 0
                    crm:
                    opportunities:
                    custom_fields: {}
              schema:
                type: object
                properties:
                  id:
                    type: string
                  name:
                    type: string
                    nullable: true
                  domain:
                    type: string
                    nullable: true
                  linkedin_url:
                    type: string
                    nullable: true
                  description:
                    type: string
                    nullable: true
                  industry:
                    type: string
                    nullable: true
                  size:
                    type: string
                    nullable: true
                  founded_year:
                    type: integer
                    nullable: true
                  image_url:
                    type: string
                    nullable: true
                  location:
                    type: object
                    nullable: true
                    properties:
                      city:
                        type: string
                        nullable: true
                      state:
                        type: string
                        nullable: true
                      country:
                        type: string
                        nullable: true
                  owner:
                    type: object
                    nullable: true
                    properties:
                      name:
                        type: string
                      email:
                        type: string
                  tags:
                    type: array
                    items:
                      type: string
                  insights:
                    type: string
                    nullable: true
                  insights_generated_at:
                    type: string
                    format: date-time
                    nullable: true
                  insights_status:
                    type: string
                  engagement:
                    type: object
                    nullable: true
                    properties:
                      contacts_count:
                        type: integer
                      active_contacts_count:
                        type: integer
                      interested_contacts_count:
                        type: integer
                      first_contacted_at:
                        type: string
                        format: date-time
                        nullable: true
                      last_contacted_at:
                        type: string
                        format: date-time
                        nullable: true
                      last_engaged_at:
                        type: string
                        format: date-time
                        nullable: true
                      emails_sent:
                        type: integer
                      emails_received:
                        type: integer
                      linkedin_sent:
                        type: integer
                      linkedin_received:
                        type: integer
                      calls_made:
                        type: integer
                      calls_received:
                        type: integer
                      meetings:
                        type: integer
                  crm:
                    type: object
                    nullable: true
                    properties:
                      provider:
                        type: string
                      account_name:
                        type: string
                        nullable: true
                      account_url:
                        type: string
                        nullable: true
                      owner:
                        type: object
                        nullable: true
                        properties:
                          name:
                            type: string
                          email:
                            type: string
                  opportunities:
                    type: object
                    nullable: true
                    properties:
                      open_count:
                        type: integer
                      closed_count:
                        type: integer
                      total_open_amount:
                        type: number
                      total_closed_amount:
                        type: number
                  custom_fields:
                    type: object
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                    - code: not_found
                      title: Not Found
                      detail: Account not found
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve Account
  "/contacts":
    get:
      summary: Retrieve contacts
      parameters:
      - name: name
        in: query
        schema:
          type: string
        required: false
        description: Optional contact name filter. Use with or without account_id
          as an alternative to ids[]
      - name: account_id
        in: query
        schema:
          type: string
          format: uuid
        required: false
        description: Optional Prospect Hub account public ID filter. Use with or without
          name as an alternative to ids[]
      - name: ids[]
        in: query
        schema:
          type: array
          items:
            type: string
          maxItems: 20
        required: false
        description: Optional contact ID filter (maximum of 20 ids). Use ids[] or
          name/account_id filters
      tags:
      - Contacts
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    contacts:
                    - id: 01a01a7d-73a8-7f62-8cb3-aa7b5d927d9a
                      name: John Doe
                      first_name: John
                      last_name: Doe
                      linkedin_url: https://linkedin.com/in/john-doe
                      email: john.doe@example.com
                      time_zone: Europe/Lisbon
                      location: Lisbon, Lisbon, Portugal
                      title: Software Engineer
                      company_domain: amplemarket.com
                      company_name: Amplemarket
                      owner: user@example.com
                      created_at: '2026-08-19T14:47:04Z'
                      last_contacted_at: '2026-08-17T14:47:04Z'
                      phone_numbers:
                      - id: 01a01a7d-7166-7c6e-9768-9dd40c5a585c
                        object: phone_number
                        number: "+1 639-300-0002"
                        type: mobile
                        source: amplemarket
                        is_wrong_number: false
                        kind: mobile
              schema:
                type: object
                properties:
                  contacts:
                    type: array
                    items:
                      "$ref": "#/components/schemas/response_contact_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing filters:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: Must provide either name, account_id, or ids parameter
                      source:
                        pointer: "/name"
                    object: error
                Invalid ids size:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: Number of contact IDs exceeds limit of 20
                      source:
                        pointer: "/ids"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: Retrieve contacts
    post:
      summary: Create contact
      parameters: []
      tags:
      - Contacts
      responses:
        '201':
          description: Created
          content:
            application/json:
              examples:
                Created:
                  value:
                    id: 01a01a7d-764c-7504-89b7-186ab393cca2
                    name: Jane Doe
                    first_name: Jane
                    last_name: Doe
                    linkedin_url:
                    email: new-contact@example.com
                    time_zone:
                    location:
                    title: CEO
                    company_domain: amplemarket.com
                    company_name: Amplemarket
                    owner:
                    created_at: '2026-08-19T14:47:03Z'
                    last_contacted_at:
                    phone_numbers: []
                    recent_activity: []
              schema:
                "$ref": "#/components/schemas/response_contact_with_activity_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing email:
                  value:
                    object: error
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: email'
                      source:
                        pointer: "/email"
                Invalid phone number:
                  value:
                    object: error
                    _errors:
                    - code: invalid_parameter
                      title: Invalid Parameter
                      detail: 'Invalid phone number: phone_numbers[0].number is not
                        a recognizable phone number'
                      source:
                        pointer: "/phone_numbers/0/number"
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '409':
          description: Conflict
          content:
            application/json:
              examples:
                Duplicate contact:
                  value:
                    object: error
                    _errors:
                    - code: conflict
                      title: Conflict
                      detail: A contact with this email already exists in this account.
                      source:
                        pointer: "/email"
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '422':
          description: Unprocessable content
          content:
            application/json:
              examples:
                CRM push failed:
                  value:
                    object: error
                    _errors:
                    - code: crm_push_failed
                      title: Crm Push Failed
                      detail: 'CRM returned error: bad crm config'
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  description: Contact email
                first_name:
                  type: string
                  description: Contact first name
                last_name:
                  type: string
                  description: Contact last name
                title:
                  type: string
                  description: Contact job title
                city:
                  type: string
                  description: Contact city
                state:
                  type: string
                  description: Contact state or region
                country:
                  type: string
                  description: Contact country
                industry:
                  type: string
                  description: Contact industry
                linkedin_url:
                  type: string
                  format: uri
                  description: Contact LinkedIn profile URL
                owner_email:
                  type: string
                  description: Email of the Amplemarket user that should own the contact
                account_id:
                  type: string
                  format: uuid
                  description: Prospect Hub account public ID to associate to the
                    contact
                crm_account_id:
                  type: string
                  description: CRM account identifier used to resolve the Prospect
                    Hub account association
                company_domain:
                  type: string
                  description: Company domain used to resolve the Prospect Hub account
                    association
                company_name:
                  type: string
                  description: Company name used as a fallback to resolve the Prospect
                    Hub account association
                phone_numbers:
                  type: array
                  description: Phone numbers to attach to the contact as user-uploaded
                    numbers
                  items:
                    type: object
                    properties:
                      number:
                        type: string
                        description: Phone number in raw or international format
                      kind:
                        type: string
                        enum:
                        - mobile
                        - office
                        - phone
                        - landline
                        - voip
                        - direct
                        - fax
                        description: Phone number kind
                      type:
                        type: string
                        enum:
                        - mobile
                        - office
                        - phone
                        - landline
                        - voip
                        - direct
                        - fax
                        description: Alias for kind
              required:
              - email
      description: Create contact
  "/contacts/{id}":
    parameters:
    - name: id
      in: path
      required: true
      description: Contact id
      schema:
        type: string
    get:
      summary: Retrieve contact
      parameters: []
      tags:
      - Contacts
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 01a01a7d-73a8-7f62-8cb3-aa7b5d927d9a
                    name: John Doe
                    first_name: John
                    last_name: Doe
                    linkedin_url: https://linkedin.com/in/john-doe
                    email: john.doe@example.com
                    time_zone: Europe/Lisbon
                    location: Lisbon, Lisbon, Portugal
                    title: Software Engineer
                    company_domain: amplemarket.com
                    company_name: Amplemarket
                    owner: user@example.com
                    created_at: '2026-08-19T14:47:04Z'
                    last_contacted_at: '2026-08-17T14:47:04Z'
                    phone_numbers:
                    - id: 01a01a7d-7166-7c6e-9768-9dd40c5a585c
                      object: phone_number
                      number: "+1 639-300-0002"
                      type: mobile
                      source: amplemarket
                      is_wrong_number: false
                      kind: mobile
                    recent_activity:
                    - event_at: '2026-08-19T14:47:03Z'
                      event_type: completed_without_reply
                      sequence_id: b026f38bb2881327da047d9126adcc9a3312ff12
                      sequence_type: sequence
                      sequence_name: A sequence
                    - event_at: '2026-08-18T13:35:03Z'
                      event_type: added_to_sequence
                      sequence_id: b026f38bb2881327da047d9126adcc9a3312ff12
                      sequence_type: sequence
                      sequence_name: A sequence
              schema:
                "$ref": "#/components/schemas/response_contact_with_activity_object"
      description: Retrieve contact
  "/contacts/email/{email}":
    parameters:
    - name: email
      in: path
      required: true
      description: Contact email
      schema:
        type: string
    get:
      summary: Retrieve contact by email
      parameters: []
      tags:
      - Contacts
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    id: 01a01a7d-73a8-7f62-8cb3-aa7b5d927d9a
                    name: John Doe
                    first_name: John
                    last_name: Doe
                    linkedin_url: https://linkedin.com/in/john-doe
                    email: john.doe@example.com
                    time_zone: Europe/Lisbon
                    location: Lisbon, Lisbon, Portugal
                    title: Software Engineer
                    company_domain: amplemarket.com
                    company_name: Amplemarket
                    owner: user@example.com
                    created_at: '2026-08-19T14:47:04Z'
                    last_contacted_at: '2026-08-17T14:47:04Z'
                    phone_numbers:
                    - id: 01a01a7d-7166-7c6e-9768-9dd40c5a585c
                      object: phone_number
                      number: "+1 639-300-0002"
                      type: mobile
                      source: amplemarket
                      is_wrong_number: false
                      kind: mobile
                    recent_activity:
                    - event_at: '2026-08-19T14:47:03Z'
                      event_type: completed_without_reply
                      sequence_id: b026f38bb2881327da047d9126adcc9a3312ff12
                      sequence_type: sequence
                      sequence_name: A sequence
                    - event_at: '2026-08-18T13:35:03Z'
                      event_type: added_to_sequence
                      sequence_id: b026f38bb2881327da047d9126adcc9a3312ff12
                      sequence_type: sequence
                      sequence_name: A sequence
              schema:
                "$ref": "#/components/schemas/response_contact_with_activity_object"
      description: Retrieve contact by email
  "/tasks":
    get:
      summary: List tasks
      parameters:
      - name: page[size]
        in: query
        required: false
        description: Page size
        schema:
          type: string
      - name: page[after]
        in: query
        required: false
        description: Page after
        schema:
          type: string
      - name: page[before]
        in: query
        required: false
        description: Page before
        schema:
          type: string
      - name: automatic
        in: query
        required: false
        description: Filter by task automation type
        schema:
          type: boolean
      - name: type
        in: query
        required: false
        description: Filter by task type
        schema:
          type: string
      - name: status
        in: query
        required: false
        description: Filter by task status
        schema:
          type: string
      - name: contact_local_time_from
        in: query
        schema:
          type: integer
          minimum: 0
          maximum: 23
        required: false
        description: Filter by associated contact local time hour being higher than
          this value
      - name: contact_local_time_to
        in: query
        schema:
          type: integer
          minimum: 0
          maximum: 23
        required: false
        description: Filter by associated contact local time hour being lower than
          this value
      - name: message_opens
        in: query
        schema:
          type: integer
          minimum: 0
        required: false
        description: Filter by associated message opens
      - name: keyword
        in: query
        required: false
        description: Filter by name, email or company associated with task
        schema:
          type: string
      - name: sequence_key
        in: query
        required: false
        description: Filter by associated sequence
        schema:
          type: string
      - name: user_id
        in: query
        required: true
        description: Filter by user
        schema:
          type: string
      tags:
      - Tasks
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    tasks:
                    - id: 01a01a7d-7f9d-71d2-bb1d-76c07ccff28d
                      automatic: false
                      type: phone_call
                      status: scheduled
                      due_on: '2026-08-19T12:47:07Z'
                      finished_on:
                      notes: custom task notes
                      sequence_key:
                      sequence_name:
                      user_id: 01a01a7d-7da0-7b3b-a953-b1bfa551a383
                      user_email: user@example.com
                      contact:
                        id: 0aa16187-1ce3-450d-9d7a-895cef65dbb3
                        name: John Doe
                        email: user@example.com
                    _links:
                      self:
                        href: "/tasks?page[size]=20&status=due&user_id=01a01a7d-7da0-7b3b-a953-b1bfa551a383"
              schema:
                type: object
                properties:
                  tasks:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        automatic:
                          type: boolean
                        type:
                          type: string
                        status:
                          type: string
                        notes:
                          type: string
                          nullable: true
                        due_on:
                          type: string
                          format: date_time
                        finished_on:
                          type: string
                          format: date_time
                          nullable: true
                        sequence_key:
                          type: string
                          nullable: true
                        sequence_name:
                          type: string
                          nullable: true
                        user_id:
                          type: string
                        user_email:
                          type: string
                        contact:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                            name:
                              type: string
                              nullable: true
                            email:
                              type: string
                          required:
                          - id
                          - email
                      required:
                      - id
                      - automatic
                      - type
                      - status
                      - due_on
                      - user_id
                      - user_email
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Missing user:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: user_id'
                      source:
                        pointer: "/user_id"
                    object: error
                Unsupported status value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'unsupported' is not a supported status"
                      source:
                        pointer: "/status"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: List tasks
  "/tasks/{id}/complete":
    parameters:
    - name: id
      in: path
      required: true
      description: Task id
      schema:
        type: string
    post:
      summary: Complete task
      parameters: []
      tags:
      - Tasks
      responses:
        '200':
          description: Successful
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                set_lead_to_completed:
                  type: boolean
                  default: false
      description: Complete task
  "/tasks/{id}/skip":
    parameters:
    - name: id
      in: path
      required: true
      description: Task id
      schema:
        type: string
    post:
      summary: Skip task
      parameters:
      - name: id
        in: path
        required: true
        description: Task id
        schema:
          type: string
      tags:
      - Tasks
      responses:
        '200':
          description: Successful
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Task cannot be skipped:
                  value:
                    _errors:
                    - code: invalid_operation
                      title: Invalid Operation
                      detail: Task has status "completed" and cannot be skipped
                    object: error
      description: Skip task
  "/tasks/statuses":
    get:
      summary: List task statuses
      parameters: []
      tags:
      - Tasks
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    statuses:
                    - due
                    - upcoming
                    - completed
                    - skipped
                    - paused
                    - cancelled
              schema:
                type: object
                properties:
                  statuses:
                    type: array
                    items:
                      type: string
      description: List task statuses
  "/tasks/types":
    get:
      summary: List task types
      parameters: []
      tags:
      - Tasks
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Successful:
                  value:
                    types:
                    - email
                    - linkedin_visit
                    - linkedin_follow
                    - linkedin_like_last_post
                    - linkedin_connect
                    - linkedin_message
                    - linkedin_voice_message
                    - linkedin_video_message
                    - phone_call
                    - custom_task
                    - whatsapp
                    - sms
              schema:
                type: object
                properties:
                  types:
                    type: array
                    items:
                      type: string
      description: List task types
  "/sequences/{id}/leads":
    parameters:
    - name: id
      in: path
      schema:
        type: string
      required: true
      description: Sequence id
    post:
      summary: Add leads
      parameters: []
      tags:
      - Sequences
      responses:
        '200':
          description: Ok
          content:
            application/json:
              examples:
                Adding a single lead:
                  value:
                    total: 1
                    total_added_to_sequence: 1
                    duplicate_emails: []
                    duplicate_linkedin_urls: []
                    in_exclusion_list_and_skipped: []
                    recently_contacted_and_skipped: []
                    already_in_sequence_and_skipped: []
                    in_other_draft_sequences_and_skipped: []
                    in_other_active_sequences_and_skipped: []
              schema:
                type: object
                additionalProperties: false
                properties:
                  total:
                    type: integer
                    description: Total number of leads processed in the request.
                  total_added_to_sequence:
                    type: integer
                    description: Total number of leads successfully added to the sequence.
                  duplicate_emails:
                    type: array
                    items:
                      type: string
                      description: List of emails skipped because they are duplicated
                        in the request.
                  duplicate_linkedin_urls:
                    type: array
                    items:
                      type: string
                      description: List of LinkedIn urls skipped because they are
                        duplicated in the request.
                  in_exclusion_list_and_skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        linkedin_url:
                          type: string
                    description: List of leads skipped due to exclusion list.
                  recently_contacted_and_skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        linkedin_url:
                          type: string
                    description: List of leads skipped because they were recently
                      contacted.
                  already_in_sequence_and_skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        linkedin_url:
                          type: string
                    description: List of leads skipped because they are already in
                      this sequence.
                  in_other_draft_sequences_and_skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        linkedin_url:
                          type: string
                    description: List of leads skipped because they are present in
                      another draft sequence.
                  in_other_active_sequences_and_skipped:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        linkedin_url:
                          type: string
                    description: List of leads skipped because they are present in
                      another live or paused sequence.
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Bad request:
                  value:
                    _errors:
                    - code: missing_field
                      title: Missing Field
                      detail: 'Missing field from request: leads'
                      source:
                        pointer: "/leads"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
        '422':
          description: Unprocessable entity
          content:
            application/json:
              examples:
                Failed sequence validations:
                  value:
                    validation_errors:
                    - error_code: missing_lead_field
                      message: Missing lead dynamic field 'it' on leads with indexes
                        [1]
              schema:
                type: object
                additionalProperties: false
                required:
                - validation_errors
                properties:
                  validation_errors:
                    type: array
                    items:
                      type: object
                      required:
                      - error_code
                      - message
                      properties:
                        error_code:
                          type: string
                          nullable: false
                        message:
                          type: string
                          nullable: false
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - leads
              additionalProperties: false
              properties:
                leads:
                  description: Leads to be added to the sequence
                  type: array
                  items:
                    type: object
                    properties:
                      email:
                        type: string
                        format: email
                        example: lead@target.example.com
                      linkedin_url:
                        type: string
                        format: uri
                        example: https://www.linkedin.com/in/example
                      data:
                        type: object
                        additionalProperties:
                          type: string
                          nullable: true
                          maxLength: 1024
                        example:
                          custom_nickname: Joe
                          company_name: Target
                        description: Additional lead data fields
                      routing:
                        type: object
                        additionalProperties: false
                        description: Account routing options
                        properties:
                          salesforce_account_id:
                            type: string
                            nullable: true
                            example: 001XXXXXXXXXXXXXXX
                            description: |
                              Salesforce Account ID to use for account association.

                              > **Notes**
                              > - When provided, Amplemarket treats this as the authoritative account and uses it instead of domain-based account matching.
                              > - If a matching contact already exists under another account, Amplemarket re-associates it to the provided Salesforce account using its standard CRM behavior.
                              > - If omitted, null, or empty, Amplemarket falls back to the default account matching behavior.
                      overrides:
                        type: object
                        additionalProperties: false
                        properties:
                          ignore_recently_contacted:
                            type: boolean
                            description: Whether we should override recently contacted
                              checks
                          ignore_exclusion_list:
                            type: boolean
                            description: 'Whether we should override exclusion list '
                          ignore_duplicate_leads_in_other_draft_sequences:
                            type: boolean
                            description: Whether we should allow leads present in
                              other draft sequences
                          ignore_duplicate_leads_in_other_active_sequences:
                            type: boolean
                            description: Whether we should allow leads present in
                              other active sequences
                settings:
                  type: object
                  additionalProperties: false
                  properties:
                    leads_distribution:
                      type: string
                      enum:
                      - sequence_senders
                      - custom_mailboxes
                      nullable: true
                      example: custom_mailboxes
                    mailboxes:
                      type: array
                      items:
                        type: string
                        format: email
                      example:
                      - salesrep@first.example.com
                      - salesrep@second.example.com
                      description: Mailboxes to choose from when distributing with
                        custom_mailboxes
        required: true
      description: Add leads
  "/sequences":
    parameters:
    - name: page[size]
      in: query
      required: false
      description: Page size
      schema:
        type: string
    - name: page[after]
      in: query
      required: false
      description: Page after
      schema:
        type: string
    - name: page[before]
      in: query
      required: false
      description: Page before
      schema:
        type: string
    - name: status
      in: query
      required: false
      description: Filter by sequence status
      schema:
        type: string
    - name: created_by_user_id
      in: query
      required: false
      description: Filter by sequence creator id
      schema:
        type: string
    - name: created_by_user_email
      in: query
      required: false
      description: Filter by sequence creator email
      schema:
        type: string
    - name: name
      in: query
      required: false
      description: Search by sequence name (case insensitive)
      schema:
        type: string
    get:
      summary: List Sequences
      parameters: []
      tags:
      - Sequences
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    sequences:
                    - id: b0fc2a17ac412554ba82f8d4f92f22c0821228a6
                      name: Sample sequence
                      status: active
                      priority: normal
                      url: https://localhost:3000/dashboard/sequences/b0fc2a17ac412554ba82f8d4f92f22c0821228a6
                      tags: []
                      dynamic_fields_used:
                      - first_name
                      - company_name
                      created_by_user_id: 01a01a7d-8696-7e0d-ad53-abbebad80990
                      created_by_user_email: foo-96@email.com
                      created_at: '2026-08-19T14:47:10Z'
                      updated_at: '2026-08-19T14:47:10Z'
                    - id: 13261c66143af59134b708a2153210f3af82ea0c
                      name: A sequence
                      status: active
                      priority: normal
                      url: https://localhost:3000/dashboard/sequences/13261c66143af59134b708a2153210f3af82ea0c
                      tags: []
                      dynamic_fields_used: []
                      created_by_user_id: 01a01a7d-8696-7e0d-ad53-abbebad80990
                      created_by_user_email: foo-96@email.com
                      created_at: '2026-08-19T14:47:09Z'
                      updated_at: '2026-08-19T14:47:09Z'
                    _links:
                      self:
                        href: "/sequences?page[size]=20"
              schema:
                type: object
                properties:
                  sequences:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Sequence id
                        name:
                          type: string
                          description: Sequence name
                        status:
                          type: string
                          description: Sequence status
                        priority:
                          type: string
                          description: Sequence priority
                        url:
                          type: string
                          format: uri
                          description: Sequence url in the Amplemarket dashboard
                        tags:
                          type: array
                          items:
                            type: string
                          description: Sequence tag names
                        dynamic_fields_used:
                          type: array
                          items:
                            type: string
                          example:
                          - first_name
                          - company_name
                          description: Lead dynamic fields referenced by the active
                            stages.
                        created_by_user_id:
                          type: string
                          description: Sequence creator id
                        created_by_user_email:
                          type: string
                          description: Sequence creator email
                        created_at:
                          type: string
                          format: date-time
                          description: Sequence creation date
                        updated_at:
                          type: string
                          format: date-time
                          description: Sequence last update date
                  _links:
                    "$ref": "#/components/schemas/response_links_object"
        '400':
          description: Bad request
          content:
            application/json:
              examples:
                Unsupported status value:
                  value:
                    _errors:
                    - code: unsupported_value
                      title: Unsupported Value
                      detail: "'invalid' is not a supported status."
                      source:
                        pointer: "/status"
                    object: error
              schema:
                "$ref": "#/components/schemas/response_errors_object"
      description: List Sequences
  "/account-info":
    get:
      summary: Get account details
      parameters: []
      tags:
      - Account
      responses:
        '200':
          description: OK
          content:
            application/json:
              examples:
                OK:
                  value:
                    id: 01a01a7d-8f7c-717f-b774-a2e72c25d2dd
                    name: Test Account 120
              schema:
                "$ref": "#/components/schemas/response_account_details_object"
      description: Get account details
servers:
- url: https://api.amplemarket.com
security:
- bearerAuth: []
