List All Batches

List all batches

curl --request GET \
  --url https://api.nano-gpt.com/api/v1/batches \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nano-gpt.com/api/v1/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nano-gpt.com/api/v1/batches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.nano-gpt.com/api/v1/batches"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nano-gpt.com/api/v1/batches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "batch",
      "endpoint": "/v1/chat/completions",
      "input_file_id": "<string>",
      "completion_window": "24h",
      "status": "validating",
      "created_at": 123,
      "request_counts": {
        "total": 1,
        "completed": 1,
        "failed": 1
      },
      "output_file_id": "<string>",
      "error_file_id": "<string>",
      "in_progress_at": 123,
      "finalizing_at": 123,
      "completed_at": 123,
      "failed_at": 123,
      "expired_at": 123,
      "cancelling_at": 123,
      "cancelled_at": 123,
      "metadata": {},
      "usage": {
        "prompt_tokens": 1,
        "completion_tokens": 1,
        "total_tokens": 1
      },
      "errors": {}
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

{
  "error": 123,
  "message": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

GET

api

batches

List all batches

curl --request GET \
  --url https://api.nano-gpt.com/api/v1/batches \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.nano-gpt.com/api/v1/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.nano-gpt.com/api/v1/batches",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.nano-gpt.com/api/v1/batches"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.nano-gpt.com/api/v1/batches")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "object": "batch",
      "endpoint": "/v1/chat/completions",
      "input_file_id": "<string>",
      "completion_window": "24h",
      "status": "validating",
      "created_at": 123,
      "request_counts": {
        "total": 1,
        "completed": 1,
        "failed": 1
      },
      "output_file_id": "<string>",
      "error_file_id": "<string>",
      "in_progress_at": 123,
      "finalizing_at": 123,
      "completed_at": 123,
      "failed_at": 123,
      "expired_at": 123,
      "cancelling_at": 123,
      "cancelled_at": 123,
      "metadata": {},
      "usage": {
        "prompt_tokens": 1,
        "completion_tokens": 1,
        "total_tokens": 1
      },
      "errors": {}
    }
  ],
  "first_id": "<string>",
  "last_id": "<string>",
  "has_more": true
}

{
  "error": 123,
  "message": "<string>"
}

{
  "error": 123,
  "message": "<string>"
}

This OpenAI-compatible list includes both inline and file-backed jobs. Items retain the standard batch shape, including file IDs, lifecycle timestamps, request counts, metadata, usage, and errors where applicable. See the Batch API guide for pagination examples, filter rules, and error behavior.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit

integer

default:20

Number of batches to return.

Required range: 1 <= x <= 100

after

string

Return the next page of batches older than this batch ID. Use the current page's last_id. Cannot be combined with before.

before

string

Return the adjacent page of batches newer than this batch ID, still ordered newest first. Use the current page's first_id. Cannot be combined with after.

status

enum<string>[]

Filter by one or more statuses. Repeat the parameter or provide comma-separated values.

Available options:

validating,

in_progress,

finalizing,

completed,

failed,

expired,

cancelling,

cancelled

created_after

Return batches created strictly after this boundary. Accepts Unix seconds or a timezone-qualified ISO 8601/RFC 3339 timestamp with at most millisecond precision.

created_before

Return batches created strictly before this boundary. Accepts Unix seconds or a timezone-qualified ISO 8601/RFC 3339 timestamp with at most millisecond precision.

Response

A page of all visible batches ordered newest first.

object

string

required

Allowed value: "list"

data

object[]

required

All visible batches ordered newest first, including inline and file-backed jobs.

Show child attributes

first_id

string | null

required

First batch ID in this page, or null for an empty page. Pass as before to return to the adjacent newer page.

last_id

string | null

required

Last batch ID in this page, or null for an empty page. Pass as after to fetch the next older page.

has_more

boolean

required

Whether more records exist in the direction being paged.

Get Started

Endpoint Examples

API Reference

Miscellaneous

Partner

Integrations

Authorizations

Query Parameters

Response