Applications

Get account information about a given app.

get

Given a specific account public key and application ID, this call returns the account's application local state and global state (AppLocalState and AppParams, if either exists). Global state will only be returned if the provided address is the application's creator.

Authorizations

Path parameters

addressstringRequired

An account public key

Pattern: [A-Z0-9]{58}

application-idintegerRequired

An application identifier

Query parameters

formatstring · enumOptional

Configures whether the response object is JSON or MessagePack encoded. If not provided, defaults to JSON.

Possible values:

Responses

200

AccountApplicationResponse describes the account's application local state and global state (AppLocalState and AppParams, if either exists) for a specific application ID. Global state will only be returned if the provided address is the application's creator.

application/jsonapplication/msgpack

400

Malformed address or application ID

application/jsonapplication/msgpack

401

Invalid API Token

application/jsonapplication/msgpack

500

Internal Error

application/jsonapplication/msgpack

default

Unknown Error

get

HTTPcURLJavaScriptPython

GET /v2/accounts/{address}/applications/{application-id} HTTP/1.1
Host: algo.nownodes.io
X-Algo-API-Token: YOUR_API_KEY
Accept: */*

{
  "app-local-state": {
    "id": 1,
    "key-value": [
      {
        "key": "text",
        "value": {
          "bytes": "text",
          "type": 1,
          "uint": 1
        }
      }
    ],
    "schema": {
      "num-byte-slice": 1,
      "num-uint": 1
    }
  },
  "created-app": {
    "approval-program": "Ynl0ZXM=",
    "clear-state-program": "Ynl0ZXM=",
    "creator": "text",
    "extra-program-pages": 1,
    "global-state": [
      {
        "key": "text",
        "value": {
          "bytes": "text",
          "type": 1,
          "uint": 1
        }
      }
    ],
    "global-state-schema": {
      "num-byte-slice": 1,
      "num-uint": 1
    },
    "local-state-schema": {
      "num-byte-slice": 1,
      "num-uint": 1
    }
  },
  "round": 1
}