List Project Usage Fields | Deepgram's Docs

GET/v1/projects/{project_id}/usage/fieldsList Project Usage Fields

Lists the features, models, tags, languages, and processing method used for requests in the specified project

Parameters

project_idstringpathrequired

The unique identifier of the project

startstring · datequery

Start date of the requested date range. Format accepted is YYYY-MM-DD

endstring · datequery

End date of the requested date range. Format accepted is YYYY-MM-DD

Responses

objectUsageFieldsV1Response

UsageFieldsV1Response

featuresarray of string

API features available to the project

Show child attributes

modelsarray of object

List of models available for the project.

Show child attributes

Show array items

languagestring

The language supported by the model (IETF language tag).

model_idstring

Unique identifier for the model.

namestring

Name of the model.

versionstring

Version identifier of the model, typically with a date and a revision number.

processing_methodsarray of string

Processing methods supported by the API

Show child attributes

tagsarray of string

List of tags associated with the project

Show child attributes

Example response

{
  "features": [
    "string"
  ],
  "models": [
    {
      "language": "string",
      "model_id": "string",
      "name": "string",
      "version": "string"
    }
  ],
  "processing_methods": [
    "string"
  ],
  "tags": [
    "string"
  ]
}

valueErrorResponse

ErrorResponse

oneOf · 3 options

Option 1stringErrorResponseTextError

ErrorResponseTextError

Option 2objectErrorResponseLegacyError

ErrorResponseLegacyError

err_codestring

The error code

err_msgstring

The error message

request_idstring

The request ID

Option 3objectErrorResponseModernError

ErrorResponseModernError

categorystring

The category of the error

detailsstring

A description of the error

messagestring

A message about the error

request_idstring

The unique identifier of the request

Example response

{
  "err_code": "string",
  "err_msg": "string",
  "request_id": "string"
}

Examples

project_idrequiredpath parameter

startquery parameter

endquery parameter

curl -X GET 'https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09'

const response = await fetch('https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09', { method: 'GET' });
const data = await response.json();

const response = await fetch('https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09', { method: 'GET' });
console.log(await response.json());

import requests

response = requests.request("GET", "https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09")
print(response.json())

package main

import (
	"context"
	"net/http"
)

func main() {
	ctx := context.Background()
	req, err := http.NewRequestWithContext(ctx, "GET", "https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09", nil)
	if err != nil {
		panic(err)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09"))
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09")
request = Net::HTTPGenericRequest.new("GET", false, true, uri)
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://agent.deepgram.com/v1/projects/string/usage/fields?end=2026-06-09&start=2026-06-09");
using var response = await client.SendAsync(request);

{
  "features": [
    "string"
  ],
  "models": [
    {
      "language": "string",
      "model_id": "string",
      "name": "string",
      "version": "string"
    }
  ],
  "processing_methods": [
    "string"
  ],
  "tags": [
    "string"
  ]
}

{
  "err_code": "string",
  "err_msg": "string",
  "request_id": "string"
}