go/resources/files/methods/retrieve/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

Retrieve file

client.Files.Get(ctx, fileID) (*FileObject, error)

get /files/{file_id}

Returns information about a specific file.

Parameters

• fileID string

Returns

• type FileObject struct{…}

  The File object represents a document that has been uploaded to OpenAI.

  • ID string

    The file identifier, which can be referenced in the API endpoints.

  • Bytes int64

    The size of the file, in bytes.

  • CreatedAt int64

    The Unix timestamp (in seconds) for when the file was created.

  • Filename string

    The name of the file.

  • Object File

    The object type, which is always file.

    • const FileFile File = "file"

  • Purpose FileObjectPurpose

    The intended purpose of the file. Supported values are assistants, assistants_output, batch, batch_output, fine-tune, fine-tune-results, vision, and user_data.

    • const FileObjectPurposeAssistants FileObjectPurpose = "assistants"

    • const FileObjectPurposeAssistantsOutput FileObjectPurpose = "assistants_output"

    • const FileObjectPurposeBatch FileObjectPurpose = "batch"

    • const FileObjectPurposeBatchOutput FileObjectPurpose = "batch_output"

    • const FileObjectPurposeFineTune FileObjectPurpose = "fine-tune"

    • const FileObjectPurposeFineTuneResults FileObjectPurpose = "fine-tune-results"

    • const FileObjectPurposeVision FileObjectPurpose = "vision"

    • const FileObjectPurposeUserData FileObjectPurpose = "user_data"

  • Status FileObjectStatus

    Deprecated. The current status of the file, which can be either uploaded, processed, or error.

    • const FileObjectStatusUploaded FileObjectStatus = "uploaded"

    • const FileObjectStatusProcessed FileObjectStatus = "processed"

    • const FileObjectStatusError FileObjectStatus = "error"

  • ExpiresAt int64

    The Unix timestamp (in seconds) for when the file will expire.

  • StatusDetails string

    Deprecated. For details on why a fine-tuning training file failed validation, see the error field on fine_tuning.job.

Example

package main

import (
  "context"
  "fmt"

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

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

Response

{
  "id": "id",
  "bytes": 0,
  "created_at": 0,
  "filename": "filename",
  "object": "file",
  "purpose": "assistants",
  "status": "uploaded",
  "expires_at": 0,
  "status_details": "status_details"
}