Applications

Last updated 10 months ago

Get account information about a given app.

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.

get

/v2/accounts/{address}/applications/{application-id}

Authorizations

Path parameters

addressstringrequired

An account public key

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

application-idintegerrequired

An application identifier

Query parameters

formatenum

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

Options: json, msgpack

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://algo.nownodes.io/v2/accounts/{address}/applications/{application-id}' \
  --header 'X-Algo-API-Token: api_key <apiKey>'

200

400

401

500

default

{
  "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": "text",
    "clear-state-program": "text",
    "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
}

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.