---
updatedAt: 2026-03-19T15:55:11.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# Get endpoint usage

Retrieves usage for a specific endpoint by its ID.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.tatum.io/v4/manage",
      "description": "Core API Production"
    }
  ],
  "info": {
    "title": "GATEWAY MANAGE API",
    "version": "0.0.1",
    "description": "",
    "license": {
      "name": "UNLICENSED"
    }
  },
  "paths": {
    "/endpoint/{id}/usage": {
      "get": {
        "summary": "Get endpoint usage",
        "description": "Retrieves usage for a specific endpoint by its ID.",
        "tags": [
          "Endpoint"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "a1b2c3d4-e5f6-7890-1234-567890abcdef"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Endpoint usage",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductUsageResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HttpExceptionDto"
                },
                "example": {
                  "statusCode": 401,
                  "timestamp": "2025-11-24T17:39:49.778Z",
                  "path": "/endpoint/f47ac10b-58cc-4372-a567-0e02b2c3d479/usage",
                  "message": "Authentication required. Make sure your requests are authenticated with a Tatum API key. Find out how at: https://co.tatum.io/docs_authentication. If you don't have one, get one for FREE via the Tatum Dashboard at https://co.tatum.io/signup",
                  "details": {
                    "error": "Unauthorized"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "X-API-Key": []
          }
        ],
        "x-samchon-accessor": [
          "endpoint",
          "usage",
          "getUsageById"
        ],
        "x-samchon-controller": "EndpointController"
      }
    }
  },
  "components": {
    "schemas": {
      "RecordstringProductUsageResponseDto": {
        "type": "object",
        "properties": {},
        "required": [],
        "description": "Construct a type with a set of properties K of type T",
        "additionalProperties": {
          "$ref": "#/components/schemas/ProductUsageResponseDto"
        }
      },
      "ProductUsageResponseDto": {
        "type": "object",
        "properties": {
          "sparkline": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UsagePointDto"
            },
            "description": "Daily usage sparkline (last 30 days)"
          },
          "total": {
            "type": "number",
            "description": "Total usage amount for the period"
          },
          "endpointUsages": {
            "$ref": "#/components/schemas/RecordstringProductUsageResponseDto",
            "description": "Usage for individual endpoints"
          },
          "methodRoutingOverrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MethodRoutingOverrideUsageDto"
            },
            "description": "Usage for method routing overrides"
          }
        },
        "required": [
          "sparkline",
          "total"
        ]
      },
      "UsagePointDto": {
        "type": "object",
        "properties": {
          "usage_date": {
            "type": "string",
            "description": "Date of the usage record"
          },
          "amount": {
            "type": "number",
            "description": "Usage amount for the day"
          }
        },
        "required": [
          "usage_date",
          "amount"
        ]
      },
      "MethodRoutingOverrideUsageDto": {
        "type": "object",
        "properties": {
          "methods": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "endpointUsages": {
            "$ref": "#/components/schemas/RecordstringProductUsageResponseDto"
          }
        },
        "required": [
          "methods",
          "endpointUsages"
        ]
      },
      "HttpExceptionDto": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "statusCode": {
            "type": "number"
          },
          "timestamp": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "details": {}
        },
        "required": [
          "message",
          "statusCode",
          "timestamp",
          "path"
        ]
      }
    },
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header",
        "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup)."
      }
    }
  },
  "tags": [
    {
      "name": "Endpoint"
    }
  ],
  "x-samchon-emended-v4": true
}
```