---
updatedAt: 2026-07-31T20:29:59.000Z
agentTools:
  projectIndex: https://docs.blockberry.one/llms.txt
---

# getTimeLocksAll

Get time locks for all period.
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 Mesa API",
    "description": "Mina Mesa (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-mesa",
      "description": "Production"
    }
  ],
  "security": [
    {
      "x-api-key": []
    }
  ],
  "paths": {
    "/v1/time-locks": {
      "post": {
        "tags": [
          "Time Locks"
        ],
        "summary": "getTimeLocksAll",
        "description": "Get time locks for all period.\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": "getTimeLocksAll",
        "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": "searchStr",
            "in": "query",
            "description": "Enter part or full account address to get its timelock data.",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "B62qrh8V1qvJhQx9D6g3JDgVg1FYR8B45V7EFFim7aLPLss3kD2aAXR"
          },
          {
            "name": "sortBy",
            "in": "query",
            "description": "Select sorting parameter.",
            "required": true,
            "schema": {
              "type": "string",
              "default": "INITIAL_MINIMUM_BALANCE",
              "enum": [
                "INITIAL_MINIMUM_BALANCE",
                "UNLOCKED_PERCENT",
                "CLIFF_TIME",
                "CLIFF_AMOUNT",
                "VESTING_TIME",
                "VESTING_AMOUNT",
                "UNLOCKED_AMOUNT",
                "LOCK_DATE",
                "FULLY_UNLOCKED_DATE",
                "INITIAL_MINIMUM_BALANCE",
                "UNLOCKED_PERCENT",
                "CLIFF_TIME",
                "CLIFF_AMOUNT",
                "VESTING_TIME",
                "VESTING_AMOUNT",
                "UNLOCKED_AMOUNT",
                "LOCK_DATE",
                "FULLY_UNLOCKED_DATE"
              ]
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LockParams"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RestResponsePageTimeLocksEntity"
                }
              }
            }
          }
        }
      }
    }
  },
  "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"
          }
        }
      },
      "LockParams": {
        "required": [
          "lockTypes"
        ],
        "type": "object",
        "properties": {
          "lockTypes": {
            "type": "array",
            "description": "Type of funds on the account balance: locked or unlocked.",
            "items": {
              "type": "string",
              "description": "Type of funds on the account balance: locked or unlocked.",
              "enum": [
                "LOCKED",
                "UNLOCKED"
              ]
            },
            "enum": [
              "LOCKED",
              "UNLOCKED"
            ]
          }
        }
      },
      "RestResponsePageTimeLocksEntity": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "writeOnly": true,
            "items": {
              "$ref": "#/components/schemas/TimeLocksEntity"
            }
          },
          "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/TimeLocksEntity"
            }
          },
          "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"
          }
        }
      },
      "TimeLocksEntity": {
        "type": "object",
        "properties": {
          "pk": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "img": {
            "type": "string"
          },
          "lockDate": {
            "type": "integer",
            "format": "int64"
          },
          "initialMinimumBalance": {
            "type": "number",
            "format": "double"
          },
          "totalSupply": {
            "type": "number",
            "format": "double"
          },
          "cliffTime": {
            "type": "integer",
            "format": "int64"
          },
          "cliffTimeMillis": {
            "type": "integer",
            "format": "int64"
          },
          "cliffAmount": {
            "type": "number",
            "format": "double"
          },
          "vestingIncrement": {
            "type": "number",
            "format": "double"
          },
          "unlockedAmount": {
            "type": "number",
            "format": "double"
          },
          "vestingAmount": {
            "type": "number",
            "format": "double"
          },
          "fullyUnlockedDate": {
            "type": "integer",
            "format": "int64"
          },
          "vestingTime": {
            "type": "integer",
            "format": "int64"
          },
          "vestingTimeMillis": {
            "type": "integer",
            "format": "int64"
          },
          "unlockedPercent": {
            "type": "number",
            "format": "double"
          },
          "isZkAppAccount": {
            "type": "boolean"
          }
        }
      }
    },
    "securitySchemes": {
      "x-api-key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  }
}
```