Get a file

GET

/api/v1/files/{fileId}

CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "X-Api-Key: <X-Api-Key>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

CURLcode ret = curl_easy_perform(hnd);

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4"),
    Headers =
    {
        { "X-Api-Key", "<X-Api-Key>" },
    },
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4"

  req, _ := http.NewRequest("GET", url, nil)

  req.Header.Add("X-Api-Key", "<X-Api-Key>")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4"))
    .header("X-Api-Key", "<X-Api-Key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4")
  .get()
  .addHeader("X-Api-Key", "<X-Api-Key>")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4',
  headers: {'X-Api-Key': '<X-Api-Key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4';
const options = {method: 'GET', headers: {'X-Api-Key': '<X-Api-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

val client = OkHttpClient()

val request = Request.Builder()
  .url("https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4")
  .get()
  .addHeader("X-Api-Key", "<X-Api-Key>")
  .build()

val response = client.newCall(request).execute()

use reqwest;

#[tokio::main]
pub async fn main() {
    let url = "https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4";

    let mut headers = reqwest::header::HeaderMap::new();
    headers.insert("X-Api-Key", "<X-Api-Key>".parse().unwrap());

    let client = reqwest::Client::new();
    let response = client.get(url)
        .headers(headers)
        .send()
        .await;

    let results = response.unwrap()
        .json::<serde_json::Value>()
        .await
        .unwrap();

    dbg!(results);
}

curl --request GET \
  --url https://api.langparse.dev/api/v1/files/file_mrb1a2c3d4 \
  --header 'X-Api-Key: <X-Api-Key>'

File metadata + a short-lived presigned S3 download URL (attachment, ~15 min). Request on demand; do not cache the URL.

Authorizations

apiKey
bearerAuth

Parameters

Path Parameters

fileId

required

string

Example

file_mrb1a2c3d4

Responses

200

File metadata + signed download URL.

application/json

object

data

required

object

string

fileName

string

byteSize

integer

nullable

pageCount

integer

nullable

contentType

string

nullable

url

Presigned S3 GET (attachment). Expires per expiresInSeconds. Request on demand.

string

expiresInSeconds

integer

Example

{
  "data": {
    "id": "file_mrb1a2c3d4",
    "fileName": "invoice.pdf",
    "byteSize": 48213,
    "pageCount": 2,
    "contentType": "application/pdf",
    "url": "https://…s3…X-Amz-Signature=…",
    "expiresInSeconds": 900
  }
}

401

Missing or invalid API key.

application/json

Error response. statusCode mirrors the HTTP status; statusMessage is human-readable.

object

statusCode

integer

statusMessage

string

Example

{
  "statusCode": 404,
  "statusMessage": "Document not found"
}

404

File not found.

application/json

Error response. statusCode mirrors the HTTP status; statusMessage is human-readable.

object

statusCode

integer

statusMessage

string

Example

{
  "statusCode": 404,
  "statusMessage": "Document not found"
}