Loki

Loki Loki API

The Loki API from Loki — 17 operation(s) for loki.

GitHub OpenAPI

Documentation

📖
Documentation
https://grafana.com/docs/loki/latest/reference/loki-http-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/loki/refs/heads/main/openapi/loki-loki-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/grafana/loki

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/loki-loki-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

loki-loki-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: HTTP Config Loki API
  description: Minimal OpenAPI 3.1 specification for the Grafana Loki HTTP API, covering log ingest, queries, labels, series, status, ring, flush, rules, and deletion endpoints.
  version: 1.0.0
servers:
- url: http://localhost:3100
  description: Default Loki HTTP server
tags:
- name: Loki
paths:
  /loki/api/v1/push:
    post:
      operationId: pushLogs
      summary: Push log entries to Loki
      responses:
        '204':
          description: Logs accepted
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/query:
    get:
      operationId: query
      summary: Run a LogQL instant query
      parameters:
      - name: query
        in: query
        schema:
          type: string
      - name: time
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Query result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/query_range:
    get:
      operationId: queryRange
      summary: Run a LogQL range query
      parameters:
      - name: query
        in: query
        schema:
          type: string
      - name: start
        in: query
        schema:
          type: string
      - name: end
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Query result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/labels:
    get:
      operationId: listLabels
      summary: List label names
      responses:
        '200':
          description: List of label names
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/label/{name}/values:
    get:
      operationId: getLabelValues
      summary: List values for a label
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Label values
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/series:
    get:
      operationId: listSeries
      summary: List series matching matchers
      responses:
        '200':
          description: Series result
        default:
          description: Error response
      tags:
      - Loki
    post:
      operationId: postSeries
      summary: List series matching matchers via POST
      responses:
        '200':
          description: Series result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/index/stats:
    get:
      operationId: indexStats
      summary: Retrieve index stats
      responses:
        '200':
          description: Index statistics
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/index/volume:
    get:
      operationId: indexVolume
      summary: Retrieve index volume
      responses:
        '200':
          description: Volume result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/index/volume_range:
    get:
      operationId: indexVolumeRange
      summary: Retrieve index volume over a range
      responses:
        '200':
          description: Volume range result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/patterns:
    get:
      operationId: getPatterns
      summary: Retrieve detected log patterns
      responses:
        '200':
          description: Patterns result
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/tail:
    get:
      operationId: tailLogs
      summary: Tail log entries via WebSocket
      responses:
        '200':
          description: Tail stream
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/status/buildinfo:
    get:
      operationId: buildInfo
      summary: Retrieve build information
      responses:
        '200':
          description: Build info
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/rules:
    get:
      operationId: listAllRules
      summary: List all ruler namespaces and groups
      responses:
        '200':
          description: Rules list
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/rules/{namespace}:
    get:
      operationId: listNamespaceRules
      summary: List rule groups in a namespace
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Rule groups
        default:
          description: Error response
      tags:
      - Loki
    post:
      operationId: createNamespaceRules
      summary: Create or update rule groups in a namespace
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted
        default:
          description: Error response
      tags:
      - Loki
    delete:
      operationId: deleteNamespaceRules
      summary: Delete all rule groups in a namespace
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Deleted
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/rules/{namespace}/{groupName}:
    get:
      operationId: getRuleGroup
      summary: Retrieve a rule group
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: groupName
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Rule group
        default:
          description: Error response
      tags:
      - Loki
    delete:
      operationId: deleteRuleGroup
      summary: Delete a rule group
      parameters:
      - name: namespace
        in: path
        required: true
        schema:
          type: string
      - name: groupName
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Deleted
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/delete:
    get:
      operationId: listDeleteRequests
      summary: List delete requests
      responses:
        '200':
          description: Delete requests
        default:
          description: Error response
      tags:
      - Loki
    post:
      operationId: createDeleteRequest
      summary: Create a delete request
      responses:
        '204':
          description: Accepted
        default:
          description: Error response
      tags:
      - Loki
    delete:
      operationId: cancelDeleteRequest
      summary: Cancel a delete request
      responses:
        '204':
          description: Cancelled
        default:
          description: Error response
      tags:
      - Loki
  /loki/api/v1/format_query:
    get:
      operationId: formatQuery
      summary: Format a LogQL query
      responses:
        '200':
          description: Formatted query
        default:
          description: Error response
      tags:
      - Loki
x-generated-from: https://grafana.com/docs/loki/latest/reference/loki-http-api/
x-generated-by: claude-crawl-2026-05-08