> ## Documentation Index > Fetch the complete documentation index at: https://docs.runpulse.com/llms.txt > Use this file to discover all available pages before exploring further. # Run Tables > Merge a completed parse's tables across pages and return each in the formats you ask for. Send the parse's `parse_id` with `config` or a saved `config_id`. It costs 0.5 credits per table returned. By default, the call waits for the job to end. With `async: true`, it returns `202` at once. Read the tables at `GET /tables/{tables_id}/result`. Tables must be enabled for your organization. ## OpenAPI ````yaml /api-reference/v2/openapi.yml post /tables openapi: 3.1.0 info: title: Pulse API description: >- Agentic document infrastructure for the enterprise. The Pulse API turns complex documents into AI-ready data, such as Markdown, structured JSON and bounding boxes. version: '2' servers: - url: https://api.runpulse.com description: Default Pulse API base URL security: [] tags: - name: Parse description: Parse a document's text, tables and figures. - name: Batch parse description: Parse many documents with one config. - name: Extract description: Extract structured data from a parsed document. - name: Split description: Find each topic's pages in a parsed document. - name: Tables description: Merge a parsed document's tables across pages. - name: Charts description: Read the charts in a parsed document. - name: Classify description: Sort a document into the categories you define. - name: Pipeline description: Run a parse and its follow-on steps as one job. - name: Usage description: Check the pages and credits your organization has used. - name: Webhook description: Get notified when your organization's jobs change status. - name: Organization settings description: Read and change your organization's name, address and default API version. paths: /tables: post: tags: - Tables summary: Run Tables description: >- Merge a completed parse's tables across pages and return each in the formats you ask for. Send the parse's `parse_id` with `config` or a saved `config_id`. It costs 0.5 credits per table returned. By default, the call waits for the job to end. With `async: true`, it returns `202` at once. Read the tables at `GET /tables/{tables_id}/result`. Tables must be enabled for your organization. operationId: extractTables parameters: - name: Pulse-Version in: header required: false schema: type: string default: '2' title: Pulse-Version examples: default: value: '2' requestBody: required: true content: application/json: schema: description: A request to merge the tables of a completed parse. title: TableRequest oneOf: - title: Inline config additionalProperties: false type: object properties: parse_id: description: >- The `parse_id` of a completed parse whose result hasn't expired. minLength: 1 title: Parse Id type: string config: $ref: '#/components/schemas/TableConfig' description: This request's options. async: default: false description: >- Set to `true` to return `202` at once instead of waiting. title: Async type: boolean required: - parse_id - config - title: Saved config additionalProperties: false type: object properties: parse_id: description: >- The `parse_id` of a completed parse whose result hasn't expired. minLength: 1 title: Parse Id type: string async: default: false description: >- Set to `true` to return `202` at once instead of waiting. title: Async type: boolean config_id: description: A saved config's id, sent in place of `config`. title: Config Id type: string required: - parse_id - config_id responses: '200': description: >- The job completed. Read its tables at `GET /tables/{tables_id}/result`. content: application/json: schema: $ref: '#/components/schemas/TableSyncResponse' '202': description: >- The job started (`async: true`). Check `GET /tables/{tables_id}` until it ends. content: application/json: schema: $ref: '#/components/schemas/TableAsyncResponse' '400': description: >- [`REQUEST_INVALID`](https://docs.runpulse.com/errors/request-invalid): the body isn't a JSON object, has a field or value it doesn't take, or sends both or neither of `config` and `config_id`, or the URL has a query parameter. [`RESOURCE_UNUSABLE`](https://docs.runpulse.com/errors/resource-unusable): the parse was made with API version 1 (`reason`: `api_version_1`) or saved in an older format (`older_format`). [`PAGE_RANGE_INVALID`](https://docs.runpulse.com/errors/page-range-invalid): `page_range` names a page past the parse's last page. `Pulse-Version` names a version this API doesn't serve ([`UNSUPPORTED_VERSION`](https://docs.runpulse.com/errors/unsupported-version)). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - REQUEST_INVALID - RESOURCE_UNUSABLE - PAGE_RANGE_INVALID - UNSUPPORTED_VERSION '401': description: >- [`CREDENTIALS_INVALID`](https://docs.runpulse.com/errors/credentials-invalid): the API key is missing or not valid. [`API_KEY_INACTIVE`](https://docs.runpulse.com/errors/api-key-inactive): the API key is inactive; create a new one. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - CREDENTIALS_INVALID - API_KEY_INACTIVE '402': description: >- Your plan needs a payment first: [`PAYMENT_REQUIRED`](https://docs.runpulse.com/errors/payment-required) (payment required, or your organization pays per request, which API version 2 doesn't support), [`PAYMENT_FAILED`](https://docs.runpulse.com/errors/payment-failed) (a payment failed), [`PAYMENT_AUTHENTICATION_REQUIRED`](https://docs.runpulse.com/errors/payment-authentication-required) (a payment needs authentication), [`SUBSCRIPTION_PAST_DUE`](https://docs.runpulse.com/errors/subscription-past-due) (the subscription is past due), [`PLAN_LIMIT_REACHED`](https://docs.runpulse.com/errors/plan-limit-reached) (the plan's or free tier's limit is reached), [`TRIAL_EXPIRED`](https://docs.runpulse.com/errors/trial-expired) (trial expired), [`CREDIT_LIMIT_EXCEEDED`](https://docs.runpulse.com/errors/credit-limit-exceeded) (your plan's or API key's credit limit is reached) or [`SUBSCRIPTION_CANCELED`](https://docs.runpulse.com/errors/subscription-canceled) (subscription canceled). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - PAYMENT_REQUIRED - PAYMENT_FAILED - PAYMENT_AUTHENTICATION_REQUIRED - SUBSCRIPTION_PAST_DUE - PLAN_LIMIT_REACHED - TRIAL_EXPIRED - CREDIT_LIMIT_EXCEEDED - SUBSCRIPTION_CANCELED '403': description: >- [`ACCOUNT_SUSPENDED`](https://docs.runpulse.com/errors/account-suspended): your account is suspended. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - ACCOUNT_SUSPENDED '404': description: >- [`RESOURCE_NOT_FOUND`](https://docs.runpulse.com/errors/resource-not-found): `parse_id` names no parse of your organization, or one that was deleted, or `config_id` no config you saved for `/tables`; `errors` names the field. No endpoint answers this path ([`ROUTE_NOT_FOUND`](https://docs.runpulse.com/errors/route-not-found)). content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - RESOURCE_NOT_FOUND - ROUTE_NOT_FOUND '409': description: >- [`JOB_ALREADY_ENDED`](https://docs.runpulse.com/errors/job-already-ended): the job was canceled before it finished. [`JOB_NOT_FINISHED`](https://docs.runpulse.com/errors/job-not-finished): another run of it is finishing, so poll `GET /tables/{tables_id}`; or `parse_id` names a parse that hasn't completed yet. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - JOB_ALREADY_ENDED - JOB_NOT_FINISHED '410': description: >- [`RESULT_EXPIRED`](https://docs.runpulse.com/errors/result-expired): the parse's result has expired. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - RESULT_EXPIRED '500': description: >- [`PROCESSING_FAILED`](https://docs.runpulse.com/errors/processing-failed): processing failed, for example the tables couldn't be saved. [`SERVER_ERROR`](https://docs.runpulse.com/errors/server-error): an unexpected error, such as saved configs that couldn't be read. [`JOB_UNREADABLE`](https://docs.runpulse.com/errors/job-unreadable): Pulse can't read this job right now; don't retry, contact support. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string x-pulse-errors: - PROCESSING_FAILED - SERVER_ERROR - JOB_UNREADABLE '503': description: >- [`SERVICE_UNAVAILABLE`](https://docs.runpulse.com/errors/service-unavailable): a service the request needs couldn't be reached (to check your API key or billing, or to read the parse or a saved config), or the job couldn't be started; retry. If the error includes `tables_id`, the result may be saved: poll `GET /tables/{tables_id}` instead of submitting the job again. On a self-hosted deployment, also [`LICENSE_INVALID`](https://docs.runpulse.com/errors/license-invalid) or [`LICENSE_NOT_ACTIVATED`](https://docs.runpulse.com/errors/license-not-activated): its license is invalid or expired, or it isn't activated yet. [`CAPACITY_EXCEEDED`](https://docs.runpulse.com/errors/capacity-exceeded), with `async: true` only: too many jobs are running to start this one, so it was canceled; retry after the seconds in `Retry-After`. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' application/json: schema: $ref: '#/components/schemas/Problem' headers: X-Request-Id: description: The request's id; the problem's `request_id`. schema: type: string Retry-After: description: Seconds to wait before retrying. schema: type: string x-pulse-errors: - SERVICE_UNAVAILABLE - LICENSE_INVALID - LICENSE_NOT_ACTIVATED - CAPACITY_EXCEEDED security: - ApiKey: [] components: schemas: TableConfig: additionalProperties: false description: Options for merging a parse's tables. properties: format: anyOf: - const: all type: string - items: enum: - html - json - md type: string type: array default: - html description: >- `html` returns the table's HTML, `json` its headers and rows as text, and `md` a Markdown table. `all` returns all three. title: Format page_range: description: >- The parse result's pages to take tables from, listed as numbers and ranges from 1, such as `1-3, 6, 8-end` (`end` is the last page). Defaults to every page. Tables merge only within these pages. pattern: ^ *[0-9]+ *(- *([0-9]+|end) *)?(, *[0-9]+ *(- *([0-9]+|end) *)?)*$ title: Page Range type: string title: TableConfig { format, page_range } type: object TableSyncResponse: properties: tables_id: type: string title: Tables Id description: The tables job's id, `tables-`. created_at: type: string title: Created At description: When the job was created. completed_at: type: string title: Completed At description: When the job ended. expires_at: type: string title: Expires At description: >- When the result will be deleted. Absent when the result is kept with no expiry. additionalProperties: false type: object required: - tables_id - created_at - completed_at title: TableSyncResponse description: >- A completed tables job. Read its tables at `GET /tables/{tables_id}/result`. TableAsyncResponse: properties: tables_id: type: string title: Tables Id description: The tables job's id, `tables-`. created_at: type: string title: Created At description: When the job was created. additionalProperties: false type: object required: - tables_id - created_at title: TableAsyncResponse description: >- A tables job that has started. Check `GET /tables/{tables_id}` until it ends. Problem: additionalProperties: false description: >- Why the request or the job failed. Branch on `code`; quote `request_id` to support. properties: type: description: 'This code''s page: what it means and what to do.' title: Type type: string title: description: A short summary of the code, the same for every occurrence. title: Title type: string status: description: The HTTP status the code answers with. title: Status type: integer detail: description: What happened this time. title: Detail type: string instance: description: 'This occurrence: the request''s URN, `urn:pulse:request:`.' title: Instance type: string code: description: The stable error code, e.g. `REQUEST_INVALID`. Branch on it. title: Code type: string request_id: description: >- The request that failed, as `X-Request-Id` named it; for a failed job, the request that created it. Quote it to support. title: Request Id type: string retryable: description: Whether the same request may succeed if sent again. title: Retryable type: boolean retry_after: description: Seconds to wait before retrying, as `Retry-After` says. title: Retry After type: integer errors: description: Each refused part of the request. items: $ref: '#/components/schemas/FieldIssue' title: Errors type: array resource: description: 'What wasn''t found: `job`, `batch`, `webhook`, `config`, …' title: Resource type: string reason: description: The cause within the code. title: Reason type: string parse_id: description: The parse the request recorded. title: Parse Id type: string extract_id: description: The extraction it recorded. title: Extract Id type: string split_id: description: The split it recorded. title: Split Id type: string classify_id: description: The classification it recorded. title: Classify Id type: string tables_id: description: The tables job it recorded. title: Tables Id type: string charts_id: description: The charts job it recorded. title: Charts Id type: string pipeline_id: description: The pipeline it recorded. title: Pipeline Id type: string batch_id: description: The batch it recorded. title: Batch Id type: string filename: description: The file refused. title: Filename type: string declared_type: description: The type its name declared. title: Declared Type type: string detected: description: The type its contents are. title: Detected type: string supported_types: description: The types accepted. items: type: string title: Supported Types type: array supported: description: The values accepted. items: type: string title: Supported type: array max_size_mb: anyOf: - type: integer - type: number description: The largest size accepted. title: Max Size Mb file_size_mb: anyOf: - type: integer - type: number description: The file's size. title: File Size Mb plan_name: description: Your organization's plan. title: Plan Name type: string pages_used: anyOf: - type: integer - type: number description: Pages used this period. title: Pages Used page_allowance: anyOf: - type: integer - type: number description: Pages the plan allows. title: Page Allowance upgrade_url: description: Where to change your plan. title: Upgrade Url type: string action_required: description: What to do to continue. title: Action Required type: string billing_info: additionalProperties: $ref: '#/components/schemas/JsonValue' description: Your organization's billing state, as the gate read it. title: Billing Info type: object required: - type - title - status - code - retryable title: Problem type: object FieldIssue: additionalProperties: false description: One refused part of the request. properties: field: description: >- The part as sent: a body field's path (`config.enhancements.detect[1]`), or `query.` / `header.`. title: Field type: string pointer: description: >- A body field as a JSON Pointer (RFC 6901), e.g. `#/config/enhancements/detect/1`. Absent for a query parameter or header. title: Pointer type: string issue: description: What is wrong with it. title: Issue type: string required: - field - issue title: FieldIssue type: object JsonValue: {} securitySchemes: ApiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.