---
updatedAt: 2026-08-10T22:07:58.000Z
agentTools:
  projectIndex: https://docs.blockberry.one/llms.txt
---

# getTimeLocksDay

Get data about time locks by day.
On Mina, some accounts have funds locked on their accounts. With time, they get unlocked either by vesting (gradually with time increments), or cliff mechanism (all at once).

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Mina Devnet API",
    "description": "Mina Devnet (testnet) public REST API by Minascan / Blockberry.",
    "termsOfService": "https://blockberry.one/terms",
    "contact": {
      "name": "Staketab tech support",
      "url": "https://staketab.com/",
      "email": "support@staketab.com"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "https://www.apache.org/licenses/LICENSE-2.0"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.blockberry.one/mina-devnet",
      "description": "Production"
    }
  ],
  "security": [
    {
      "x-api-key": []
    }
  ],
  "paths": {
    "/v1/time-locks/day": {
      "get": {
        "tags": [
          "Time Locks"
        ],
        "summary": "getTimeLocksDay",
        "description": "Get data about time locks by day.\nOn Mina, some accounts have funds locked on their accounts. With time, they get unlocked either by vesting (gradually with time increments), or cliff mechanism (all at once).",
        "operationId": "getTimeLocksDay",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Queried API page.",
            "required": true,
            "schema": {
              "minimum": 0,
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "size",
            "in": "query",
            "description": "Number of queried entries.",
            "required": true,
            "schema": {
              "maximum": 50,
              "minimum": 1,
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "description": "Sorting method: from the lowest element to the highest (ASC) or from the highest element to the lowest (DESC).",
            "required": true,
            "schema": {
              "type": "string",
              "default": "DESC",
              "enum": [
                "ASC",
                "DESC"
              ]
            }
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "Select sorting parameter.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "TIMESTAMP",
              "enum": [
                "TIMESTAMP",
                "UNLOCK",
                "CUMULATIVE_PERCENT_OF_TOTAL_LOCKS",
                "PERCENT_OF_TOTAL_LOCKS",
                "LOCK_AMOUNT",
                "TIMESTAMP",
                "UNLOCK",
                "CUMULATIVE_PERCENT_OF_TOTAL_LOCKS",
                "PERCENT_OF_TOTAL_LOCKS",
                "LOCK_AMOUNT"
              ]
            }
          },
          {
            "name": "isLockedOnly",
            "in": "query",
            "description": "Flag showing if queried accounts have locked funds.",
            "required": true,
            "schema": {
              "type": "boolean",
              "default": false
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RestResponsePageLocksEntity"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PageableObject": {
        "type": "object",
        "properties": {
          "pageNumber": {
            "type": "integer",
            "format": "int32"
          },
          "pageSize": {
            "type": "integer",
            "format": "int32"
          },
          "offset": {
            "type": "integer",
            "format": "int64"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "paged": {
            "type": "boolean"
          },
          "unpaged": {
            "type": "boolean"
          }
        }
      },
      "SortObject": {
        "type": "object",
        "properties": {
          "sorted": {
            "type": "boolean"
          },
          "empty": {
            "type": "boolean"
          },
          "unsorted": {
            "type": "boolean"
          }
        }
      },
      "LocksEntity": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "integer",
            "format": "int64"
          },
          "unlock": {
            "type": "number",
            "format": "double"
          },
          "lockAmount": {
            "type": "number",
            "format": "double"
          },
          "unlockAmount": {
            "type": "number",
            "format": "double"
          },
          "percentOfTotalLocks": {
            "type": "number",
            "format": "double"
          },
          "cumulativePercentOfTotalLocks": {
            "type": "number",
            "format": "double"
          }
        }
      },
      "RestResponsePageLocksEntity": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "writeOnly": true,
            "items": {
              "$ref": "#/components/schemas/LocksEntity"
            }
          },
          "currentPage": {
            "type": "integer",
            "format": "int32",
            "writeOnly": true
          },
          "size": {
            "type": "integer",
            "format": "int32"
          },
          "totalItems": {
            "type": "integer",
            "format": "int64",
            "writeOnly": true
          },
          "totalPages": {
            "type": "integer",
            "format": "int32"
          },
          "content": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LocksEntity"
            }
          },
          "pageable": {
            "$ref": "#/components/schemas/PageableObject"
          },
          "last": {
            "type": "boolean"
          },
          "totalElements": {
            "type": "integer",
            "format": "int64"
          },
          "number": {
            "type": "integer",
            "format": "int32"
          },
          "sort": {
            "$ref": "#/components/schemas/SortObject"
          },
          "first": {
            "type": "boolean"
          },
          "numberOfElements": {
            "type": "integer",
            "format": "int32"
          },
          "empty": {
            "type": "boolean"
          }
        }
      }
    },
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  }
}
```