API Reference

Structured Sheets

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Retrieve structured sheet

client.StructuredSheets.Get(ctx, structuredSheetID) (*StructuredSheetResponse, error)

GET/v1/structured-sheets/{structured_sheet_id}

Get the status and details of a structured sheet conversion.

ParametersExpand Collapse

structuredSheetID string

The unique identifier of the structured sheet conversion.

ReturnsExpand Collapse

type StructuredSheetResponse struct{…}

Response representing a structured sheet conversion job.

This is returned from POST (create), GET (retrieve), and list endpoints.

ID string

The unique identifier for this structured sheet conversion.

CreatedAt Time

The timestamp when the conversion was started.

formatdate-time

FileID string

The unique identifier for the source file.

Object StructuredSheet

The object type, which is always 'structured_sheet'.

Status StructuredSheetResponseStatus

The current processing status.

One of the following:

const StructuredSheetResponseStatusQueued StructuredSheetResponseStatus = "queued"

const StructuredSheetResponseStatusInProgress StructuredSheetResponseStatus = "in_progress"

const StructuredSheetResponseStatusCompleted StructuredSheetResponseStatus = "completed"

const StructuredSheetResponseStatusFailed StructuredSheetResponseStatus = "failed"

const StructuredSheetResponseStatusCancelled StructuredSheetResponseStatus = "cancelled"

UpdatedAt Time

The timestamp when the conversion was last updated.

formatdate-time

LastError StructuredSheetResponseLastErroroptional

Error information when processing fails.

Code string

A machine-readable error code.

maxLength64

Message string

A human-readable description of the error.

maxLength1024

SheetNames []stringoptional

List of sheet names included in this conversion.

TableCount int64optional

Number of tables extracted from the workbook. Only present when status is 'completed'.

minimum0

Retrieve structured sheet

Go

HTTP

TypeScript

Python

Go

CLI Tool

package main

import (
  "context"
  "fmt"

  "github.com/deeptable-com/deeptable-go"
  "github.com/deeptable-com/deeptable-go/option"
)

func main() {
  client := deeptable.NewClient(
    option.WithAPIKey("My API Key"),
  )
  structuredSheetResponse, err := client.StructuredSheets.Get(context.TODO(), "ss_01kfxgjd94fn9stqm42nejb627")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", structuredSheetResponse.ID)
}

200 example

{
  "id": "ss_01kfxgjd94fn9stqm42nejb627",
  "created_at": "2024-01-15T10:30:00Z",
  "file_id": "file_01kfxgjd94fn9stqm414vjb0s8",
  "object": "structured_sheet",
  "status": "completed",
  "updated_at": "2024-01-15T10:35:00Z",
  "last_error": {
    "code": "invalid_file_format",
    "message": "The uploaded file is not a valid Excel spreadsheet."
  },
  "sheet_names": [
    "Sheet1",
    "Financials"
  ],
  "table_count": 6
}

Returns Examples

200 example

{
  "id": "ss_01kfxgjd94fn9stqm42nejb627",
  "created_at": "2024-01-15T10:30:00Z",
  "file_id": "file_01kfxgjd94fn9stqm414vjb0s8",
  "object": "structured_sheet",
  "status": "completed",
  "updated_at": "2024-01-15T10:35:00Z",
  "last_error": {
    "code": "invalid_file_format",
    "message": "The uploaded file is not a valid Excel spreadsheet."
  },
  "sheet_names": [
    "Sheet1",
    "Financials"
  ],
  "table_count": 6
}