> ## 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 - Single > Reverse-lookup a person by email, phone, or (with similarity search enabled) first/last name plus domain or company. Returns the matched person's `people_search_id` and base details, plus `match` metadata describing how the match was made. Charges 1 credit per billable match. ## OpenAPI ````yaml en-openapi POST /redeem/people/contact/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: /redeem/people/contact/lookup: post: tags: - Redeem summary: Look up a person by contact identifier description: >- Reverse-lookup a person by email, phone, or (with similarity search enabled) first/last name plus domain or company. Returns the matched person's `people_search_id` and base details, plus `match` metadata describing how the match was made. Charges 1 credit per billable match. operationId: redeem_people_contact_lookup parameters: [] requestBody: required: true content: application/json: schema: type: object properties: email: $ref: '#/components/schemas/contact_lookup_email' phone: $ref: '#/components/schemas/contact_lookup_phone' first_name: $ref: '#/components/schemas/contact_lookup_first_name' last_name: $ref: '#/components/schemas/contact_lookup_last_name' domain: $ref: '#/components/schemas/contact_lookup_domain' company: $ref: '#/components/schemas/contact_lookup_company' is_enable_similarity_search: $ref: >- #/components/schemas/contact_lookup_is_enable_similarity_search profile_id: $ref: '#/components/schemas/profile_id' anyOf: - title: Email required: - email - title: Phone required: - phone - title: Name + Domain (similarity) required: - first_name - last_name - domain - is_enable_similarity_search - title: Name + Company (similarity) required: - first_name - last_name - company - is_enable_similarity_search responses: '200': description: >- Successful response containing the matched person and match metadata. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: profile: credit: 450375 topup_credit: 235236 total_credit_cost: 1 peoples: - people_search_id: e37ccf38-ea8f-422e-9874-cb23b15e8fe4 first_name: King last_name: Lai 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 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: contact_lookup_email: type: string format: email example: person@example.com description: >- Work or personal email address to look up. The system normalizes case and whitespace before matching. contact_lookup_phone: type: string example: '+15551234567' description: Phone number to look up. International (E.164) format is recommended. contact_lookup_first_name: type: string example: King description: >- First name. Used together with `last_name` and either `domain` or `company` when `is_enable_similarity_search` is `true`. contact_lookup_last_name: type: string example: Lai description: >- Last name. Used together with `first_name` and either `domain` or `company` when `is_enable_similarity_search` is `true`. contact_lookup_domain: type: string example: pubrio.com description: >- Company domain used as a similarity-search anchor together with `first_name` + `last_name` when `is_enable_similarity_search` is `true`. contact_lookup_company: type: string example: Pubrio description: >- Company name used as a similarity-search anchor together with `first_name` + `last_name` when `is_enable_similarity_search` is `true` and `domain` is not provided. 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 ````