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

# Contact Lookup - Bulk

> Batch version of `/redeem/people/contact/lookup`. Submit up to your subscription's bulk size limit in a single request. Each entry in `peoples` accepts the same identifiers as the single-lookup body. Charges 1 credit per billable match — duplicate inputs and unmatched entries are not charged.



## OpenAPI

````yaml en-openapi POST /redeem/people/contact/lookup/batch
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:
  /redeem/people/contact/lookup/batch:
    post:
      tags:
        - Redeem
      summary: Bulk-look up people by contact identifier
      description: >-
        Batch version of `/redeem/people/contact/lookup`. Submit up to your
        subscription's bulk size limit in a single request. Each entry in
        `peoples` accepts the same identifiers as the single-lookup body.
        Charges 1 credit per billable match — duplicate inputs and unmatched
        entries are not charged.
      operationId: redeem_people_contact_lookup_batch
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                peoples:
                  $ref: '#/components/schemas/contact_lookup_peoples'
                is_enable_similarity_search:
                  $ref: >-
                    #/components/schemas/contact_lookup_is_enable_similarity_search
                profile_id:
                  $ref: '#/components/schemas/profile_id'
              required:
                - peoples
      responses:
        '200':
          description: >-
            Successful response containing matched people and per-record match
            metadata.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/data'
              example:
                data:
                  profile:
                    credit: 450374
                    topup_credit: 235236
                    total_credit_cost: 2
                  peoples:
                    - people_search_id: e37ccf38-ea8f-422e-9874-cb23b15e8fe4
                      people_name: King Lai
                      company_name: Pubrio
                      domain: pubrio.com
                      match:
                        confidence: exact
                        input:
                          value: king.lai@pubrio.com
                          type: email-work
                        is_duplicate_input: false
                    - people_search_id: 1c4f0a9d-9a8e-4ab0-9b07-2cd09c4a3a6b
                      people_name: John Smith
                      company_name: Example
                      domain: example.com
                      match:
                        confidence: similarity_domain
                        input:
                          value: example.com
                          type: domain
                        is_duplicate_input: false
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    contact_lookup_peoples:
      type: array
      items:
        type: object
        properties:
          email:
            type: string
            format: email
          phone:
            type: string
          first_name:
            type: string
          last_name:
            type: string
          company:
            type: string
          domain:
            type: string
      example:
        - email: king.lai@pubrio.com
        - first_name: John
          last_name: Smith
          domain: example.com
      description: >-
        Array of lookup specs. Each entry accepts the same identifiers as the
        single-lookup body (`email`, `phone`, or `first_name` + `last_name` +
        `domain`/`company` when similarity search is enabled). Capped by your
        subscription's bulk size limit.
    contact_lookup_is_enable_similarity_search:
      type: boolean
      default: false
      example: true
      description: >-
        When `true`, falls back to a name-based similarity match if no exact
        email/phone hit is found. Requires `first_name`, `last_name`, and either
        `domain` or `company`.
    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.
    data:
      type: object
      nullable: true
      description: Response info depends on specific endpoint.
  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

````