Applications

Last updated 1 year ago

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.

400

Malformed address or application ID

401

Invalid API Token

500

Internal Error

default

Unknown Error

get

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
}