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

# Monitor Lookup

> Retrieve detailed information about a specific monitor.



## OpenAPI

````yaml en-openapi POST /monitors/lookup
openapi: 3.0.0
info:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/en/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/en/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: Workspace profile information and usage statistics
  - name: Enrichment
    description: Enrich people and company records with detailed B2B data
  - name: Lookalike
    description: Find companies similar to a given company
  - name: Search
    description: Search for people, companies, jobs, news, and advertisements with filters
  - name: Lookup
    description: >-
      Look up detailed information for specific people, companies, jobs, news,
      advertisements, and technologies
  - name: LinkedIn
    description: Look up people and company data via LinkedIn profile URLs
  - name: Redeem
    description: Redeem credits to unlock people contact details (single and batch)
  - name: Channels
    description: Manage outreach channel templates (create, update, delete, list)
  - name: Monitor
    description: Create and manage data monitors with webhooks, statistics, and processing
  - name: Filters
    description: >-
      Retrieve available filter values for search parameters (technologies,
      locations, verticals, etc.)
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /monitors/lookup:
    post:
      tags:
        - Monitor
      summary: Look up a monitor
      description: Retrieve detailed information about a specific monitor.
      operationId: monitors_lookup
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: Unique identifier of the monitor to look up.
                is_signature_reveal:
                  type: boolean
                  description: >-
                    When true, the full webhook signature is included in the
                    response. Defaults to false.
                  default: false
                profile_id:
                  $ref: '#/components/schemas/profile_id'
              required:
                - monitor_id
      responses:
        '200':
          description: >-
            Successful response containing the full monitor details including
            configuration and destination settings.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      monitor_id:
                        type: string
                        format: uuid
                        description: Unique identifier for the monitor.
                      profile_id:
                        type: integer
                        description: Profile identifier.
                      user_id:
                        type: string
                        description: User identifier.
                      name:
                        type: string
                        description: Name of the monitor.
                      description:
                        type: string
                        description: Description of the monitor.
                      detection_mode:
                        type: string
                        description: Detection mode.
                      signal_types:
                        type: array
                        items:
                          type: string
                        description: Types of signals monitored.
                      signal_filters:
                        type: array
                        items:
                          type: object
                        description: Signal filters configuration.
                      company_filters:
                        type: object
                        description: Company filters configuration.
                      companies:
                        type: array
                        items:
                          type: string
                        description: Company identifiers.
                      is_company_enrichment:
                        type: boolean
                        description: Whether company enrichment is enabled.
                      is_people_enrichment:
                        type: boolean
                        description: Whether people enrichment is enabled.
                      people_enrichment_configs:
                        type: array
                        items:
                          type: object
                        description: People enrichment configuration.
                      destination_type:
                        type: string
                        description: Delivery destination type.
                      destination_config:
                        type: object
                        description: Full destination configuration details.
                      frequency_minute:
                        type: integer
                        description: Trigger frequency in minutes.
                      max_retry_per_trigger:
                        type: integer
                        description: Maximum retries per trigger.
                      max_records_per_trigger:
                        type: integer
                        description: Maximum records per trigger.
                      retry_delay_second:
                        type: integer
                        description: Delay between retries in seconds.
                      max_daily_trigger:
                        type: integer
                        description: Maximum triggers per day.
                      max_failure_trigger:
                        type: integer
                        description: Maximum consecutive failures before pausing.
                      masked_signature:
                        type: string
                        description: Masked webhook signature.
                      signature:
                        type: string
                        format: uuid
                        description: >-
                          Full webhook signature. Only included when
                          is_signature_reveal is true.
                      repeated_failure_count:
                        type: integer
                        description: Current count of repeated consecutive failures.
                      is_active:
                        type: boolean
                        description: Whether the monitor is active.
                      is_paused:
                        type: boolean
                        description: Whether the monitor is paused.
                      notification_email:
                        type: string
                        description: Notification email address.
                      last_trigger_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: Timestamp of the last trigger.
                      last_processed_at:
                        type: string
                        format: date-time
                        nullable: true
                        description: Timestamp of the last completed processing.
                      created_at:
                        type: string
                        format: date-time
                        description: Timestamp when the monitor was created.
                      last_modified:
                        type: string
                        format: date-time
                        description: Timestamp when the monitor was last modified.
                      last_processed:
                        type: string
                        format: date-time
                        nullable: true
                        description: Timestamp of the last processed event.
                      user:
                        type: object
                        properties:
                          user_id:
                            type: string
                            description: Identifier of the user who created the monitor.
                          nickname:
                            type: string
                            description: Display name of the user.
                          email:
                            type: string
                            description: Email of the user.
                        description: User who created the monitor.
              example:
                data:
                  monitor_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                  profile_id: 1
                  user_id: a1b2c3d4-0000-0000-0000-000000000000
                  name: Signal First Monitor
                  description: Tracking AI job postings
                  detection_mode: signal_first
                  signal_types:
                    - jobs
                    - news
                    - advertisements
                  signal_filters:
                    - filters:
                        locations:
                          - US
                        titles:
                          - AI Engineer
                      signal_type: jobs
                    - ...
                  company_filters:
                    locations:
                      - US
                    employees:
                      - - 501
                        - 1000
                    ...: ...
                  companies:
                    - 67c4696b-b7b0-46b5-b2af-9f434543661e
                  is_company_enrichment: true
                  is_people_enrichment: true
                  people_enrichment_configs:
                    - filters:
                        management_levels:
                          - founder
                          - vp
                        ...: ...
                      max_people_to_return: 25
                      people_contact_types:
                        - email-work
                        - email-personal
                        - phone
                  destination_type: webhook
                  destination_config:
                    webhook_url: https://usewebhook.com/example
                    headers:
                      X-Custom-Auth: your-token
                    body:
                      source: pubrio
                  frequency_minute: 0
                  notification_email: team@example.com
                  max_retry_per_trigger: 2
                  max_records_per_trigger: 10
                  retry_delay_second: 5
                  max_daily_trigger: 500
                  masked_signature: 7••••••••••••••••8df
                  signature: 710a69f6-aaaf-449d-b3f6-78ba66d648df
                  repeated_failure_count: 0
                  is_active: true
                  is_paused: false
                  max_failure_trigger: 5
                  last_processed_at: null
                  last_trigger_at: null
                  created_at: '2026-04-05T20:30:17.792Z'
                  last_modified: '2026-04-05T20:30:17.792Z'
                  last_processed: null
                  user:
                    user_id: a1b2c3d4-0000-0000-0000-000000000000
                    nickname: Jane Smith
                    email: jane@example.com
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    profile_id:
      type: integer
      description: >-
        Optional. An identifier for the user profile (workspace) making the
        request. This is no longer required as the API key already includes your
        workspace information. If provided, it helps in associating the lookup
        with a specific user, allowing for data retrieval and credit tracking. 

         Check out `user details` endpoints under the Profile tab for more information.
  responses:
    general_error:
      description: >-
        Bad request. The request was malformed or contained invalid parameters.
        Check the error code and message for details.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Errors and codes will vary depending on the scenario, please
                  see the documentation for information.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Rate limit exceeded. Too many requests were made in a given time period.
        Retry after the rate limit window resets.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Request rate limit exceeded. Please wait and try again later.
                type: string
    server_error:
      description: >-
        Internal server error. An unexpected error occurred on the server.
        Contact support if the error persists.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: An unexpected error occurred on the server.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        A unique API token that represents the actions you perform through the
        API and the corresponding permissions and operations. You can create it
        through the [Settings](https://dashboard.pubrio.com/#/settings/)
        section.
      in: header

````