> ## 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. # Get Charts Result > Get a completed job's charts, with each export file's full content in `exports`. To save a file, decode its `content_base64` and write it under its `filename`. If your organization's retention deletes a result the first time it's read, exports included, save the response, because a later read returns `410`. ## OpenAPI ````yaml /api-reference/v2/openapi.yml get /charts/{charts_id}/result 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: /charts/{charts_id}/result: get: tags: - Charts summary: Get Charts Result description: >- Get a completed job's charts, with each export file's full content in `exports`. To save a file, decode its `content_base64` and write it under its `filename`. If your organization's retention deletes a result the first time it's read, exports included, save the response, because a later read returns `410`. operationId: getChartsResult parameters: - name: charts_id in: path required: true schema: type: string description: The `charts_id` that `POST /charts` returned. title: Charts Id description: The `charts_id` that `POST /charts` returned. - name: Pulse-Version in: header required: false schema: type: string default: '2' title: Pulse-Version examples: default: value: '2' responses: '200': description: The job's charts and exports. content: application/json: schema: $ref: '#/components/schemas/ChartsResult' '400': description: >- The request is invalid ([`REQUEST_INVALID`](https://docs.runpulse.com/errors/request-invalid)), e.g. it sends a query parameter. The job failed, and this is its error ([`REQUEST_INVALID`](https://docs.runpulse.com/errors/request-invalid), [`PAGE_RANGE_INVALID`](https://docs.runpulse.com/errors/page-range-invalid), [`RESOURCE_UNUSABLE`](https://docs.runpulse.com/errors/resource-unusable)). `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 - PAGE_RANGE_INVALID - RESOURCE_UNUSABLE - UNSUPPORTED_VERSION '401': description: >- No valid API key was sent ([`CREDENTIALS_INVALID`](https://docs.runpulse.com/errors/credentials-invalid)), or the key is inactive ([`API_KEY_INACTIVE`](https://docs.runpulse.com/errors/api-key-inactive)). 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: >- The job failed, and this is its error ([`TRIAL_EXPIRED`](https://docs.runpulse.com/errors/trial-expired), [`CREDIT_LIMIT_EXCEEDED`](https://docs.runpulse.com/errors/credit-limit-exceeded), [`PAYMENT_REQUIRED`](https://docs.runpulse.com/errors/payment-required), [`PLAN_LIMIT_REACHED`](https://docs.runpulse.com/errors/plan-limit-reached), [`PAYMENT_FAILED`](https://docs.runpulse.com/errors/payment-failed), [`PAYMENT_AUTHENTICATION_REQUIRED`](https://docs.runpulse.com/errors/payment-authentication-required), [`SUBSCRIPTION_CANCELED`](https://docs.runpulse.com/errors/subscription-canceled), [`SUBSCRIPTION_PAST_DUE`](https://docs.runpulse.com/errors/subscription-past-due)). 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: - TRIAL_EXPIRED - CREDIT_LIMIT_EXCEEDED - PAYMENT_REQUIRED - PLAN_LIMIT_REACHED - PAYMENT_FAILED - PAYMENT_AUTHENTICATION_REQUIRED - SUBSCRIPTION_CANCELED - SUBSCRIPTION_PAST_DUE '403': description: >- Your organization may not use the API right now ([`ACCOUNT_SUSPENDED`](https://docs.runpulse.com/errors/account-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: >- No charts job with this id exists in your organization ([`RESOURCE_NOT_FOUND`](https://docs.runpulse.com/errors/resource-not-found)). The job failed, and this is its error ([`RESOURCE_NOT_FOUND`](https://docs.runpulse.com/errors/resource-not-found)). 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: >- The job is still queued or processing ([`JOB_NOT_FINISHED`](https://docs.runpulse.com/errors/job-not-finished)); poll its status until it ends. 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_NOT_FINISHED '410': description: >- [`RESULT_EXPIRED`](https://docs.runpulse.com/errors/result-expired): the result expired under your retention. [`JOB_CANCELED`](https://docs.runpulse.com/errors/job-canceled): the job was canceled. [`RESULT_ALREADY_FETCHED`](https://docs.runpulse.com/errors/result-already-fetched): your organization's retention deletes a result on its first read, and this one was read. 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 - JOB_CANCELED - RESULT_ALREADY_FETCHED '500': description: >- [`JOB_UNREADABLE`](https://docs.runpulse.com/errors/job-unreadable): Pulse can't read this job right now; don't retry, contact support. The job failed, and this is its error ([`PROCESSING_FAILED`](https://docs.runpulse.com/errors/processing-failed), [`SERVER_ERROR`](https://docs.runpulse.com/errors/server-error)). 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_UNREADABLE - PROCESSING_FAILED - SERVER_ERROR '503': description: >- The job couldn't be read ([`SERVICE_UNAVAILABLE`](https://docs.runpulse.com/errors/service-unavailable)); retry shortly. The job failed, and this is its error ([`SERVICE_UNAVAILABLE`](https://docs.runpulse.com/errors/service-unavailable)). On a self-hosted install that hasn't been activated yet, [`LICENSE_NOT_ACTIVATED`](https://docs.runpulse.com/errors/license-not-activated). 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_NOT_ACTIVATED security: - ApiKey: [] components: schemas: ChartsResult: properties: charts_id: type: string title: Charts Id description: The charts job's id, `charts-`. exports: items: $ref: '#/components/schemas/ChartsExport' type: array title: Exports description: >- The files built in the requested formats, each one in full. Empty when no chart was found. charts: items: $ref: '#/components/schemas/Chart' type: array title: Charts description: >- Every chart read, one per `Figure` element on the requested pages, with that element's page and position. usage: $ref: '#/components/schemas/Usage' description: The pages and credits this request used. warnings: items: $ref: '#/components/schemas/Warning' type: array title: Warnings description: Issues that may affect this result. Absent when there are none. expires_at: type: string title: Expires At description: >- When the result will be deleted. Absent when the result is kept with no expiry. history: $ref: '#/components/schemas/ResultHistory' additionalProperties: false type: object required: - charts_id - exports - charts - usage - history title: ChartsResult description: >- A completed `/charts` job's result, read at `GET /charts/{charts_id}/result`. 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 ChartsExport: properties: format: type: string enum: - excel - csv - las title: Format description: The file's format. filename: type: string title: Filename description: >- A name to save the file under, such as `chart-data.xlsx` or `chart-data.csv`. media_type: type: string title: Media Type description: >- The file's media type, such as `application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` for `excel`. element_id: type: string title: Element Id description: >- The well-log chart this file was built from, for `las` files only. Absent on `excel` and `csv` files, which hold every chart. content_base64: type: string title: Content Base64 description: >- The file's bytes, base64-encoded. Decode them and save the file under `filename`. additionalProperties: false type: object required: - format - filename - media_type - content_base64 title: ChartsExport description: A file built from the charts read, in one of the requested formats. Chart: properties: element_id: type: string title: Element Id description: >- The id of the `Figure` element in the parse's result that this chart was read from. page: type: integer title: Page description: >- The page the chart is on, numbered as in the parse's result. This request's `page_range` doesn't renumber pages. bbox: anyOf: - prefixItems: - type: number - type: number - type: number - type: number - type: number - type: number - type: number - type: number type: array maxItems: 8 minItems: 8 - type: 'null' title: Bbox description: >- The element's four corners, `[x1, y1, ..., x4, y4]`, clockwise from top-left, as fractions of the page's width and height. It's `null` for spreadsheet elements and some picture captions. sheet: type: string title: Sheet description: >- The element's sheet in a spreadsheet. A workbook's sheets are its pages. range: type: string title: Range description: >- The spreadsheet cells the element covers, such as `B2:D2`. Absent for a chart or picture not anchored to cells. type: type: string enum: - line - bar - area - scatter - pie - donut - well_log title: Type description: >- The chart's type. A chart that combines plot types reports its first plot's type, and each series names its own in `type`. title: anyOf: - type: string - type: 'null' title: Title description: >- The chart's own title as printed, or null when it has none. A heading above the chart isn't its title. x_axis: anyOf: - $ref: '#/components/schemas/Axis' - type: 'null' description: The horizontal axis, or null for pie and donut charts. y_axis: anyOf: - $ref: '#/components/schemas/Axis' - type: 'null' description: The vertical axis, or null for pie and donut charts. secondary_y_axis: $ref: '#/components/schemas/Axis' description: A second vertical axis, present only when a series uses it. series: items: $ref: '#/components/schemas/Series' type: array title: Series description: The chart's data series, in the chart's order. confidence: anyOf: - type: number - type: 'null' title: Confidence description: >- How reliable the values are, from 0 to 1, for a chart read from pixels. It's null for a spreadsheet chart, whose values are exact. warnings: items: $ref: '#/components/schemas/Warning' type: array title: Warnings description: >- Issues with reading this chart, such as `CHART_X_AXIS_NORMALIZED` or `CHART_PIE_UNLABELED`. Absent when there are none. additionalProperties: false type: object required: - element_id - page - bbox - type - title - x_axis - y_axis - series - confidence title: Chart description: >- One chart, read from a `Figure` element of the parse's result. It has the same page and position as that element. Usage: properties: request: $ref: '#/components/schemas/UsageRequest' org: $ref: '#/components/schemas/OrganizationUsage' description: >- Your organization's usage, including this request. Absent when it couldn't be read. additionalProperties: false type: object required: - request title: Usage description: Pages and credits used, by this request and by your organization. Warning: properties: code: type: string title: Code description: A stable code naming the warning. Match on this, not `message`. message: type: string title: Message description: A human-readable explanation. Its wording may change. additionalProperties: false type: object required: - code - message title: Warning description: Something that didn't stop the job but may affect its result. ResultHistory: properties: file_name: type: string title: File Name description: The original document's name. previous_step: type: string title: Previous Step description: >- The id of the result this one was built from, a `parse_id` or a `split_id`. Absent on `/parse` results. additionalProperties: false type: object required: - file_name title: ResultHistory description: Where this result came from. 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: {} Axis: properties: scale: type: string enum: - linear - log - categorical - normalized title: Scale description: >- How values run along the axis, as read from the chart. `normalized` means the axis couldn't be calibrated, so values run from 0 to 1 and the chart carries a warning. title: anyOf: - type: string - type: 'null' title: Title description: The axis's title as printed, or null when it has none. additionalProperties: false type: object required: - scale - title title: Axis description: An axis of a chart. Series: properties: name: type: string title: Name description: >- The series' name, from the legend or a spreadsheet's series title. It's `Series` when the name couldn't be read. type: type: string enum: - line - bar - area - scatter - pie - donut - well_log title: Type description: >- This series' plot type, in a chart that combines types. Absent when every series shares the chart's `type`. secondary_axis: type: boolean const: true title: Secondary Axis description: '`true` when the series is plotted against `secondary_y_axis`.' color: type: string pattern: ^#[0-9a-fA-F]{6}$ title: Color description: The series' color as `#rrggbb`. Absent when it could not be read. line_style: type: string enum: - solid - dashed - dotted - dash_dot - unknown title: Line Style description: >- The line's style, for line charts only. It's `unknown` when the style couldn't be read. data: items: prefixItems: - anyOf: - type: string - type: number - anyOf: - type: number - type: 'null' type: array maxItems: 2 minItems: 2 type: array title: Data description: >- The series' `[x, y]` points, in the chart's order. `x` is a label or number. `y` is a number, or null where it couldn't be read. Pie and donut charts hold `[label, percent]` pairs. additionalProperties: false type: object required: - name - data title: Series description: One data series of a chart. UsageRequest: properties: pages_processed: type: integer title: Pages Processed description: Pages this request processed. credits_used: type: number title: Credits Used description: Credits this request used. additionalProperties: false type: object required: - pages_processed - credits_used title: UsageRequest description: What this request used. OrganizationUsage: properties: pages_processed: type: integer title: Pages Processed description: >- Pages processed, including this request's. A document's pages count once, when it is parsed: a step that reads a parse adds none. credits_used: type: number title: Credits Used description: Credits used, including this request's. credit_allowance: type: number title: Credit Allowance description: >- The credits your plan includes per billing period, or in total if it has no billing period. Absent on pay-as-you-go plans. additionalProperties: false type: object required: - pages_processed - credits_used title: OrganizationUsage description: >- Your organization's usage in its current billing period, including this request. If your plan has no billing period, it covers all time. 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.