> ## Documentation Index > Fetch the complete documentation index at: https://docs.generect.com/llms.txt > Use this file to discover all available pages before exploring further. # Get bulk lead enrich job ## Use Case: Check the status and retrieve results for a bulk lead enrich job. ## Pricing This endpoint is free — it does not incur any charges. ## OpenAPI ````yaml get /api/v1/enrich/leads/bulk/{job_id}/ openapi: 3.0.3 info: title: Generect API description: >- Welcome to the Generect API documentation. Here we will help you integrate and use our API. API base url: `https://api.generect.com` — every path below is relative to this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under `/api/...`; use each path exactly as documented. Protocol: `HTTPS` # Authentication Get your API token from the Generect app settings and send it in the `Authorization` header with the required `Token` prefix. Example: `Authorization: Token xxxxxxxxx` # Rate limits You can request data depending on your data plan and account balance (default: 10000/month). Pricing depends on the operation and the number of results returned, and may increase with additional data flags. For exact pricing, see each endpoint's Pricing section or your billing settings: https://beta.generect.com/settings/billing # Note _Every endpoint must include the trailing `/`. Requests without the trailing slash may fail._ version: 1.0.0 contact: {} servers: - url: https://api.generect.com security: - apiKey: [] tags: - name: 1. Auth description: Login and get user info - name: 2. Transactions description: List of latest transactions in your account - name: 3. Leads description: Fetch information about leads by _link/name/ICP_. - name: 4. Companies description: Fetch information about companies by link/name/ICP. - name: 5. Preview description: Search masked database leads for preview and reveal workflows. - name: 6. Enrich description: Enrich leads and companies by internal or external identifiers. - name: 7. Email description: Find and validate email addresses. - name: 8. Accounts description: Account profile, usage, and transactions. - name: 9. Search description: Database and realtime lead, company, and company-lead search. - name: 10. Phone description: Find phone numbers for leads. - name: 11. Webhooks description: Register and manage async job notifications. paths: /api/v1/enrich/leads/bulk/{job_id}/: get: tags: - 6. Enrich summary: Get bulk lead enrich job parameters: - name: job_id in: path required: true schema: type: string example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: Bulk job status and results content: application/json: schema: $ref: '#/components/schemas/BulkStatusResponse' example: data: - input: linkedin_url: https://www.linkedin.com/in/jordan-ellis lead: id: ACwAAAE9bk0BxY7Qf2mN4pR8sT1vW3zA5cE6gH9 linkedin_id: '78461298' first_name: Jordan last_name: Ellis full_name: Jordan Ellis headline: CEO at Microsoft job_title: Chief Executive Officer company_name: Microsoft company_industry: Software Development linkedin_company_id: '1035' linkedin_url: https://www.linkedin.com/in/jordan-ellis location: San Francisco, California, United States location_country: United States gender: male is_premium: true jobs: - company_name: Microsoft job_title: Chief Executive Officer job_started_on: '2014-02-01' job_still_working: true educations: [] languages: [] source: lead_by_link - input: id: ACwAAAFp2r4Bd1eF3gH5iJ7kL9mN0pQ2rS4tU6v lead: null meta: job_id: 7c9e6679-7425-40de-944b-e07fc1f90ae7 status: completed total: 2 processed: 2 found: 1 not_found: 1 amount_charged: 0.04 error: null '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: Job not found. content: application/json: schema: type: object properties: detail: type: string example: detail: Job not found components: schemas: BulkStatusResponse: type: object properties: data: type: array nullable: true description: Result items once status is completed; null until then. items: type: object meta: $ref: '#/components/schemas/BulkJobMeta' BulkJobMeta: type: object description: >- Bulk job state. Poll the bulk status endpoint with job_id or subscribe to the completion webhook. required: - job_id - status - total - processed - amount_charged properties: job_id: type: string description: Job identifier — pass it to the bulk status endpoint. status: type: string enum: - pending - processing - completed - error total: type: integer description: Number of submitted items. processed: type: integer description: Items processed so far. found: type: integer description: >- Items that resolved to a result (present on status/webhook once completed). not_found: type: integer description: Items with no result — not charged (No Data, No Charge). amount_charged: type: number description: USD charged for found results; final when status is completed. error: type: string nullable: true description: Failure reason when status is error. Error: type: object description: Standard error envelope returned for 4xx/5xx responses. properties: status: type: string example: error status_code: type: integer example: 400 detail: description: >- Human-readable message (string) for most errors, or a field-level validation map ({ field: [messages] }) for 400 validation errors. example: Insufficient funds in the account. responses: Unauthorized: description: Missing or invalid API token. content: application/json: schema: $ref: '#/components/schemas/Error' example: status: error status_code: 401 detail: Authentication credentials were not provided. Forbidden: description: Authenticated, but the account/plan is not allowed to use this endpoint. content: application/json: schema: $ref: '#/components/schemas/Error' example: status: error status_code: 403 detail: You do not have permission to perform this action. securitySchemes: apiKey: type: apiKey in: header name: Authorization description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx' ````