{"openapi":"3.1.0","info":{"title":"Reverse Contact API","version":"1.0.0","description":"Public Reverse Contact API V2 for people and company enrichment, search, fetch, resolve, and usage. Authenticate with Authorization: Bearer rc_... using an API key from the developer dashboard. Every successful response uses a consistent envelope: success, data, error, quotas, metadata. Search endpoints nest results under data.data with pagination in data.metadata. Enrich endpoints nest the primary entity under data.person or data.company. Async live and resolve endpoints acknowledge with data.webhookId; poll GET /v2/webhooks/{webhookId}.","contact":{"name":"Reverse Contact Support","url":"https://reversecontact.com","email":"support@reversecontact.com"},"license":{"name":"Proprietary","url":"https://reversecontact.com"}},"servers":[{"url":"https://api.reversecontact.com","description":"Production"}],"tags":[{"name":"Enrich","description":"Synchronous people and company enrichment"},{"name":"Search","description":"Filter-based search over people and companies"},{"name":"Fetch","description":"Profile fetch, live refresh, and free profile status checks"},{"name":"Resolve","description":"Async resolution of people and companies (prefer enrich when possible)"},{"name":"Contact","description":"Asynchronous professional email and phone number discovery by webhook"},{"name":"Webhooks","description":"Polling for async job results"},{"name":"Usage","description":"Credit balance and rate limit status"}],"paths":{"/v2/enrich/persons":{"post":{"operationId":"enrichPerson","summary":"Enrich person","description":"Synchronously resolves a person from any combination of email, first name, last name, and company domain/name. Returns the full profile of the matched person nested under data.person, with the full profiles of the alternative candidates under data.alternativePersons and data.isFullProfile telling whether the full profile could be assembled. Credits: 2 when a person is found, full profile included. 404 is free.","tags":["Enrich"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Person enriched successfully","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/EnrichPersonData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichPersonBody"}}}}}},"/v2/enrich/companies":{"post":{"operationId":"enrichCompany","summary":"Enrich company","description":"Synchronously resolves a company from a domain. Returns the full profile of the matched company nested under data.company, with data.isFullProfile telling whether the full profile could be assembled. Credits: 2 when a company is found, full profile included. 404 is free.","tags":["Enrich"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Company enriched successfully","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/EnrichCompanyData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichCompanyBody"}}}}}},"/v2/search/people":{"post":{"operationId":"searchPeople","summary":"Search people","description":"Search the Reverse Contact database for people matching filters (AND-combined) and return full profiles. Pass metadata.nextCursor back as cursor for the next page. perPage defaults to 25 and is capped at 100. Results are at data.data and cursor metadata at data.metadata. Filters are strictly validated: unknown fields, blank values and values outside a closed vocabulary return 422 with the offending field and suggestions, and cost 0 credits. Credits: 1 for the search request.","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"People search results","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchPeopleData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPeopleBody"}}}}}},"/v2/search/people/prompt":{"post":{"operationId":"searchPeopleByPrompt","summary":"Agentic Search","description":"Describe the people to find in plain language: the prompt is read into People Search filters, then the matching full profiles are returned as a People Search page. The filters applied and anything the prompt asked for that no filter covers are returned at data.interpretation. Pass metadata.nextCursor back as cursor with the same prompt for the next page: a prompt keeps the filters it was read into for 24 hours, so every page runs on the same filters. A cursor sent with filters other than the ones that produced it returns 400 and costs 0 credits. Send filters only through the prompt; to set them explicitly, use /v2/search/people. A prompt no filter can be read from returns 422 NO_FILTERS_INTERPRETED and costs 0 credits. Credits: 1 per page for the search itself, even when no profile matches, plus 1 per profile delivered. A prompt refused before the search costs 0.","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"People search results with the interpreted filters","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchPeoplePromptData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPeoplePromptBody"}}}}}},"/v2/search/people/lookalike":{"post":{"operationId":"searchPeopleLookalike","summary":"People lookalike","description":"Find the people who look like one seed profile, given by Social profile URL or Reverse Contact person id. The search is built from the seed: its current function and sub-function, seniority and location. The seed is never among the results. Returns full profiles as a People Search page: results at data.data and cursor metadata at data.metadata. Pass metadata.nextCursor back as cursor with the same seed for the next page. Search filters are refused with 422 LOOKALIKE_FILTERS_NOT_SUPPORTED and cost 0 credits. A seed not yet in the search index returns 404 and costs 0 credits. Credits: 1 per profile delivered. A page with no profile costs 0.","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"People who look like the seed","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchPeopleData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPeopleLookalikeBody"}}}}}},"/v2/search/people/count":{"post":{"operationId":"countPeople","summary":"Count people","description":"Count profiles matching the same filters as People Search without returning profiles. Credits: 0 (free).","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"People count","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchPeopleCountData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchPeopleCountBody"}}}}}},"/v2/search/companies":{"post":{"operationId":"searchCompanies","summary":"Search companies","description":"Search the Reverse Contact database for companies matching filters (AND-combined). Uses a nested envelope: results at data.data and pagination at data.metadata. Filters are strictly validated: unknown fields, blank values and values outside a closed vocabulary return 422 with the offending field and suggestions, and cost 0 credits. Credits: 1 credit per page.","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Company search results","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchCompaniesData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchCompaniesBody"}}}}}},"/v2/search/people/available-fields":{"get":{"operationId":"searchPeopleAvailableFields","summary":"People search available fields","description":"Returns metadata for every filter accepted by people search. Credits: 0 (free).","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"People search field catalog","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchFieldsData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}}}},"/v2/search/companies/available-fields":{"get":{"operationId":"searchCompaniesAvailableFields","summary":"Company search available fields","description":"Returns metadata for every filter accepted by company search. Credits: 0 (free).","tags":["Search"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Company search field catalog","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/SearchFieldsData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}}}},"/v2/fetch/persons":{"post":{"operationId":"fetchPerson","summary":"Person profile","description":"Retrieves a full person profile from cache using a Social URL or Reverse Contact person id. Credits: 1 on cache hit. 0 on 404 cache miss.","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Person profile","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PersonFull"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlOrIdPersonBody"}}}}}},"/v2/fetch/persons/live":{"post":{"operationId":"livePerson","summary":"Person profile live","description":"Triggers a fresh scrape of a person profile from either a Social URL or Reverse Contact person id. Provide exactly one; replies immediately with a webhookId. Retrieve the result via GET /v2/webhooks/{webhookId} or an optional webhookUrl callback. Credits: 2 (live). Not available on free trial.","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Live person job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/JobAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LivePersonBody"}}}}}},"/v2/fetch/persons/check":{"post":{"operationId":"checkPerson","summary":"Person profile status","description":"Checks whether a person profile exists and when it was last updated, without returning the full profile. Credits: 0. Still requires a non-empty credit balance (returns 402 NO_CREDITS when empty).","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Person availability and freshness","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CheckPersonData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlOrIdPersonBody"}}}}}},"/v2/fetch/companies":{"post":{"operationId":"fetchCompany","summary":"Company profile","description":"Retrieves a full company profile from cache using a Social URL or Reverse Contact company id. Credits: 1 on cache hit. 0 on 404 cache miss.","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Company profile","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CompanyFull"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlOrIdCompanyBody"}}}}}},"/v2/fetch/companies/live":{"post":{"operationId":"liveCompany","summary":"Company profile live","description":"Triggers a fresh scrape of a company profile from either a Social URL or Reverse Contact company id. Provide exactly one; replies immediately with a webhookId. Retrieve the result via GET /v2/webhooks/{webhookId} or an optional webhookUrl callback. Credits: 2 (live). Not available on free trial.","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Live company job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/JobAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveCompanyBody"}}}}}},"/v2/fetch/companies/check":{"post":{"operationId":"checkCompany","summary":"Company profile status","description":"Checks whether a company profile exists and when it was last updated, without returning the full profile. Credits: 0. Still requires a non-empty credit balance (returns 402 NO_CREDITS when empty).","tags":["Fetch"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Company availability and freshness","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CheckCompanyData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlOrIdCompanyBody"}}}}}},"/v2/resolve/persons/email":{"post":{"operationId":"resolvePersonByEmail","summary":"Resolve person from email","description":"Async resolve of a person from an email address. Replies immediately with a webhookId. Prefer the synchronous enrich endpoint for the same data without polling. Credits: 2 when found, 0 on not found. Not available on free trial.","tags":["Resolve"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Resolve job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/JobAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvePersonEmailBody"}}}}}},"/v2/resolve/persons/name":{"post":{"operationId":"resolvePersonByName","summary":"Resolve person from name and company","description":"Async resolve of a person from first name, last name, and company domain or name. Replies immediately with a webhookId. Prefer synchronous enrich for the same data without polling. Credits: 2 when found, 0 on not found. Not available on free trial.","tags":["Resolve"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Resolve job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/JobAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvePersonNameBody"}}}}}},"/v2/resolve/companies/live":{"post":{"operationId":"resolveCompanyLive","summary":"Resolve company from domain","description":"Async resolve of a company from a domain. Replies immediately with a webhookId. Prefer the synchronous enrich company endpoint for the same data without polling. Credits: 2 live / 1 cached when found, 0 on not found. Not available on free trial.","tags":["Resolve"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Resolve job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/JobAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveCompanyBody"}}}}}},"/v2/contact/email":{"post":{"operationId":"findContactEmail","summary":"Find contact email","description":"Asynchronously finds professional email addresses from a LinkedIn profile URL or a person name with company domain. The request is acknowledged with data.webhookId and data.pollUrl. Poll GET /v2/webhooks/{webhookId} for the email array in data.result, or receive it on the optional webhookUrl callback. Credits: 3 when an email is found, 0 when no email is found.","tags":["Contact"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Contact email lookup job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ContactEmailAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactEmailBody"}}}}}},"/v2/contact/phone":{"post":{"operationId":"findContactPhone","summary":"Find contact phone","description":"Asynchronously finds phone numbers from a LinkedIn profile URL or a person name with company domain. The request is acknowledged with data.webhookId and data.pollUrl. Poll GET /v2/webhooks/{webhookId} for the phone array in data.result, or receive it on the optional webhookUrl callback. Credits: 20 when a phone number is found, 0 when no phone number is found. Enabled by default; the endpoint returns 410 for a workspace without phone finding access.","tags":["Contact"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Contact phone lookup job created","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ContactPhoneAckData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"410":{"description":"Contact phone finding is not enabled for this workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","const":"endpoint_unavailable"},"message":{"type":"string","description":"Reason the endpoint is unavailable"},"alternative":{"type":"object","properties":{"endpoint":{"type":"string","description":"Suggested alternative endpoint"},"docs":{"type":"string","description":"Documentation path for the alternative"}},"required":["endpoint","docs"],"additionalProperties":false}},"required":["error","message","alternative"],"additionalProperties":false},"example":{"error":"endpoint_unavailable","message":"Phone finding is not enabled for this workspace.","alternative":{"endpoint":"/v2/contact/email","docs":"/docs/endpoints/contact-email"}}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactPhoneBody"}}}}}},"/v2/webhooks/{webhookId}":{"get":{"operationId":"pollWebhook","summary":"Poll async job","description":"Returns the status and result of an async job created by the live, resolve or contact endpoints. When status is succeeded, data.result contains the job result. Credits: 0 (free). Does not increment per-minute rate limit counters.","tags":["Webhooks"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Job status and optional result","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PollWebhookData"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}},"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string","description":"Job identifier returned as webhookId","format":"uuid"}}]}},"/v2/usage":{"get":{"operationId":"getUsage","summary":"Usage","description":"Returns workspace credit balance and rate limit status. data is always null; all useful information is in the quotas block. Credits: 0 (free).","tags":["Usage"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Usage and quota snapshot","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/V2SuccessEnvelope"},{"type":"object","properties":{"data":{"type":"null","description":"Always null for this endpoint"}},"additionalProperties":false}]}}}},"400":{"description":"Invalid JSON body or endpoint-specific business validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"401":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"402":{"description":"No credits left. Purchase more to continue.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"404":{"description":"Data not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"422":{"description":"Schema or validation error, unresolved internal id, disposable email domain, or missing webhook URL on async endpoints","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"429":{"description":"Rate limit exceeded. Wait and retry after nextReset.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}},"451":{"description":"Data subject blocked. The profile has been removed per GDPR/CCPA data subject request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2ErrorEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"rc_*","description":"API key from the Reverse Contact developer dashboard. Pass as Authorization: Bearer rc_..."}},"schemas":{"V2LimitInfo":{"type":"object","properties":{"limit":{"type":"number","description":"Maximum allowed in the window"},"used":{"type":"number","description":"Amount used in the window"},"left":{"type":"number","description":"Remaining in the window"},"nextReset":{"type":"string","description":"When the window resets (ISO 8601)"}},"required":["limit","used","left","nextReset"],"additionalProperties":false},"V2Credits":{"type":"object","properties":{"total":{"type":"number","description":"Total credits in your plan"},"used":{"type":"number","description":"Credits consumed so far"},"left":{"type":"number","description":"Remaining credits"}},"required":["total","used","left"],"additionalProperties":false},"V2Quotas":{"type":"object","properties":{"creditsConsumed":{"type":"number","description":"Credits used for this request after pricing resolution"},"workspace":{"type":"object","properties":{"id":{"type":"string","description":"Workspace identifier"},"credits":{"$ref":"#/components/schemas/V2Credits"},"hasUnlimitedCredits":{"type":"boolean","description":"Whether workspace credits are unlimited"},"allowDailyOvercost":{"type":"boolean","description":"Whether the workspace may exceed its daily cap (Enterprise only)"},"dailyLimit":{"anyOf":[{"$ref":"#/components/schemas/V2LimitInfo"},{"type":"null"}]},"minuteRateLimit":{"$ref":"#/components/schemas/V2LimitInfo"}},"required":["id","credits","hasUnlimitedCredits","allowDailyOvercost","minuteRateLimit"],"additionalProperties":false},"key":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","description":"API key identifier"},"dailyLimit":{"anyOf":[{"$ref":"#/components/schemas/V2LimitInfo"},{"type":"null"}]},"minuteRateLimit":{"$ref":"#/components/schemas/V2LimitInfo"}},"required":["id","minuteRateLimit"],"additionalProperties":false},{"type":"null"}]}},"required":["creditsConsumed","workspace","key"],"additionalProperties":false},"V2Metadata":{"type":"object","properties":{"requestId":{"type":"string","description":"Unique identifier for this request"},"executionTimeMs":{"type":"number","description":"Total execution time in milliseconds"},"updatedAt":{"type":"string","description":"Last upstream update timestamp (ISO 8601). Present only when available."}},"required":["requestId","executionTimeMs"],"additionalProperties":false},"V2Error":{"type":"object","properties":{"code":{"type":"string","description":"Machine-readable error code"},"message":{"type":"string","description":"Human-readable error description"},"details":{"type":"object","description":"Optional context","properties":{},"additionalProperties":true}},"required":["code","message"],"additionalProperties":false},"V2SuccessEnvelope":{"type":"object","properties":{"success":{"type":"boolean","const":true},"data":{},"error":{"type":"null"},"quotas":{"$ref":"#/components/schemas/V2Quotas"},"metadata":{"$ref":"#/components/schemas/V2Metadata"}},"required":["success","data","error","quotas","metadata"],"additionalProperties":false},"V2ErrorEnvelope":{"type":"object","properties":{"success":{"type":"boolean","const":false},"data":{"type":"null"},"error":{"$ref":"#/components/schemas/V2Error"},"quotas":{"$ref":"#/components/schemas/V2Quotas"},"metadata":{"$ref":"#/components/schemas/V2Metadata"}},"required":["success","data","error"],"additionalProperties":false},"PersonLocation":{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"rawLocation":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"EnrichedPersonLight":{"type":"object","description":"Light enrich shape: identity and current role. Used for data.person when the full profile could not be assembled (data.isFullProfile is false), and for an alternative candidate whose full profile could not be retrieved in time.","properties":{"id":{"type":"string","description":"Reverse Contact person id (prs_...)"},"publicId":{"type":"string","description":"Social public slug"},"linkedinUrl":{"type":"string","description":"Public Social profile URL"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentPositionTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyLinkedinId":{"anyOf":[{"type":"string"},{"type":"null"}]},"updateDate":{"anyOf":[{"type":"string","description":"Last update timestamp (ISO 8601)"},{"type":"null"}]},"location":{"anyOf":[{"$ref":"#/components/schemas/PersonLocation"},{"type":"null"}]}},"required":["id","publicId","linkedinUrl"],"additionalProperties":false},"PersonFull":{"type":"object","description":"Full person profile shape returned by fetch.","properties":{"id":{"type":"string","description":"Reverse Contact person id (prs_...)"},"publicId":{"type":"string","description":"Social public slug"},"memberId":{"type":"string","description":"Upstream member identifier when available"},"linkedinUrl":{"type":"string","description":"Public Social profile URL"},"firstName":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastName":{"anyOf":[{"type":"string"},{"type":"null"}]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"pronoun":{"anyOf":[{"type":"string"},{"type":"null"}]},"isOpenToWork":{"type":"boolean","description":"Whether the profile is flagged open to work"},"hasPremium":{"type":"boolean","description":"Whether the profile has Social Premium"},"hasVerificationBadge":{"type":"boolean","description":"Whether the profile has a verification badge"},"isInRemembrance":{"type":"boolean","description":"Whether the profile is in remembrance"},"photoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"backgroundUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"creationDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"followersCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"connectionsCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"location":{"anyOf":[{"$ref":"#/components/schemas/PersonLocation"},{"type":"null"}]},"currentPosition":{"anyOf":[{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractType":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLinkedinId":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLocation":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startEndDate":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","description":"Start date (ISO 8601)"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","description":"End date (ISO 8601), null if current"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"experience":{"type":"array","items":{"type":"object","properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractType":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLinkedinId":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLocation":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startEndDate":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","description":"Start date (ISO 8601)"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","description":"End date (ISO 8601), null if current"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}},"education":{"type":"array","items":{"type":"object","properties":{"degreeName":{"anyOf":[{"type":"string"},{"type":"null"}]},"fieldOfStudy":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"grade":{"anyOf":[{"type":"string"},{"type":"null"}]},"schoolName":{"anyOf":[{"type":"string"},{"type":"null"}]},"schoolUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"schoolLogoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"startEndDate":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"string","description":"Start date (ISO 8601)"},{"type":"null"}]},"end":{"anyOf":[{"type":"string","description":"End date (ISO 8601), null if current"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}},"skills":{"type":"array","items":{"type":"string"}},"languages":{"type":"array","items":{"type":"object","properties":{"language":{"anyOf":[{"type":"string"},{"type":"null"}]},"proficiency":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"certifications":{"type":"array","items":{"type":"object","properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"organizationName":{"anyOf":[{"type":"string"},{"type":"null"}]},"organizationUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"issuedDate":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"recommendations":{"type":"array","items":{"type":"object","properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorFullname":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}},"testScores":{"type":"array","items":{"type":"object","properties":{"testTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"score":{"anyOf":[{"type":"string"},{"type":"null"}]},"date":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}},"required":["id","publicId","linkedinUrl"],"additionalProperties":false},"EnrichedCompanyLight":{"type":"object","description":"Light company enrich shape (identity and headline metrics).","properties":{"id":{"type":"string","description":"Reverse Contact company id (com_...)"},"name":{"type":"string","description":"Company display name"},"publicId":{"type":"string","description":"Social public slug / universal name"},"linkedinId":{"anyOf":[{"type":"string"},{"type":"null"}]},"linkedinUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"employeesCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"followersCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"employeeCountRange":{"anyOf":[{"type":"object","properties":{"start":{"anyOf":[{"type":"number"},{"type":"null"}]},"end":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}]},"companyUpdateDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","name","publicId"],"additionalProperties":false},"CompanyFull":{"type":"object","description":"Full company profile shape returned by fetch.","properties":{"id":{"type":"string","description":"Reverse Contact company id (com_...)"},"companyName":{"type":"string","description":"Company display name"},"linkedinId":{"anyOf":[{"type":"string","description":"Upstream Social company id"},{"type":"null"}]},"publicId":{"type":"string","description":"Social public slug / universal name"},"linkedinUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"employeesCount":{"type":"number","description":"Employee count"},"followersCount":{"type":"number","description":"Follower count"},"employeeCountRange":{"anyOf":[{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"specialities":{"type":"array","items":{"type":"string"}},"headquarter":{"anyOf":[{"type":"object","properties":{"street1":{"anyOf":[{"type":"string"},{"type":"null"}]},"street2":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"geographicArea":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string","description":"ISO country code"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"foundedOn":{"anyOf":[{"type":"object","properties":{"year":{"type":"number"}},"additionalProperties":false},{"type":"null"}]},"locations":{"type":"array","items":{"type":"object","properties":{"street1":{"anyOf":[{"type":"string"},{"type":"null"}]},"street2":{"anyOf":[{"type":"string"},{"type":"null"}]},"postalCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string","description":"ISO country code"},{"type":"null"}]}},"additionalProperties":false}},"backgroundUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"EnrichedPersonFull":{"description":"Full person returned by enrich: the fetch profile plus the identity and current-role fields of the light shape, so a client reading either shape finds its keys.","allOf":[{"$ref":"#/components/schemas/PersonFull"},{"type":"object","properties":{"currentPositionTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyName":{"anyOf":[{"type":"string"},{"type":"null"}]},"currentCompanyLinkedinId":{"anyOf":[{"type":"string"},{"type":"null"}]},"updateDate":{"anyOf":[{"type":"string","description":"Last update timestamp (ISO 8601)"},{"type":"null"}]}},"additionalProperties":false}]},"EnrichedCompanyFull":{"description":"Full company returned by enrich: the fetch profile plus the name, update date and location fields of the light shape, so a client reading either shape finds its keys.","allOf":[{"$ref":"#/components/schemas/CompanyFull"},{"type":"object","properties":{"name":{"type":"string","description":"Company display name"},"companyUpdateDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false}]},"EnrichPersonData":{"type":"object","description":"Nested under the top-level V2 data field: response.data.person and response.data.alternativePersons.","properties":{"person":{"description":"Matched person: the full profile (data.isFullProfile true), or the light shape when the full profile could not be assembled (data.isFullProfile false).","oneOf":[{"$ref":"#/components/schemas/EnrichedPersonFull"},{"$ref":"#/components/schemas/EnrichedPersonLight"}]},"alternativePersons":{"type":"array","description":"Other candidates ranked best first, each with its full profile (it carries experience), or the light shape when its full profile could not be retrieved in time. Always an array (empty when unique).","items":{"oneOf":[{"$ref":"#/components/schemas/EnrichedPersonFull"},{"$ref":"#/components/schemas/EnrichedPersonLight"}]}},"isFullProfile":{"type":"boolean","description":"True when data.person is the full profile, false when only the light shape could be returned."}},"required":["person","alternativePersons","isFullProfile"],"additionalProperties":false},"EnrichCompanyData":{"type":"object","description":"Nested under the top-level V2 data field: response.data.company.","properties":{"company":{"description":"Matched company: the full company (data.isFullProfile true), or the light shape when the full company could not be assembled (data.isFullProfile false).","oneOf":[{"$ref":"#/components/schemas/EnrichedCompanyFull"},{"$ref":"#/components/schemas/EnrichedCompanyLight"}]},"isFullProfile":{"type":"boolean","description":"True when data.company is the full company, false when only the light shape could be returned."}},"required":["company","isFullProfile"],"additionalProperties":false},"SearchPeopleData":{"type":"object","description":"Nested envelope: results are at data.data and pagination at data.metadata (top-level data is this object).","properties":{"data":{"type":"array","description":"Full profiles returned for this page","items":{"$ref":"#/components/schemas/PersonFull"}},"metadata":{"type":"object","properties":{"perPage":{"type":"number","description":"Profiles requested per page"},"count":{"type":"number","description":"Profiles returned in this page"},"nextCursor":{"anyOf":[{"type":"string","description":"Opaque cursor for the next page"},{"type":"null"}]}},"required":["perPage","count","nextCursor"],"additionalProperties":false}},"required":["data","metadata"],"additionalProperties":false},"SearchPeoplePromptData":{"type":"object","description":"People Search page (results at data.data, pagination at data.metadata) plus the interpretation of the prompt at data.interpretation.","properties":{"data":{"type":"array","description":"Full profiles returned for this page","items":{"$ref":"#/components/schemas/PersonFull"}},"metadata":{"type":"object","properties":{"perPage":{"type":"number","description":"Profiles requested per page"},"count":{"type":"number","description":"Profiles returned in this page"},"nextCursor":{"anyOf":[{"type":"string","description":"Opaque cursor for the next page"},{"type":"null"}]}},"required":["perPage","count","nextCursor"],"additionalProperties":false},"interpretation":{"type":"object","properties":{"filters":{"$ref":"#/components/schemas/SearchPeopleFilters","description":"People Search filters read from the prompt; the page was searched with exactly these."},"warnings":{"type":"array","description":"Parts of the prompt left out of the filters, and why. Empty when everything mapped.","items":{"type":"string"}}},"required":["filters","warnings"],"additionalProperties":false}},"required":["data","metadata","interpretation"],"additionalProperties":false},"SearchCompaniesData":{"type":"object","description":"Nested envelope: results are at data.data and pagination at data.metadata (top-level data is this object).","properties":{"data":{"type":"array","description":"Matching companies for the current page","items":{"type":"object","properties":{"id":{"type":"string","description":"Reverse Contact company id"},"name":{"type":"string","description":"Company name"},"publicId":{"type":"string","description":"Social public slug"},"linkedinUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"websiteUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"industry":{"anyOf":[{"type":"string"},{"type":"null"}]},"employeesCount":{"anyOf":[{"type":"number"},{"type":"null"}]},"location":{"anyOf":[{"type":"object","properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}]},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},{"type":"null"}]}},"required":["id","name","publicId"],"additionalProperties":false}},"metadata":{"type":"object","properties":{"currentPage":{"type":"number","description":"Current page number (1-based)"},"pageNumber":{"type":"number","description":"Total number of pages"},"perPage":{"type":"number","description":"Results per page"},"total":{"type":"number","description":"Total matching results"}},"required":["currentPage","pageNumber","perPage","total"],"additionalProperties":false}},"required":["data","metadata"],"additionalProperties":false},"SearchPeopleCountData":{"type":"object","properties":{"count":{"type":"number","description":"Total profiles matching the supplied filters"}},"required":["count"],"additionalProperties":false},"CheckPersonData":{"type":"object","properties":{"exists":{"type":"boolean","description":"true if the profile exists in the database"},"lastUpdate":{"anyOf":[{"type":"string","description":"When Reverse Contact last fetched this profile (ISO 8601)"},{"type":"null"}]},"experienceCount":{"type":"number","description":"Number of experience entries when exists is true"},"skillCount":{"type":"number","description":"Number of skills when exists is true"},"schoolCount":{"type":"number","description":"Number of education entries when exists is true"}},"additionalProperties":false},"CheckCompanyData":{"type":"object","properties":{"exists":{"type":"boolean","description":"true if the company exists in the database"},"lastUpdate":{"anyOf":[{"type":"string","description":"When Reverse Contact last fetched this company (ISO 8601)"},{"type":"null"}]},"specialityCount":{"type":"number","description":"Number of company specialties when exists is true"}},"additionalProperties":false},"JobAckData":{"type":"object","description":"Immediate acknowledgement for async (live/resolve) endpoints.","properties":{"status":{"type":"string","description":"Job acknowledgement status","example":"created"},"webhookId":{"type":"string","description":"Unique job id (UUID). Poll GET /v2/webhooks/{webhookId} for the result."},"pollUrl":{"type":"string","description":"Convenience path to the polling endpoint for this job"}},"required":["webhookId"],"additionalProperties":false},"ContactEmailAckData":{"type":"object","description":"Immediate acknowledgement for the asynchronous Contact Email Finder.","properties":{"status":{"type":"string","description":"Job acknowledgement status","example":"created"},"webhookId":{"type":"string","description":"Unique job id (UUID). Poll GET /v2/webhooks/{webhookId} for the result, or use it to correlate the optional webhook callback."},"pollUrl":{"type":"string","description":"Convenience path to the polling endpoint for this job"}},"required":["status","webhookId","pollUrl"],"additionalProperties":false},"ContactPhoneAckData":{"type":"object","description":"Immediate acknowledgement for the asynchronous Contact Phone Finder.","properties":{"status":{"type":"string","description":"Job acknowledgement status","example":"created"},"webhookId":{"type":"string","description":"Unique job id (UUID). Poll GET /v2/webhooks/{webhookId} for the result, or use it to correlate the optional webhook callback."},"pollUrl":{"type":"string","description":"Convenience path to the polling endpoint for this job"}},"required":["status","webhookId","pollUrl"],"additionalProperties":false},"PollWebhookData":{"type":"object","properties":{"webhookId":{"type":"string","description":"Job identifier"},"status":{"type":"string","description":"Job status. created and in_progress are not final; succeeded and errored are.","enum":["created","in_progress","succeeded","errored"]},"eventType":{"type":"string","description":"Kind of job","enum":["FETCH_PERSON_DATA","FETCH_COMPANY_DATA","FETCH_ACTIVITY_DATA","FETCH_CONTACT_DATA"]},"errorCode":{"anyOf":[{"type":"string","description":"Why the job failed (for example email-not-found); null unless status is errored"},{"type":"null"}]},"deliveryStatus":{"anyOf":[{"type":"string","description":"Set when the result was fetched but the push to your webhookUrl failed (webhook-url-invalid, webhook-url-errored, webhook-url-timeout or webhook-url-unreachable). status stays succeeded and result stays available."},{"type":"null"}]},"createdAt":{"type":"string","description":"When the job was created (ISO 8601)","format":"date-time"},"result":{"description":"Job result: a profile object for live fetches, an array for the contact finders. Set when status is succeeded; an errored job returns the payload it stored, if any; null otherwise."},"creditsConsumed":{"type":"number","description":"Credits charged for the job, net of refunds: 0 while the job runs, final once it succeeded or errored"}},"required":["webhookId","status","eventType","errorCode","deliveryStatus","createdAt","result","creditsConsumed"],"additionalProperties":false},"SearchFieldsData":{"type":"object","properties":{"object":{"type":"string","const":"search_fields"},"entity":{"type":"string","enum":["person","company"]},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Filter field name"},"type":{"type":"string","description":"Field type"},"description":{"type":"string","description":"Human-readable description"},"allowedValues":{"description":"Optional constrained values","anyOf":[{"type":"array","items":{}},{"type":"null"}]},"properties":{"description":"Nested property metadata for object filters","anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]}},"required":["name","type"],"additionalProperties":true}}},"additionalProperties":false},"UrlOrIdPersonBody":{"type":"object","description":"Provide either url or id. If both are supplied, id takes precedence.","properties":{"url":{"type":"string","description":"Public Social profile URL","example":"https://www.linkedin.com/in/janedoe"},"id":{"type":"string","description":"Reverse Contact person id","example":"prs_01jbd5vewyenebxgaz869ffe5t"}},"additionalProperties":false},"UrlOrIdCompanyBody":{"type":"object","description":"Provide either url or id. If both are supplied, id takes precedence.","properties":{"url":{"type":"string","description":"Public Social company URL","example":"https://www.linkedin.com/company/acme-corp"},"id":{"type":"string","description":"Reverse Contact company id","example":"com_01jbd5vewyenebxgaz869ffe5t"}},"additionalProperties":false},"LivePersonBody":{"type":"object","description":"Provide exactly one of url or id.","properties":{"url":{"type":"string","description":"Public Social profile URL","example":"https://social.com/in/janedoe"},"id":{"type":"string","description":"Reverse Contact person id","example":"prs_01jbd5vewyenebxgaz869ffe5t"},"webhookUrl":{"type":"string","description":"Optional HTTPS push URL for webhook delivery","format":"uri"}},"additionalProperties":false,"oneOf":[{"required":["url"]},{"required":["id"]}],"example":{"url":"https://social.com/in/janedoe"}},"LiveCompanyBody":{"type":"object","description":"Provide exactly one of url or id.","properties":{"url":{"type":"string","description":"Public Social company URL","example":"https://social.com/company/acme-corp"},"id":{"type":"string","description":"Reverse Contact company id","example":"com_01jbd5vewyenebxgaz869ffe5t"},"webhookUrl":{"type":"string","description":"Optional HTTPS push URL for webhook delivery","format":"uri"}},"additionalProperties":false,"oneOf":[{"required":["url"]},{"required":["id"]}],"example":{"url":"https://social.com/company/acme-corp"}},"EnrichPersonBody":{"type":"object","description":"Provide at least one of: email, firstName, lastName, companyDomain, or companyName.","properties":{"email":{"type":"string","description":"Email address to enrich","format":"email"},"firstName":{"type":"string","description":"Person first name"},"lastName":{"type":"string","description":"Person last name"},"companyDomain":{"type":"string","description":"Company domain (e.g. acme.com)"},"companyName":{"type":"string","description":"Company name (alternative to domain)"},"fullProfile":{"type":"boolean","description":"Deprecated and ignored: enrich always returns the full profile. Still accepted so existing requests keep working.","deprecated":true}},"additionalProperties":false},"EnrichCompanyBody":{"type":"object","properties":{"domain":{"type":"string","description":"Company domain to resolve (e.g. acme.com)"},"fullProfile":{"type":"boolean","description":"Deprecated and ignored: enrich always returns the full profile. Still accepted so existing requests keep working.","deprecated":true}},"required":["domain"],"additionalProperties":false},"ResolvePersonEmailBody":{"type":"object","properties":{"email":{"type":"string","description":"Email address to resolve","format":"email"},"webhookUrl":{"type":"string","description":"Optional HTTPS push URL for webhook delivery","format":"uri"}},"required":["email"],"additionalProperties":false},"ResolvePersonNameBody":{"type":"object","description":"Must provide either companyDomain or companyName.","properties":{"firstName":{"type":"string","description":"Person first name"},"lastName":{"type":"string","description":"Person last name"},"companyDomain":{"type":"string","description":"Company domain (e.g. acme.com)"},"companyName":{"type":"string","description":"Company name (alternative to domain)"},"webhookUrl":{"type":"string","description":"Optional HTTPS push URL for webhook delivery","format":"uri"}},"required":["firstName","lastName"],"additionalProperties":false},"ContactEmailBody":{"type":"object","description":"Provide exactly one of: url; fullName + companyDomain; or firstName + lastName + companyDomain.","properties":{"url":{"type":"string","description":"Public LinkedIn profile URL","format":"uri","example":"https://www.linkedin.com/in/janedoe"},"fullName":{"type":"string","description":"Person full name","example":"Jane Doe"},"firstName":{"type":"string","description":"Person first name","example":"Jane"},"lastName":{"type":"string","description":"Person last name","example":"Doe"},"companyDomain":{"type":"string","description":"Company domain (e.g. acme.com)","example":"acme.com"},"webhookUrl":{"type":"string","description":"Optional HTTPS URL for the result callback","format":"uri"}},"additionalProperties":false,"oneOf":[{"required":["url"]},{"required":["fullName","companyDomain"]},{"required":["firstName","lastName","companyDomain"]}]},"ContactPhoneBody":{"type":"object","description":"Provide exactly one of: url; fullName + companyDomain; or firstName + lastName + companyDomain.","properties":{"url":{"type":"string","description":"Public LinkedIn profile URL","format":"uri","example":"https://www.linkedin.com/in/janedoe"},"fullName":{"type":"string","description":"Person full name","example":"Jane Doe"},"firstName":{"type":"string","description":"Person first name","example":"Jane"},"lastName":{"type":"string","description":"Person last name","example":"Doe"},"companyDomain":{"type":"string","description":"Company domain (e.g. acme.com)","example":"acme.com"},"webhookUrl":{"type":"string","description":"Optional HTTPS URL for the result callback","format":"uri"}},"additionalProperties":false,"oneOf":[{"required":["url"]},{"required":["fullName","companyDomain"]},{"required":["firstName","lastName","companyDomain"]}]},"ResolveCompanyBody":{"type":"object","properties":{"domain":{"type":"string","description":"Company domain (e.g. example.com)"},"webhookUrl":{"type":"string","description":"Optional HTTPS push URL for webhook delivery","format":"uri"}},"required":["domain"],"additionalProperties":false},"SearchPeopleFilters":{"type":"object","properties":{"firstName":{"type":"string","description":"Filter by first name","minLength":1},"lastName":{"type":"string","description":"Filter by last name","minLength":1},"headline":{"type":"string","description":"Match text in the profile headline","minLength":1},"isOpenToWork":{"type":"boolean","description":"Restrict to profiles flagged open to work"},"isCurrentlyEmployed":{"type":"boolean","description":"Filter by whether a profile has a current employer"},"isPremium":{"type":"boolean","description":"Restrict to Social Premium members"},"isVerified":{"type":"boolean","description":"Restrict to profiles with a verification badge"},"followersCount":{"type":"object","properties":{"min":{"type":"number","description":"Minimum followers, inclusive","minimum":0,"maximum":1000000000},"max":{"type":"number","description":"Maximum followers, inclusive","minimum":0,"maximum":1000000000}},"additionalProperties":false},"positionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past position title"},"excludePositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past position title to exclude"},"companyName":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company name"},"excludeCompanyName":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company name to exclude"},"companyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company industry from the published taxonomy"},"excludeCompanyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company industry to exclude"},"companyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company com_ id"},"excludeCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company com_ id to exclude"},"companyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company Social identifier"},"excludeCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company Social identifier to exclude"},"companyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company public id or slug"},"excludeCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company public id or slug to exclude"},"currentPositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current position title only"},"excludeCurrentPositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current position title to exclude"},"currentCompanyName":{"type":"string","description":"Current employer name","minLength":1},"excludeCurrentCompanyName":{"type":"string","description":"Current employer name to exclude","minLength":1},"currentCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer com_ id"},"excludeCurrentCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer com_ id to exclude"},"currentCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer Social identifier"},"excludeCurrentCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer Social identifier to exclude"},"currentCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer public id or slug"},"excludeCurrentCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer public id or slug to exclude"},"currentCompanyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer industry from the published taxonomy"},"currentCompanyEmployeeCountRange":{"type":"object","properties":{"min":{"type":"number","description":"Minimum current-employer size","minimum":0,"maximum":1000000000},"max":{"type":"number","description":"Maximum current-employer size","minimum":0,"maximum":1000000000}},"additionalProperties":false},"currentFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current function taxonomy value"},"excludeCurrentFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current function taxonomy value to exclude"},"currentSubFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current sub-function taxonomy value"},"excludeCurrentSubFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current sub-function taxonomy value to exclude"},"currentSeniority":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current seniority taxonomy value"},"excludeCurrentSeniority":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current seniority taxonomy value to exclude"},"totalExperienceMonths":{"type":"object","properties":{"min":{"type":"number","description":"Minimum total career length in months","minimum":0,"maximum":1200},"max":{"type":"number","description":"Maximum total career length in months","minimum":0,"maximum":1200}},"additionalProperties":false},"experience":{"type":"array","maxItems":10,"description":"Past-experience requirements; all entries are AND-combined","items":{"type":"object","properties":{"dimension":{"type":"string","description":"Taxonomy dimension","enum":["function","subFunction","seniority"]},"value":{"type":"string","description":"Value from the selected taxonomy","minLength":1},"minMonths":{"type":"number","description":"Minimum tenure in months","minimum":0,"maximum":720}},"required":["dimension","value"],"additionalProperties":false}},"skills":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Skill name or OR-matched skill names. Whole-value, case-insensitive match: \"Java\" does not match \"JavaScript\""},"languages":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Language name in English, or OR-matched names. These names also match their native spellings: Arabic, Bengali, Catalan, Chinese, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Mandarin, Norwegian, Polish, Portuguese, Punjabi, Romanian, Russian, Spanish, Swedish, Tagalog, Thai, Turkish, Ukrainian, Urdu, Vietnamese"},"excludeLanguages":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Language name in English, or names, to exclude. Needs a positive filter next to it"},"keywords":{"type":"string","description":"Words searched across the whole profile. Every word must appear, in any field; whole words only","minLength":1},"changedJobsWithinDays":{"type":"number","description":"Current position started within the last N days","enum":[30,60,90,120]},"email":{"type":"string","description":"Filter by email address","format":"email"},"location":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Country name (e.g. \"France\")"},"countryCode":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"ISO 3166 country code (e.g. \"FR\")"},"region":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"State or region"},"city":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"City"},"area":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Broader geographic area"}},"additionalProperties":false},"maxDataAgeDate":{"type":"string","description":"Only return profiles refreshed after this date","format":"date-time"}},"additionalProperties":false},"SearchPeopleBody":{"type":"object","properties":{"firstName":{"type":"string","description":"Filter by first name","minLength":1},"lastName":{"type":"string","description":"Filter by last name","minLength":1},"headline":{"type":"string","description":"Match text in the profile headline","minLength":1},"isOpenToWork":{"type":"boolean","description":"Restrict to profiles flagged open to work"},"isCurrentlyEmployed":{"type":"boolean","description":"Filter by whether a profile has a current employer"},"isPremium":{"type":"boolean","description":"Restrict to Social Premium members"},"isVerified":{"type":"boolean","description":"Restrict to profiles with a verification badge"},"followersCount":{"type":"object","properties":{"min":{"type":"number","description":"Minimum followers, inclusive","minimum":0,"maximum":1000000000},"max":{"type":"number","description":"Maximum followers, inclusive","minimum":0,"maximum":1000000000}},"additionalProperties":false},"positionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past position title"},"excludePositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past position title to exclude"},"companyName":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company name"},"excludeCompanyName":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company name to exclude"},"companyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company industry from the published taxonomy"},"excludeCompanyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company industry to exclude"},"companyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company com_ id"},"excludeCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company com_ id to exclude"},"companyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company Social identifier"},"excludeCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company Social identifier to exclude"},"companyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company public id or slug"},"excludeCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current or past company public id or slug to exclude"},"currentPositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current position title only"},"excludeCurrentPositionTitle":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current position title to exclude"},"currentCompanyName":{"type":"string","description":"Current employer name","minLength":1},"excludeCurrentCompanyName":{"type":"string","description":"Current employer name to exclude","minLength":1},"currentCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer com_ id"},"excludeCurrentCompanyId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer com_ id to exclude"},"currentCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer Social identifier"},"excludeCurrentCompanyLinkedinId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer Social identifier to exclude"},"currentCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer public id or slug"},"excludeCurrentCompanyPublicId":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer public id or slug to exclude"},"currentCompanyIndustry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current employer industry from the published taxonomy"},"currentCompanyEmployeeCountRange":{"type":"object","properties":{"min":{"type":"number","description":"Minimum current-employer size","minimum":0,"maximum":1000000000},"max":{"type":"number","description":"Maximum current-employer size","minimum":0,"maximum":1000000000}},"additionalProperties":false},"currentFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current function taxonomy value"},"excludeCurrentFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current function taxonomy value to exclude"},"currentSubFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current sub-function taxonomy value"},"excludeCurrentSubFunction":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current sub-function taxonomy value to exclude"},"currentSeniority":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current seniority taxonomy value"},"excludeCurrentSeniority":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Current seniority taxonomy value to exclude"},"totalExperienceMonths":{"type":"object","properties":{"min":{"type":"number","description":"Minimum total career length in months","minimum":0,"maximum":1200},"max":{"type":"number","description":"Maximum total career length in months","minimum":0,"maximum":1200}},"additionalProperties":false},"experience":{"type":"array","maxItems":10,"description":"Past-experience requirements; all entries are AND-combined","items":{"type":"object","properties":{"dimension":{"type":"string","description":"Taxonomy dimension","enum":["function","subFunction","seniority"]},"value":{"type":"string","description":"Value from the selected taxonomy","minLength":1},"minMonths":{"type":"number","description":"Minimum tenure in months","minimum":0,"maximum":720}},"required":["dimension","value"],"additionalProperties":false}},"skills":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Skill name or OR-matched skill names. Whole-value, case-insensitive match: \"Java\" does not match \"JavaScript\""},"languages":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Language name in English, or OR-matched names. These names also match their native spellings: Arabic, Bengali, Catalan, Chinese, Czech, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Hungarian, Indonesian, Italian, Japanese, Korean, Mandarin, Norwegian, Polish, Portuguese, Punjabi, Romanian, Russian, Spanish, Swedish, Tagalog, Thai, Turkish, Ukrainian, Urdu, Vietnamese"},"excludeLanguages":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Language name in English, or names, to exclude. Needs a positive filter next to it"},"keywords":{"type":"string","description":"Words searched across the whole profile. Every word must appear, in any field; whole words only","minLength":1},"changedJobsWithinDays":{"type":"number","description":"Current position started within the last N days","enum":[30,60,90,120]},"email":{"type":"string","description":"Filter by email address","format":"email"},"location":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Country name (e.g. \"France\")"},"countryCode":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"ISO 3166 country code (e.g. \"FR\")"},"region":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"State or region"},"city":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"City"},"area":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Broader geographic area"}},"additionalProperties":false},"maxDataAgeDate":{"type":"string","description":"Only return profiles refreshed after this date","format":"date-time"},"cursor":{"type":"string","description":"Opaque cursor returned in metadata.nextCursor","minLength":1},"perPage":{"type":"number","description":"Results per page (1-100, default 25)","minimum":1,"maximum":100,"default":25}},"additionalProperties":false,"example":{"currentFunction":"Sales","currentSeniority":["Director","VP"],"location":{"countryCode":"FR"},"perPage":25}},"SearchPeoplePromptBody":{"type":"object","properties":{"prompt":{"type":"string","description":"Plain-language description of the people to find, in any language: at least 3 characters and at most 1000 tokens (about 4000 characters of English text)","minLength":3},"cursor":{"type":"string","description":"Opaque cursor returned in metadata.nextCursor. Send it with the same prompt: it only works with the filters that produced it.","minLength":1},"perPage":{"type":"number","description":"Results per page (1-100, default 25)","minimum":1,"maximum":100,"default":25}},"required":["prompt"],"additionalProperties":false,"example":{"prompt":"VP Sales in Paris at software companies with 50 to 200 employees","perPage":25}},"SearchPeopleLookalikeBody":{"type":"object","properties":{"url":{"type":"string","description":"Public Social profile URL of the seed. Required unless id is given.","example":"https://www.linkedin.com/in/janedoe"},"id":{"type":"string","description":"Reverse Contact person id of the seed (prs_...), as returned in the id field of any person response. Required unless url is given.","pattern":"^prs_[A-Za-z0-9]+$","example":"prs_01jbd5vewyenebxgaz869ffe5t"},"cursor":{"type":"string","description":"Opaque cursor returned in metadata.nextCursor. Send it with the same seed.","minLength":1},"perPage":{"type":"number","description":"Results per page (1-100, default 25)","minimum":1,"maximum":100,"default":25}},"additionalProperties":false,"description":"Provide exactly one seed, url or id. Search filters are refused: the criteria come from the seed.","oneOf":[{"required":["url"]},{"required":["id"]}],"example":{"url":"https://www.linkedin.com/in/janedoe","perPage":25}},"SearchPeopleCountBody":{"$ref":"#/components/schemas/SearchPeopleFilters"},"SearchCompaniesBody":{"type":"object","properties":{"companyName":{"type":"string","description":"Company name filter"},"companyDomain":{"type":"string","description":"Company domain filter"},"industry":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}],"description":"Industry name or array of industries. Matched exactly against the published taxonomy (see docs.reversecontact.com/guides/industries); an unlisted value is rejected with 422 INVALID_FILTER_VALUE and suggestions."},"employeeCountRange":{"type":"object","properties":{"min":{"type":"number","description":"Minimum employees, inclusive","minimum":0},"max":{"type":"number","description":"Maximum employees, inclusive","minimum":0}},"additionalProperties":false},"location":{"type":"object","properties":{"country":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"countryCode":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"region":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]},"city":{"oneOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}},"additionalProperties":false},"maxDataAgeDate":{"type":"string","description":"ISO 8601 datetime. Only returns companies refreshed after this date","format":"date-time"},"page":{"type":"number","description":"Page number (1-50, default 1)","minimum":1,"maximum":50,"default":1},"perPage":{"type":"number","description":"Results per page (1-100, default 100)","minimum":1,"maximum":100,"default":100}},"additionalProperties":false,"example":{"companyName":"Acme","companyDomain":"acme.com","industry":"Software Development","employeeCountRange":{"min":51,"max":200},"location":{"country":"France","countryCode":"FR","city":"Paris"},"maxDataAgeDate":"2026-01-31T00:00:00Z","page":1,"perPage":100}}}},"security":[{"bearerAuth":[]}]}