> ## Documentation Index > Fetch the complete documentation index at: https://docs.lonescale.com/llms.txt > Use this file to discover all available pages before exploring further. # Search Contacts (Sync) > Search contacts synchronously and return results directly in the response — no webhook required. The response contains all sourced contacts in a single call. **Maximum 10 contacts per request.** Rate limited to **5 requests per minute**. ## OpenAPI ````yaml POST /trigger/contact-sourcing/sync openapi: 3.1.0 info: title: OpenAPI Lonescale description: A sample API for Lonescale license: name: MIT version: 1.0.0 servers: - url: https://public-api.lonescale.com security: - ApiKeyAuth: [] paths: /trigger/contact-sourcing/sync: post: description: >- Search contacts synchronously and return results directly in the response — no webhook required. The response contains all sourced contacts in a single call. **Maximum 10 contacts per request.** Rate limited to **5 requests per minute**. requestBody: content: application/json: schema: $ref: '#/components/schemas/ContactSourcingSyncRequest' required: true responses: '200': description: Contacts sourced successfully content: application/json: schema: $ref: '#/components/schemas/ContactSourcingSyncResponse' '400': description: Invalid input content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Bad request error: Bad request statusCode: 400 '401': description: Invalid or missing authentication credentials content: application/json: schema: $ref: '#/components/schemas/AuthError' example: message: Invalid API Key error: Unauthorized statusCode: 401 '403': description: Insufficient contact credits or admin not found content: application/json: schema: $ref: '#/components/schemas/Error' example: message: User has no contact credits error: Forbidden statusCode: 403 '429': description: Rate limit exceeded — max 5 requests per minute content: application/json: schema: $ref: '#/components/schemas/Error' example: message: 'ThrottlerException: Too Many Requests' error: Too Many Requests statusCode: 429 components: schemas: ContactSourcingSyncRequest: type: object additionalProperties: false required: - personas properties: company_domain: type: string description: Company domain or website to search contacts from. company_name: type: string description: Company name to search contacts from. company_linkedin_url: type: string description: >- Company LinkedIn URL used to search contacts, increasing result coverage and accuracy by 25%. personas: type: array description: Personas to use to search and filter contacts within the company. items: $ref: '#/components/schemas/Persona' minItems: 1 included_locations: type: array description: List of country codes (ISO 3166-1 alpha-2) to include in the search. items: $ref: '#/components/schemas/CountryCode' limit: type: number description: Maximum number of contacts to retrieve. Capped at 10. maximum: 10 seniority_levels: type: array description: List of seniority levels to filter contacts by. items: $ref: '#/components/schemas/SeniorityCategory' disable_company_info: type: boolean description: >- Disable enrichment of company information for each contact, such as industry, size, etc. custom: $ref: '#/components/schemas/EnrichmentCustomOptions' example: company_name: Acme Corp company_domain: acme.com company_linkedin_url: https://www.linkedin.com/company/acme personas: - name: Tech Leaders job_titles: - CTO - VP Engineering limit: 5 custom: id: '12356' provider: lonescale ContactSourcingSyncResponse: type: object properties: contacts: type: array description: List of sourced contacts. items: type: object properties: lonescale_full_name: type: string lonescale_first_name: type: string lonescale_last_name: type: string lonescale_linkedin_url: type: string lonescale_job_title: type: string lonescale_job_seniority: type: string lonescale_department: type: string lonescale_country_code: type: string lonescale_geo_country_name: type: string lonescale_geo_location_name: type: string lonescale_city: type: string lonescale_company_name: type: string lonescale_company_domain: type: string lonescale_company_linkedin_url: type: string lonescale_company_linkedin_id: type: string lonescale_universal_name: type: string lonescale_company_industry: type: string lonescale_company_country: type: string lonescale_company_country_code: type: string lonescale_company_staff_count: type: integer lonescale_company_employee_range: type: string lonescale_company_city: type: string client_company_name: type: string client_company_domain: type: string client_company_linkedin_url: type: string custom: type: object additionalProperties: true description: Custom fields passed in the request. profiles_found: type: integer description: Total number of contacts found. example: contacts: - lonescale_full_name: Jane Doe lonescale_first_name: Jane lonescale_last_name: Doe lonescale_linkedin_url: https://www.linkedin.com/in/janedoe lonescale_job_title: CTO lonescale_job_seniority: C_SUITE lonescale_country_code: US lonescale_geo_country_name: United States lonescale_company_name: Acme Corp lonescale_company_domain: acme.com lonescale_company_industry: Software lonescale_company_staff_count: 250 client_company_name: Acme Corp client_company_domain: acme.com profiles_found: 1 Error: required: - error - message type: object properties: error: type: integer format: int32 message: type: string AuthError: required: - message - error - statusCode type: object properties: message: type: string example: Invalid API Key error: type: string example: Unauthorized statusCode: type: integer example: 401 Persona: type: object additionalProperties: false required: - job_titles - name properties: name: type: string job_titles: type: array items: type: string exclude_job_titles: type: array items: type: string CountryCode: type: string description: ISO 3166-1 alpha-2 country code isEnum: true enum: - AF - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CD - CG - CK - CR - HR - CU - CW - CY - CZ - CI - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - MK - RO - RU - RW - RE - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - AX SeniorityCategory: type: string description: Seniority level of a contact. enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern EnrichmentCustomOptions: type: object additionalProperties: true properties: id: type: string description: >- Unique ID of the record from the CRM, database, or other source system. provider: type: string description: Downstream data provider to use (e.g., Lonescale). enrichment_type: type: string description: Provider-specific enrichment mode. example: phone securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Provide your API key in the x-api-key header. ````