> ## Documentation Index > Fetch the complete documentation index at: https://docs.pinecone.io/llms.txt > Use this file to discover all available pages before exploring further. # Describe a conversion job > Get the status and progress of a conversion job. ```bash curl theme={null} PINECONE_API_KEY="YOUR_API_KEY" JOB_ID="670e8400-e29b-41d4-a716-446655440001" curl "https://api.pinecone.io/conversion-jobs/$JOB_ID" \ -H "Api-Key: $PINECONE_API_KEY" \ -H "X-Pinecone-Api-Version: 2026-07" \ -H 'accept: application/json' ``` ## OpenAPI ````yaml https://raw.githubusercontent.com/pinecone-io/pinecone-api/refs/heads/main/2026-07/db_control_2026-07.oas.yaml get /conversion-jobs/{job_id} openapi: 3.0.3 info: title: Pinecone Control Plane API description: >- Pinecone is a vector database that makes it easy to search and retrieve billions of high-dimensional vectors. contact: name: Pinecone Support url: https://support.pinecone.io email: support@pinecone.io license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 2026-07 servers: - url: https://api.pinecone.io description: Production API endpoints security: - ApiKeyAuth: [] tags: - name: Manage Indexes description: Actions that manage indexes externalDocs: description: More Pinecone.io API docs url: https://docs.pinecone.io/introduction paths: /conversion-jobs/{job_id}: get: tags: - Manage Indexes summary: Describe a conversion job description: Get the status and progress of a conversion job. operationId: describe_conversion_job parameters: - in: header name: X-Pinecone-Api-Version description: Required date-based version header required: true schema: default: 2026-07 type: string style: simple - in: path name: job_id description: The ID of the conversion job to describe. required: true schema: type: string example: 670e8400-e29b-41d4-a716-446655440001 style: simple responses: '200': description: The status and progress of the conversion job. content: application/json: schema: $ref: '#/components/schemas/ConversionJobModel' '401': description: 'Unauthorized. Possible causes: missing or invalid API key.' content: text/plain: schema: $ref: '#/components/schemas/UnauthorizedMessage' '403': description: >- Forbidden. The API key or principal is authenticated but lacks the permission required for this operation. Grant the required permission to the key's role, or use a key that already holds it. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: permission-denied: summary: Missing permission value: error: code: PERMISSION_DENIED message: >- Access denied: Permission control::backups::list is required status: 403 '404': description: Conversion job not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: conversion-job-not-found: summary: Conversion job not found value: error: code: NOT_FOUND message: >- Conversion job 670e8400-e29b-41d4-a716-446655440001 not found. status: 404 '500': description: Internal server error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: internal-server-error: summary: Internal server error value: error: code: UNKNOWN message: Internal server error status: 500 components: schemas: ConversionJobModel: description: >- The status and progress of a job that converts a vector index into a document index. type: object properties: conversion_job_id: example: 670e8400-e29b-41d4-a716-446655440001 description: Identifies the job when describing or cancelling it. type: string source_index_name: nullable: true example: example-index description: >- Name of the index being converted. `null` once that index has been deleted. type: string source_index_id: example: 670e8400-e29b-41d4-a716-446655440000 description: >- Identifies the vector index the job reads from. Stays set after that index is deleted. type: string target_index_name: example: example-index-docs description: Name of the document index the job fills. type: string target_index_id: example: 123e4567-e89b-12d3-a456-426614174000 description: ID of the document index the job fills. type: string status: example: InProgress description: >- Status of the conversion job. Possible values: `Pending`, `InProgress`, `Completed`, `Failed`, or `Cancelled`. x-enum: - Pending - InProgress - Completed - Failed - Cancelled type: string error_mode: $ref: '#/components/schemas/ConversionErrorMode' percent_complete: example: 42.5 description: >- Progress of the conversion job, from 0 to 100. Absent until the job has started. type: number format: float minimum: 0 maximum: 100 records_converted: example: 425000 description: The number of source records written to the document index so far. type: integer format: int64 minimum: 0 records_skipped: example: 0 description: >- The number of source records skipped because the document index cannot take them. Always `0` when `error_mode.on_error` is `abort`. type: integer format: int64 minimum: 0 error: nullable: true example: >- Record doc-17: the metadata value for full-text search field `chunk_text` is a number, not a string. description: Why the job failed, when its status is `Failed`. `null` otherwise. type: string created_at: example: '2026-10-07T10:30:00.000Z' description: Timestamp when the conversion job was created. type: string format: date-time completed_at: nullable: true example: '2026-10-07T11:05:00.000Z' description: >- Timestamp when the conversion job ended as `Completed`, `Failed`, or `Cancelled`. `null` until then. type: string format: date-time required: - conversion_job_id - source_index_id - target_index_name - target_index_id - status - created_at UnauthorizedMessage: example: Invalid API key description: >- The plain-text body of a `401` response. Authentication failures are rejected before the request reaches the API, so they carry a short message rather than an `ErrorResponse`. type: string ErrorResponse: example: error: code: INVALID_ARGUMENT message: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. status: 400 description: The response shape used for all error responses. type: object properties: status: example: 500 description: The HTTP status code of the error. type: integer error: example: code: INVALID_ARGUMENT message: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. description: Detailed information about the error that occurred. type: object properties: code: description: >- The error code. Possible values: `OK`, `UNKNOWN`, `INVALID_ARGUMENT`, `DEADLINE_EXCEEDED`, `NOT_FOUND`, `ALREADY_EXISTS`, `PERMISSION_DENIED`, `UNAUTHENTICATED`, `RESOURCE_EXHAUSTED`, `FAILED_PRECONDITION`, `ABORTED`, `OUT_OF_RANGE`, `INTERNAL`, `FORBIDDEN`, `PAYMENT_REQUIRED`, `SERVICE_UNAVAILABLE`, `PAYLOAD_TOO_LARGE`, or `UNPROCESSABLE_ENTITY`. x-enum: - OK - UNKNOWN - INVALID_ARGUMENT - DEADLINE_EXCEEDED - NOT_FOUND - ALREADY_EXISTS - PERMISSION_DENIED - UNAUTHENTICATED - RESOURCE_EXHAUSTED - FAILED_PRECONDITION - ABORTED - OUT_OF_RANGE - INTERNAL - FORBIDDEN - PAYMENT_REQUIRED - SERVICE_UNAVAILABLE - PAYLOAD_TOO_LARGE - UNPROCESSABLE_ENTITY type: string message: example: >- Index name must contain only lowercase alphanumeric characters or hyphens, and must not begin or end with a hyphen. description: A human-readable description of the error type: string details: description: >- Additional information about the error. This field is not guaranteed to be present. type: object required: - code - message required: - status - error ConversionErrorMode: description: >- How a conversion handles a source record the new index cannot take, such as a record whose metadata value for a `full_text_search` field is not a string. Records the schema can hold are never affected. If omitted, `on_error` is `abort`. type: object properties: on_error: example: abort description: >- What a record the new index cannot take does to the conversion. Possible values: - `abort`: the conversion fails, and the job's `error` names the record and the reason. - `continue`: the record is skipped and counted in the job's `records_skipped`. x-enum: - abort - continue type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: Api-Key description: >- An API Key is required to call Pinecone APIs. Get yours from the [console](https://app.pinecone.io/). ````