---
title: "Get usage by collection"
method: GET
path: "/v3/collections/{identifier}/usage"
tags: ["Deprecated End Points"]
deprecated: true
---

# Get usage by collection

`GET /v3/collections/{identifier}/usage`

> **Deprecated.**

Return monthly credits consumption of a collection.
Deprecated: use `GET /v3/usage?organization={id}&document_type={id}` instead. The new endpoint returns a unified daily series and uses the modern "document type" terminology.

## Path parameters

- `identifier` string, required — Uniquely identify a collection.

## Query parameters

- `start` string
- `end` string

## Response `200`

Monthly credits consumption of a collection.

- UsageByCollection[] — Monthly credits consumption
  - `month` string, required — Month of the usage
  - `count` integer, required — Usage count

## Other responses

- `400` — Bad request. If it is a validation error will contain a list of each invalid field
- `401` — Authorisation error
- `default` — UnexpectedError

---

[API](https://skmtc.net/affinda/apis/affinda-api-2.md) · [All operations](https://skmtc.net/affinda/apis/affinda-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinda/affinda-api-2/versions/6772e50cb58e/schema)