# ink.resenha.storage.getUsage

> Requires the caller's service token. Measured once a day; a new account isn't measured until the next check.

- Kind: query
- Authority: storage.resenha.ink
- Lexicon: 1
- Published by [resenha.ink](https://lexicon.garden/identity/did:plc:v7itjf4h3sb5zuegiiskctqb), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:v7itjf4h3sb5zuegiiskctqb/ink.resenha.storage.getUsage)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:v7itjf4h3sb5zuegiiskctqb/ink.resenha.storage.getUsage/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:v7itjf4h3sb5zuegiiskctqb/ink.resenha.storage.getUsage/analytics)

## Query (`ink.resenha.storage.getUsage`)

Type: query · GET

### Parameters (query string)


### Output (application/json)

- `blobBytes` (integer, required): Every file in the account, whichever app saved it, from the sizes of its blobs.
- `checkedAt` (integer, required): When Resenha's server last checked, in seconds since 1970.
- `dbBytes` (integer): The account's records: library, reviews, follows, and other apps' records. Absent until the host has measured the account.
- `ebookBytes` (integer): The caller's eBook and comic files, from the sizes their records carry. Absent when the records couldn't be read.
- `ebookFiles` (integer)
- `limitBytes` (integer, required): The room the caller's plan gives eBook and comic files.
- `measuredAt` (string · datetime): When the host last measured the account, when it says.
- `otherAppsBytes` (integer): Files other apps saved: blobBytes less ebookBytes. Absent with ebookBytes.
- `overLimit` (boolean, required): The eBook and comic files are past the plan's room. Nothing is deleted or blocked for it.

### Errors

- `NotMeasured`: The account hasn't been measured yet.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Requires the caller's service token. Measured once a day; a new account isn't measured until the next check.",
      "errors": [
        {
          "description": "The account hasn't been measured yet.",
          "name": "NotMeasured"
        }
      ],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "blobBytes": {
              "description": "Every file in the account, whichever app saved it, from the sizes of its blobs.",
              "type": "integer"
            },
            "checkedAt": {
              "description": "When Resenha's server last checked, in seconds since 1970.",
              "type": "integer"
            },
            "dbBytes": {
              "description": "The account's records: library, reviews, follows, and other apps' records. Absent until the host has measured the account.",
              "type": "integer"
            },
            "ebookBytes": {
              "description": "The caller's eBook and comic files, from the sizes their records carry. Absent when the records couldn't be read.",
              "type": "integer"
            },
            "ebookFiles": {
              "type": "integer"
            },
            "limitBytes": {
              "description": "The room the caller's plan gives eBook and comic files.",
              "type": "integer"
            },
            "measuredAt": {
              "description": "When the host last measured the account, when it says.",
              "format": "datetime",
              "type": "string"
            },
            "otherAppsBytes": {
              "description": "Files other apps saved: blobBytes less ebookBytes. Absent with ebookBytes.",
              "type": "integer"
            },
            "overLimit": {
              "description": "The eBook and comic files are past the plan's room. Nothing is deleted or blocked for it.",
              "type": "boolean"
            }
          },
          "required": [
            "checkedAt",
            "limitBytes",
            "blobBytes",
            "overLimit"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {},
        "type": "params"
      },
      "type": "query"
    }
  },
  "description": "What the caller's account holds on Resenha's own server, pds.resenha.ink, as Resenha's server last measured it: every file, measured from the account's blobs; the database, when the host has measured it; and the share taken by the caller's eBook and comic files, which is what Resenha's plan counts. Only the caller's own figures.",
  "id": "ink.resenha.storage.getUsage",
  "lexicon": 1
}
```
