> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Limadata: Batch Results > Poll the status and paginated results (page size 100) of a Limadata v2 batch job by batch_id, including limadata_batch_ad_audiences jobs. Poll the status and paginated results (page size 100) of a Limadata v2 batch job by batch\_id, including limadata\_batch\_ad\_audiences jobs. Tool ID: `limadata_batch_results` ## Run this action Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV. ```ts theme={null} import { Deepline } from 'deepline'; const deepline = await Deepline.connect(); const result = await deepline.tools.execute( 'limadata_batch_results', { "batch_id": 123 }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute limadata_batch_results --input '{ "batch_id": 123 }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "data": { "batch_id": 123, "name": "Example", "type": "Unknown" } } ``` Use `deepline tools get limadata_batch_results --json` for the latest machine-readable contract. ## Input reference Retrieve the status and paginated results of a batch job. #### Status Values: - `pending`: Job is queued but not yet started - `processing`: Job is currently running - `completed`: Job finished successfully, results available - `failed`: Job failed, see error details - `cancelled`: Job was cancelled #### Pagination: - Page size is 100 items - Use the `page` query parameter to navigate through results (1-indexed) - Response includes pagination metadata (total pages, has next/previous page, etc.) #### Response: - Returns batch operation status and progress information - Includes paginated list of batch items with their results - Each item will contain a data field with the JSON output of the requested operation - Results expire and are deleted from our servers after 30 days #### Result Storage: Results expire and are deleted from our servers after 30 days. #### Polling recommendation: We See the live schema below for the complete notes. | Name | Type | Required | Default | Details | | ------------------ | --------- | -------- | ------- | ---------------------------------------------------- | | `payload.batch_id` | `integer` | Yes | — | Format: `int64`. | | `payload.page` | `integer` | No | — | Page number (1-indexed, default: 1) Format: `int32`. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "Retrieve the status and paginated results of a batch job. #### Status Values: - `pending`: Job is queued but not yet started - `processing`: Job is currently running - `completed`: Job finished successfully, results available - `failed`: Job failed, see error details - `cancelled`: Job was cancelled #### Pagination: - Page size is 100 items - Use the `page` query parameter to navigate through results (1-indexed) - Response includes pagination metadata (total pages, has next/previous page, etc.) #### Response: - Returns batch operation status and progress information - Includes paginated list of batch items with their results - Each item will contain a data field with the JSON output of the requested operation - Results expire and are deleted from our servers after 30 days #### Result Storage: Results expire and are deleted from our servers after 30 days. #### Polling recommendation: We recommend polling this endpoint to check the status of your batch and retrieve results as they are populated. You do not need to wait for the batch to complete before starting to pull results. We recommend polling once every 60 seconds. #### Credits: This endpoint does not charge any credits.", "properties": { "batch_id": { "type": "integer", "format": "int64" }, "page": { "type": [ "integer", "null" ], "description": "Page number (1-indexed, default: 1)", "format": "int32" } }, "required": [ "batch_id" ], "additionalProperties": false } ```
## Output reference Standard tool result payload. | Name | Type | Required | Default | Details | | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `result.data` | `object` | Yes | — | Provider response payload. | | `result.data.batch_id` | `integer` | No | — | Format: `int64`. | | `result.data.name` | `string \| null` | No | — | — | | `result.data.type` | `"Unknown" \| "ProspectPeople" \| "ProspectCompanies" \| "BulkPeopleProfiles" \| "BulkCompanyProfiles" \| "PostEngagements" \| "EmailVerification" \| "AdAudiences"` | No | — | Allowed: `Unknown`, `ProspectPeople`, `ProspectCompanies`, `BulkPeopleProfiles`, `BulkCompanyProfiles`, `PostEngagements`, `EmailVerification`, `AdAudiences`. | | `result.data.status` | `string \| null` | No | — | — | | `result.data.requested_entity_count` | `integer` | No | — | Format: `int32`. | | `result.data.processed_entity_count` | `integer` | No | — | Format: `int32`. | | `result.data.status_url` | `string \| null` | No | — | — | | `result.data.pagination` | `object \| null` | No | — | — | | `result.data.pagination.page` | `integer` | No | — | Format: `int32`. | | `result.data.pagination.page_size` | `integer` | No | — | Format: `int32`. | | `result.data.pagination.total_items` | `integer` | No | — | Format: `int32`. | | `result.data.items` | `array \| null` | No | — | — | | `result.data.items[].id` | `integer` | No | — | Format: `int64`. | | `result.data.items[].status` | `string \| null` | No | — | — | | `result.data.items[].request` | `string \| null` | No | — | — | | `result.data.items[].data` | `object \| null` | No | — | — | | `result.data.items[].data.options` | `object \| null` | No | — | — | | `result.data.items[].data.options.property_name_case_insensitive` | `boolean` | No | — | — | | `result.data.items[].data.parent` | `object \| null` | No | — | Recursive OpenAPI schema reference #/components/schemas/JsonNode. | | `result.data.items[].data.root` | `record` | No | — | Recursive OpenAPI schema reference #/components/schemas/JsonNode. | | `result.meta` | `object` | No | — | Additional response metadata (status, paging). |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "description": "Standard tool result payload.", "properties": { "data": { "type": "object", "description": "Provider response payload.", "properties": { "batch_id": { "type": "integer", "format": "int64" }, "name": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "Unknown", "ProspectPeople", "ProspectCompanies", "BulkPeopleProfiles", "BulkCompanyProfiles", "PostEngagements", "EmailVerification", "AdAudiences" ] }, "status": { "type": [ "string", "null" ] }, "requested_entity_count": { "type": "integer", "format": "int32" }, "processed_entity_count": { "type": "integer", "format": "int32" }, "status_url": { "type": [ "string", "null" ] }, "pagination": { "type": [ "object", "null" ], "properties": { "page": { "type": "integer", "format": "int32" }, "page_size": { "type": "integer", "format": "int32" }, "total_items": { "type": "integer", "format": "int32" } }, "additionalProperties": false }, "items": { "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": "integer", "format": "int64" }, "status": { "type": [ "string", "null" ] }, "request": { "type": [ "string", "null" ] }, "data": { "type": [ "object", "null" ], "properties": { "options": { "type": [ "object", "null" ], "properties": { "property_name_case_insensitive": { "type": "boolean" } }, "additionalProperties": false }, "parent": { "type": [ "object", "null" ], "description": "Recursive OpenAPI schema reference #/components/schemas/JsonNode.", "additionalProperties": true }, "root": { "type": "object", "description": "Recursive OpenAPI schema reference #/components/schemas/JsonNode.", "additionalProperties": true } }, "additionalProperties": false } }, "additionalProperties": false } } }, "additionalProperties": false }, "meta": { "type": "object", "description": "Additional response metadata (status, paging).", "additionalProperties": true } }, "required": [ "data" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `fixed` (per call). * Estimated Deepline credits: `0` per pricing unit. * Provider-native pricing may still exist outside Deepline credit billing. ## Related documentation * [Limadata provider guide](/docs/providers/limadata/guide) * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)