List files

Lists files for a provider.

GET /v1/files

Error

A valid request URL is required to generate request examples

200

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "bytes": 123,
      "created_at": 123,
      "filename": "<string>",
      "purpose": "batch",
      "status": "uploaded",
      "status_details": "<string>",
      "expires_at": 123
    }
  ],
  "has_more": true,
  "after": "<string>",
  "extra_fields": {
    "request_type": "<string>",
    "pricing_request_type": "<string>",
    "routing_info": {
      "provider": "anthropic",
      "model": "<string>",
      "key": "<string>",
      "resolved_key_alias": {
        "model_id": "<string>",
        "model_name": "<string>",
        "model_family": "<string>"
      },
      "is_fallback": true,
      "primary_provider": "anthropic",
      "primary_model": "<string>",
      "requested_provider": "anthropic",
      "requested_model": "<string>",
      "server_side_fallback_model": "<string>"
    },
    "provider": "anthropic",
    "original_model_requested": "<string>",
    "resolved_model_used": "<string>",
    "latency": 123,
    "upstream_latency": 123,
    "chunk_index": 123,
    "raw_request": "<unknown>",
    "raw_response": "<unknown>",
    "cache_debug": {
      "cache_hit": true,
      "cache_id": "<string>",
      "hit_type": "<string>",
      "requested_provider": "<string>",
      "requested_model": "<string>",
      "provider_used": "<string>",
      "model_used": "<string>",
      "input_tokens": 123,
      "threshold": 123,
      "similarity": 123,
      "cache_hit_latency": 123
    },
    "routing_metadata": {
      "calls": [
        {
          "request_type": "<string>",
          "provider_used": "<string>",
          "model_used": "<string>",
          "input_tokens": 123,
          "output_tokens": 123,
          "count_toward_budgets": true
        }
      ]
    },
    "guardrail_debug": {},
    "parse_errors": [
      {
        "code": "<string>",
        "message": "<string>",
        "param": "<string>",
        "line": 123
      }
    ],
    "converted_request_type": "<string>",
    "dropped_compat_plugin_params": [
      "<string>"
    ],
    "dropped_unsupported_tools": [
      "<string>"
    ],
    "provider_response_headers": {},
    "passthrough_path": "<string>"
  }
}

Authorizations

BearerAuthVirtualKeyAuthApiKeyAuth

Authorization · string · header · required

Bearer token authentication. Use your provider API key or Bifrost authentication token. Virtual keys (prefixed with sk-bf-) can also be passed here.

Query Parameters

x-model-provider · enum<string> · required

Provider to list files for AI model provider identifier

Available options: anthropic, azure, bedrock, bedrock_mantle, cerebras, cohere, deepseek, gemini, groq, mistral, ollama, opencode-go, opencode-zen, openai, parasail, perplexity, sgl, vertex, openrouter, elevenlabs, huggingface, nebius, xai, replicate, vllm, runway, runware, fireworks, sarvam, wafer, databricks, cloudflare, typesafe

purpose · enum<string>

Filter by purpose

Available options: batch, assistants, fine-tune, vision, batch_output, user_data, responses, evals

limit · integer

Maximum number of files to return

Required range: x >= 1

after · string

Cursor for pagination

order · enum<string>

Sort order (asc/desc)

Available options: asc, desc

Response

200

application/json

Successful response

object · string

data · object[]

Show child attributes

has_more · boolean

after · string

extra_fields · object

Additional fields included in responses

Show child attributes